diff options
Diffstat (limited to 'projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java')
| -rw-r--r-- | projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java | 463 |
1 files changed, 193 insertions, 270 deletions
diff --git a/projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java b/projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java index cc3af69..ae3fa50 100644 --- a/projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java +++ b/projects/net.wotonomy.ui.swing/src/main/java/net/wotonomy/ui/swing/ActionAssociation.java @@ -31,305 +31,228 @@ import net.wotonomy.ui.EOAssociation; import net.wotonomy.ui.EODisplayGroup; /** -* ActionAssociation binds any ActionEvent broadcaster -* (typically Buttons and the like) to a display group. -* Actions are invoked on all selected objects in the -* display group bound to the action aspect. -* Bindings are: -* <ul> -* <li>action: a method to be invoked on selected objects. -* If the argument aspect is bound, the method must take -* one argument. Otherwise, the method must take no arguments.</li> -* <li>argument: the attribute of the selected object(s) (possibly -* from a different display group) that will be used as an argument -* to the action method</li> -* <li>enabled: a boolean property that determines whether -* the controlled component is enabled</li> -* <li>visible: a boolean property that determines whether -* the controlled component is visible</li> -* </ul> -* -* @author michael@mpowers.net -* @author $Author: cgruber $ -* @version $Revision: 904 $ -*/ -public class ActionAssociation extends EOAssociation - implements ActionListener -{ - static final NSArray aspects = - new NSArray( new Object[] { - ActionAspect, ArgumentAspect, EnabledAspect, VisibleAspect - } ); - static final NSArray aspectSignatures = - new NSArray( new Object[] { - AttributeToOneAspectSignature, - AttributeToOneAspectSignature, - AttributeToOneAspectSignature, - AttributeToOneAspectSignature - } ); - static final NSArray objectKeysTaken = - new NSArray( new Object[] { - "target" - } ); - - static NSSelector addActionListener = - new NSSelector( "addActionListener", - new Class[] { ActionListener.class } ); - static NSSelector removeActionListener = - new NSSelector( "removeActionListener", - new Class[] { ActionListener.class } ); + * ActionAssociation binds any ActionEvent broadcaster (typically Buttons and + * the like) to a display group. Actions are invoked on all selected objects in + * the display group bound to the action aspect. Bindings are: + * <ul> + * <li>action: a method to be invoked on selected objects. If the argument + * aspect is bound, the method must take one argument. Otherwise, the method + * must take no arguments.</li> + * <li>argument: the attribute of the selected object(s) (possibly from a + * different display group) that will be used as an argument to the action + * method</li> + * <li>enabled: a boolean property that determines whether the controlled + * component is enabled</li> + * <li>visible: a boolean property that determines whether the controlled + * component is visible</li> + * </ul> + * + * @author michael@mpowers.net + * @author $Author: cgruber $ + * @version $Revision: 904 $ + */ +public class ActionAssociation extends EOAssociation implements ActionListener { + static final NSArray aspects = new NSArray( + new Object[] { ActionAspect, ArgumentAspect, EnabledAspect, VisibleAspect }); + static final NSArray aspectSignatures = new NSArray(new Object[] { AttributeToOneAspectSignature, + AttributeToOneAspectSignature, AttributeToOneAspectSignature, AttributeToOneAspectSignature }); + static final NSArray objectKeysTaken = new NSArray(new Object[] { "target" }); - /** - * Constructor specifying the object to be controlled by this - * association. Does not establish connection. - */ - public ActionAssociation ( Object anObject ) - { - super( anObject ); - } - - /** - * Returns a List of aspect signatures whose contents - * correspond with the aspects list. Each element is - * a string whose characters represent a capability of - * the corresponding aspect. <ul> - * <li>"A" attribute: the aspect can be bound to - * an attribute.</li> - * <li>"1" to-one: the aspect can be bound to a - * property that returns a single object.</li> - * <li>"M" to-one: the aspect can be bound to a - * property that returns multiple objects.</li> - * </ul> - * An empty signature "" means that the aspect can - * bind without needing a key. - * This implementation returns "A1M" for each - * element in the aspects array. - */ - public static NSArray aspectSignatures () - { - return aspectSignatures; - } - - /** - * Returns a List that describes the aspects supported - * by this class. Each element in the list is the string - * name of the aspect. This implementation returns an - * empty list. - */ - public static NSArray aspects () - { - return aspects; - } - - /** - * Returns a List of EOAssociation subclasses that, - * for the objects that are usable for this association, - * are less suitable than this association. - */ - public static NSArray associationClassesSuperseded () - { - return new NSArray(); - } - - /** - * Returns whether this class can control the specified - * object. - */ - public static boolean isUsableWithObject ( Object anObject ) - { - return - ( addActionListener.implementedByObject( anObject ) ) - && ( removeActionListener.implementedByObject( anObject ) ); - } - - /** - * Returns a List of properties of the controlled object - * that are controlled by this class. For example, - * "stringValue", or "selected". - */ - public static NSArray objectKeysTaken () - { - return objectKeysTaken; - } - - /** - * Returns the aspect that is considered primary - * or default. - */ - public static String primaryAspect () - { - return ActionAspect; - } - - /** - * Returns whether this association can bind to the - * specified display group on the specified key for - * the specified aspect. - */ - public boolean canBindAspect ( - String anAspect, EODisplayGroup aDisplayGroup, String aKey) - { - return ( aspects.containsObject( anAspect ) ); - } - - /** - * Establishes a connection between this association - * and the controlled object. Subclasses should begin - * listening for events from their controlled object here. - */ - public void establishConnection () - { - try - { - addActionListener.invoke( object(), this ); - } - catch ( Exception exc ) - { - throw new WotonomyException( "EOActionAssociation: " + - "could not add action listener to object:" + object() ); - } - super.establishConnection(); - } - - /** - * Breaks the connection between this association and - * its object. Override to stop listening for events - * from the object. - */ - public void breakConnection () - { - try - { - removeActionListener.invoke( object(), this ); + static NSSelector addActionListener = new NSSelector("addActionListener", new Class[] { ActionListener.class }); + static NSSelector removeActionListener = new NSSelector("removeActionListener", + new Class[] { ActionListener.class }); + + /** + * Constructor specifying the object to be controlled by this association. Does + * not establish connection. + */ + public ActionAssociation(Object anObject) { + super(anObject); + } + + /** + * Returns a List of aspect signatures whose contents correspond with the + * aspects list. Each element is a string whose characters represent a + * capability of the corresponding aspect. + * <ul> + * <li>"A" attribute: the aspect can be bound to an attribute.</li> + * <li>"1" to-one: the aspect can be bound to a property that returns a single + * object.</li> + * <li>"M" to-one: the aspect can be bound to a property that returns multiple + * objects.</li> + * </ul> + * An empty signature "" means that the aspect can bind without needing a key. + * This implementation returns "A1M" for each element in the aspects array. + */ + public static NSArray aspectSignatures() { + return aspectSignatures; + } + + /** + * Returns a List that describes the aspects supported by this class. Each + * element in the list is the string name of the aspect. This implementation + * returns an empty list. + */ + public static NSArray aspects() { + return aspects; + } + + /** + * Returns a List of EOAssociation subclasses that, for the objects that are + * usable for this association, are less suitable than this association. + */ + public static NSArray associationClassesSuperseded() { + return new NSArray(); + } + + /** + * Returns whether this class can control the specified object. + */ + public static boolean isUsableWithObject(Object anObject) { + return (addActionListener.implementedByObject(anObject)) + && (removeActionListener.implementedByObject(anObject)); + } + + /** + * Returns a List of properties of the controlled object that are controlled by + * this class. For example, "stringValue", or "selected". + */ + public static NSArray objectKeysTaken() { + return objectKeysTaken; + } + + /** + * Returns the aspect that is considered primary or default. + */ + public static String primaryAspect() { + return ActionAspect; + } + + /** + * Returns whether this association can bind to the specified display group on + * the specified key for the specified aspect. + */ + public boolean canBindAspect(String anAspect, EODisplayGroup aDisplayGroup, String aKey) { + return (aspects.containsObject(anAspect)); + } + + /** + * Establishes a connection between this association and the controlled object. + * Subclasses should begin listening for events from their controlled object + * here. + */ + public void establishConnection() { + try { + addActionListener.invoke(object(), this); + } catch (Exception exc) { + throw new WotonomyException( + "EOActionAssociation: " + "could not add action listener to object:" + object()); } - catch ( Exception exc ) - { - throw new WotonomyException( "EOActionAssociation: " + - "could not add action listener to object:" + object() ); + super.establishConnection(); + } + + /** + * Breaks the connection between this association and its object. Override to + * stop listening for events from the object. + */ + public void breakConnection() { + try { + removeActionListener.invoke(object(), this); + } catch (Exception exc) { + throw new WotonomyException( + "EOActionAssociation: " + "could not add action listener to object:" + object()); } - super.breakConnection(); - } - - /** - * Called when either the selection or the contents - * of an associated display group have changed. - * This implementation does nothing. - */ - public void subjectChanged () - { + super.breakConnection(); + } + + /** + * Called when either the selection or the contents of an associated display + * group have changed. This implementation does nothing. + */ + public void subjectChanged() { Object component = object(); EODisplayGroup displayGroup; String key; - - if ( component instanceof Component ) - { + + if (component instanceof Component) { // enabled aspect - displayGroup = displayGroupForAspect( EnabledAspect ); - if ( displayGroup != null ) - { - key = displayGroupKeyForAspect( EnabledAspect ); - ((Component)component).setEnabled( - displayGroup.enabledToSetSelectedObjectValueForKey( key ) ); - Object value = - displayGroup.selectedObjectValueForKey( key ); - Boolean converted = null; - if ( value != null ) - { - converted = (Boolean) - ValueConverter.convertObjectToClass( - value, Boolean.class ); - } - if ( converted == null ) converted = Boolean.FALSE; - if ( converted.booleanValue() != - ((Component)component).isEnabled() ) - { - ((Component)component).setEnabled( - converted.booleanValue() ); - } + displayGroup = displayGroupForAspect(EnabledAspect); + if (displayGroup != null) { + key = displayGroupKeyForAspect(EnabledAspect); + ((Component) component).setEnabled(displayGroup.enabledToSetSelectedObjectValueForKey(key)); + Object value = displayGroup.selectedObjectValueForKey(key); + Boolean converted = null; + if (value != null) { + converted = (Boolean) ValueConverter.convertObjectToClass(value, Boolean.class); + } + if (converted == null) + converted = Boolean.FALSE; + if (converted.booleanValue() != ((Component) component).isEnabled()) { + ((Component) component).setEnabled(converted.booleanValue()); + } } - + // visible aspect - displayGroup = displayGroupForAspect( VisibleAspect ); - if ( displayGroup != null ) - { - key = displayGroupKeyForAspect( VisibleAspect ); - Object value = - displayGroup.selectedObjectValueForKey( key ); - Boolean converted = (Boolean) - ValueConverter.convertObjectToClass( - value, Boolean.class ); - if ( converted != null ) - { - if ( converted.booleanValue() != - ((Component)component).isVisible() ) - { - ((Component)component).setVisible( - converted.booleanValue() ); + displayGroup = displayGroupForAspect(VisibleAspect); + if (displayGroup != null) { + key = displayGroupKeyForAspect(VisibleAspect); + Object value = displayGroup.selectedObjectValueForKey(key); + Boolean converted = (Boolean) ValueConverter.convertObjectToClass(value, Boolean.class); + if (converted != null) { + if (converted.booleanValue() != ((Component) component).isVisible()) { + ((Component) component).setVisible(converted.booleanValue()); } - } + } } } - } - - // interface ActionListener - - public void actionPerformed( ActionEvent evt ) - { + } + + // interface ActionListener + + public void actionPerformed(ActionEvent evt) { EODisplayGroup actionDisplayGroup = null; String actionKey = null; - + // action aspect - actionDisplayGroup = displayGroupForAspect( ActionAspect ); - if ( actionDisplayGroup != null ) - { - actionKey = displayGroupKeyForAspect( ActionAspect ); + actionDisplayGroup = displayGroupForAspect(ActionAspect); + if (actionDisplayGroup != null) { + actionKey = displayGroupKeyForAspect(ActionAspect); - //TODO: argument aspect not implemented + // TODO: argument aspect not implemented - try - { - - NSSelector selector = new NSSelector( actionKey ); - Enumeration e = - actionDisplayGroup.selectedObjects().objectEnumerator(); - while ( e.hasMoreElements() ) - { - selector.invoke( e.nextElement() ); + try { + + NSSelector selector = new NSSelector(actionKey); + Enumeration e = actionDisplayGroup.selectedObjects().objectEnumerator(); + while (e.hasMoreElements()) { + selector.invoke(e.nextElement()); } - } - catch ( Exception exc ) - { - throw new WotonomyException( - "ActionAssociation: error invoking action: " + actionKey, exc ); + } catch (Exception exc) { + throw new WotonomyException("ActionAssociation: error invoking action: " + actionKey, exc); } } - } + } } /* - * $Log$ - * Revision 1.2 2006/02/18 23:19:05 cgruber - * Update imports and maven dependencies. + * $Log$ Revision 1.2 2006/02/18 23:19:05 cgruber Update imports and maven + * dependencies. * - * Revision 1.1 2006/02/16 13:22:22 cgruber - * Check in all sources in eclipse-friendly maven-enabled packages. + * Revision 1.1 2006/02/16 13:22:22 cgruber Check in all sources in + * eclipse-friendly maven-enabled packages. * - * Revision 1.4 2004/01/28 18:34:57 mpowers - * Better handling for enabling. - * Now respecting enabledToSetSelectedObjectValueForKey from display group. + * Revision 1.4 2004/01/28 18:34:57 mpowers Better handling for enabling. Now + * respecting enabledToSetSelectedObjectValueForKey from display group. * - * Revision 1.3 2003/08/06 23:07:52 chochos - * general code cleanup (mostly, removing unused imports) + * Revision 1.3 2003/08/06 23:07:52 chochos general code cleanup (mostly, + * removing unused imports) * - * Revision 1.2 2001/02/17 16:52:05 mpowers - * Changes in imports to support building with jdk1.1 collections. + * Revision 1.2 2001/02/17 16:52:05 mpowers Changes in imports to support + * building with jdk1.1 collections. * - * Revision 1.1.1.1 2000/12/21 15:48:28 mpowers - * Contributing wotonomy. + * Revision 1.1.1.1 2000/12/21 15:48:28 mpowers Contributing wotonomy. * - * Revision 1.5 2000/12/20 16:25:40 michael - * Added log to all files. + * Revision 1.5 2000/12/20 16:25:40 michael Added log to all files. * * */ - |