svn commit: r202407 - /incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml

[st...@apache.org]

Author: steveh
Date: Wed Jun 29 10:52:40 2005
New Revision: 202407

URL: http://svn.apache.org/viewcvs?rev=202407&view=rev
Log:
A fix for CR230514 |  more details on controls membership constraint

Modified:
    incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml

Modified: incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml?rev=202407&r1=202406&r2=202407&view=diff
==============================================================================
--- incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml (original)
+++ incubator/beehive/trunk/docs/forrest/src/documentation/content/xdocs/controls/controlsProgramming.xml Wed Jun 29 10:52:40 2005
@@ -684,6 +684,24 @@
 	<source>    @Control
     @BookControl.Intro(title="some title", subject="some subject")
     BookControlBean myBook</source>
+<p>When constraining properties with <code>@AnnotationConstraints</code>, all of the property 
+	members must be annotated
+	with <code>@AnnotationMemberTypes</code>, or compile errors will be thrown.  For example, the following 
+	will <em>not</em> compile, because not all of the property members (namely <code>someMember3()</code>) 
+	are decorated with 
+		<code>@AnnotationMemberTypes</code>.</p>
+<source>
+    @AnnotationConstraints.MembershipRule(AnnotationConstraints.MembershipRuleValues.EXACTLY_ONE)
+    public @interface SomeProperty
+    {
+        @AnnotationMemberTypes.Text(maxLength=8)
+        public String someMember();
+        @AnnotationMemberTypes.Text(maxLength=8)
+        public String someMember2();
+        <strong>public String someMember3();</strong>
+	}</source>
+<p>Not all Java types are supported by <code>@AnnotationMemberTypes</code>.  For a list of the supported types
+	see <a href="../apidocs/classref_controls/org/apache/beehive/controls/api/bean/AnnotationMemberTypes.html">Interface AnnotationMemberTypes</a>.</p>
         </section>
         </section>
         <section id="extensibility">