You are viewing a plain text version of this content. The canonical link for it is here.
Posted to adffaces-commits@incubator.apache.org by aw...@apache.org on 2006/12/21 23:43:35 UTC
svn commit: r489507 - in /incubator/adffaces/trunk/trinidad:
trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/
trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/
trinidad-build/src/main/resources/META-INF...
Author: awiner
Date: Thu Dec 21 15:43:35 2006
New Revision: 489507
URL: http://svn.apache.org/viewvc?view=rev&rev=489507
Log:
Improve documentation for attribute change events (formerly just about non-existent) to clarify that they aren't delivered for just any property getting set
Modified:
incubator/adffaces/trunk/trinidad/trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/UIXComponent.java
incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/ComponentBase.xml
incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/events/trinidad/AttributeChange.xml
Modified: incubator/adffaces/trunk/trinidad/trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/UIXComponent.java
URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/UIXComponent.java?view=diff&rev=489507&r1=489506&r2=489507
==============================================================================
--- incubator/adffaces/trunk/trinidad/trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/UIXComponent.java (original)
+++ incubator/adffaces/trunk/trinidad/trinidad-api/src/main/java/org/apache/myfaces/trinidad/component/UIXComponent.java Thu Dec 21 15:43:35 2006
@@ -33,12 +33,52 @@
*/
abstract public class UIXComponent extends UIComponent
{
+ /**
+ * Returns the FacesBean used for storing the component's state.
+ */
abstract public FacesBean getFacesBean();
+
+ /**
+ * Adds an AttributeChangeListener. Attribute change events are not
+ * delivered for any programmatic change to a property. They are only
+ * delivered when a renderer changes a property without the application's
+ * specific request. An example of an attribute change events might
+ * include the width of a column that supported client-side resizing.
+ */
abstract public void addAttributeChangeListener(AttributeChangeListener acl);
+
+ /**
+ * Removes an AttributeChangeListener. Attribute change events are not
+ * delivered for any programmatic change to a property. They are only
+ * delivered when a renderer changes a property without the application's
+ * specific request. An example of an attribute change events might
+ * include the width of a column that supported client-side resizing.
+ */
abstract public void removeAttributeChangeListener(AttributeChangeListener acl);
+
+ /**
+ * Gets the registered AttributeChangeListeners.
+ */
abstract public AttributeChangeListener[] getAttributeChangeListeners();
+ /**
+ * Sets a method binding to an AttributeChangeListener. Attribute
+ * change events are not
+ * delivered for any programmatic change to a property. They are only
+ * delivered when a renderer changes a property without the application's
+ * specific request. An example of an attribute change events might
+ * include the width of a column that supported client-side resizing.
+ */
abstract public void setAttributeChangeListener(MethodBinding mb);
+
+ /**
+ * Gets the method binding to an AttributeChangeListener. Attribute
+ * change events are not
+ * delivered for any programmatic change to a property. They are only
+ * delivered when a renderer changes a property without the application's
+ * specific request. An example of an attribute change events might
+ * include the width of a column that supported client-side resizing.
+ */
abstract public MethodBinding getAttributeChangeListener();
abstract public void markInitialState();
Modified: incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/ComponentBase.xml
URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/ComponentBase.xml?view=diff&rev=489507&r1=489506&r2=489507
==============================================================================
--- incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/ComponentBase.xml (original)
+++ incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/components/trinidad/ComponentBase.xml Thu Dec 21 15:43:35 2006
@@ -27,7 +27,7 @@
AttributeChangeEvent is broadcast by this component. The
method signature takes a single AttributeChangeEvent
parameter and returns void.</description -->
- <description>a method reference to an attribute change listener</description>
+ <description>a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.</description>
<property-name>attributeChangeListener</property-name>
<property-class>javax.faces.el.MethodBinding</property-class>
<property-extension>
Modified: incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/events/trinidad/AttributeChange.xml
URL: http://svn.apache.org/viewvc/incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/events/trinidad/AttributeChange.xml?view=diff&rev=489507&r1=489506&r2=489507
==============================================================================
--- incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/events/trinidad/AttributeChange.xml (original)
+++ incubator/adffaces/trunk/trinidad/trinidad-build/src/main/resources/META-INF/maven-faces-plugin/events/trinidad/AttributeChange.xml Thu Dec 21 15:43:35 2006
@@ -20,7 +20,7 @@
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<faces-config-extension>
<mfp:event>
- <mfp:description>Event delivered to describe an attribute change.</mfp:description>
+ <mfp:description>Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.</mfp:description>
<mfp:event-type>org.apache.myfaces.trinidad.AttributeChange</mfp:event-type>
<mfp:event-class>org.apache.myfaces.trinidad.event.AttributeChangeEvent</mfp:event-class>
<mfp:event-listener-class>org.apache.myfaces.trinidad.event.AttributeChangeListener</mfp:event-listener-class>