Initial commit from SVN.

Foundation/src/com/foundation/view/IMethodAssociation.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2003,2007 Declarative Engineering LLC.
+ * All rights reserved.  This program and the accompanying materials
+ * are made available under the terms of the Declarative Engineering LLC
+ * verson 1 which accompanies this distribution, and is available at
+ * http://declarativeengineering.com/legal/DE_Developer_License_v1.txt
+ */
+package com.foundation.view;
+
+public interface IMethodAssociation extends IValueHolderAssociation, IValueHolderListener {
+/**
+ * Invokes the method on the held value.
+ * @param parameters The parameters for the method.  This may be null if there are no parameters.
+ * @param synchronous Whether the invokation should be synchronous (on this same thread).
+ * @return The return value for the method.
+ */
+public Object invoke(Object[] parameters, boolean synchronous);
+/**
+ * Invokes the method on the specified value.  This method must be called for method associations that are not connected to a value holder.
+ * @param value The value to invoke the method on.
+ * @param parameters The parameters for the method.  This may be null if there are no parameters.
+ * @param synchronous Whether the invokation should be synchronous (on this same thread).
+ * @return The return value for the method.
+ */
+public Object invoke(Object value, Object[] parameters, boolean synchronous);
+/**
+ * Gets whether the association is connected via a value holder.
+ * @return Whether there is a value holder connection for this association.
+ */
+public boolean getIsValueHolderAssociated();
+/**
+ * Registers the method association to begin receiving updates from the associated value holder.
+ * <p>Note: This is only used if this method is associated with a value holder, and is a 'getter' type method.</p>
+ */
+public void register();
+/**
+ * Unregisters the method association to stop receiving updates from the associated value holder.
+ * <p>Note: This is only used if this method is associated with a value holder, and is a 'getter' type method.</p>
+ */
+public void unregister();
+/**
+ * Sets the change listener that will be called, if the method is registered and is value holder bound, when the value holder's held value changes.
+ * @param listener The listener to be notified when the associated value holder's held value changes.
+ */
+public void setChangeListener(IMethodAssociationChangeListener listener);
+}//IMethodAssociation//