Formatting pass

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.
  *
  *
  */
-