/*
Wotonomy: OpenStep design patterns for pure Java applications.
Copyright (C) 2000 Intersect Software Corporation

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, see http://www.gnu.org
*/

package net.wotonomy.ui.swing;

import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import net.wotonomy.foundation.NSArray;
import net.wotonomy.foundation.NSSelector;
import net.wotonomy.foundation.internal.WotonomyException;
import net.wotonomy.ui.EODisplayGroup;

/**
 * ActionAssociation binds any ActionEvent broadcaster (typically Buttons and
 * the like) to a display group, but invokes actions directly on the bound
 * display group rather than the selected objects. Bindings are:
 * <ul>
 * <li>action: a method to be invoked on the bound display group. 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 DisplayGroupActionAssociation extends ActionAssociation {
	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 });

	/**
	 * Constructor specifying the object to be controlled by this association. Does
	 * not establish connection.
	 */
	public DisplayGroupActionAssociation(Object anObject) {
		super(anObject);
	}

	// interface ActionListener

	public void actionPerformed(ActionEvent evt) {
		EODisplayGroup actionDisplayGroup = null;
		String actionKey = null;

		// action aspect
		actionDisplayGroup = displayGroupForAspect(ActionAspect);
		if (actionDisplayGroup != null) {
			actionKey = displayGroupKeyForAspect(ActionAspect);

			// TODO: argument aspect not implemented

			try {
				NSSelector.invoke(actionKey, actionDisplayGroup);
			} catch (Exception exc) {
				throw new WotonomyException("DisplayGroupActionAssociation: " + "error invoking action: " + actionKey,
						exc);
			}
		}
	}

}

/*
 * $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.2 2003/08/06 23:07:52 chochos general code cleanup (mostly,
 * removing unused imports)
 *
 * Revision 1.1.1.1 2000/12/21 15:48:46 mpowers Contributing wotonomy.
 *
 * Revision 1.3 2000/12/20 16:25:40 michael Added log to all files.
 *
 *
 */