[jboss-cvs] JBossAS SVN: r68339 - projects/microcontainer/trunk/docs/User_Guide/src/main/docbook.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Mon Dec 17 07:08:32 EST 2007
Author: newtonm
Date: 2007-12-17 07:08:32 -0500 (Mon, 17 Dec 2007)
New Revision: 68339
Modified:
projects/microcontainer/trunk/docs/User_Guide/src/main/docbook/User_Guide.xml
Log:
Corrected layout of annotation attributes for collections.
Modified: projects/microcontainer/trunk/docs/User_Guide/src/main/docbook/User_Guide.xml
===================================================================
--- projects/microcontainer/trunk/docs/User_Guide/src/main/docbook/User_Guide.xml 2007-12-17 11:46:02 UTC (rev 68338)
+++ projects/microcontainer/trunk/docs/User_Guide/src/main/docbook/User_Guide.xml 2007-12-17 12:08:32 UTC (rev 68339)
@@ -1679,7 +1679,6 @@
</bean> </programlisting>
<para>As you have probably noticed we are required to enter all of our values as strings since we are dealing with text files. These strings are converted into objects of the correct type using JavaBean <ulink url="http://java.sun.com/j2se/1.5.0/docs/api/java/beans/PropertyEditor.html">PropertyEditors</ulink>. If the property takes an interface or abstract class then you can pass a specific implementation using a <code>type</code> or <code>class</code> attribute depending on whether you're using annotations or XML.</para>
<programlisting>public class PropertiesBean {
-
public void setNumber(@StringValue(value="4", type="java.lang.Long") Number number) {
...
}
@@ -1734,16 +1733,15 @@
</property>
</bean> </programlisting>
<para>This is primarily used when configuring values representing collections such as lists, sets and arrays. Elements of a collection are defined by listing annotations or nesting <value> elements as follows:</para>
- <programlisting>@CollectionValue({@Value(string=@StringValue("string1")),
+ <programlisting>@CollectionValue(elementClass="java.lang.String",
+ {@Value(string=@StringValue("string1")),
@Value(string=@StringValue("string2")),
@Value(string=@StringValue("string3")),
- @Value(string=@StringValue("string4"))},
- elementClass="java.lang.String")
+ @Value(string=@StringValue("string4"))})
public void setCollection(Collection collection) {
...
} </programlisting>
- <programlisting><bean name="SimpleBean"
- class="org.jboss.example.SimpleBean">
+ <programlisting><bean name="SimpleBean" class="org.jboss.example.SimpleBean">
<property name="collection">
<collection elementClass="java.lang.String">
<value>string1</value>
@@ -1754,16 +1752,15 @@
</property>
</bean> </programlisting>
<para>The <code>elementClass</code> attribute specifies the default class for the values. This can be overriden for individual values using the <code>type</code> or <code>class</code> attributes.</para>
- <programlisting>@CollectionValue({@Value(string=@StringValue("string1")),
+ <programlisting>@CollectionValue(elementClass="java.lang.String",
+ {@Value(string=@StringValue("string1")),
@Value(string=@StringValue("string2")),
@Value(string=@StringValue(value="3.0", type="java.lang.Float")),
- @Value(string=@StringValue(value="4", type="java.lang.Integer"))},
- elementClass="java.lang.String")
+ @Value(string=@StringValue(value="4", type="java.lang.Integer"))})
public void setCollection(Collection collection) {
...
} </programlisting>
- <programlisting><bean name="SimpleBean"
- class="org.jboss.example.SimpleBean">
+ <programlisting><bean name="SimpleBean" class="org.jboss.example.SimpleBean">
<property name="collection">
<collection elementClass="java.lang.String">
<value>string1</value>
@@ -1777,28 +1774,27 @@
<para>The type of each value must be specified using either the <code>elementClass</code> or <code>type/class</code> attribute in order for the collection to be created.</para>
</warning>
<para>Lists, sets and arrays take the same form as the collection annotation and XML element. </para>
- <programlisting>@ListValue({@Value(string=@StringValue("my first string")),
- @Value(string=@StringValue("my second string"))},
- elementClass="java.lang.String")
+ <programlisting>@ListValue(elementClass="java.lang.String",
+ {@Value(string=@StringValue("my first string")),
+ @Value(string=@StringValue("my second string"))})
public void setList(List list) {
...
}
- at SetValue({@Value(string=@StringValue("50")),
- @Value(string=@StringValue("55"))},
- elementClass="java.lang.Integer")
+ at SetValue(elementClass="java.lang.Integer",
+ {@Value(string=@StringValue("50")),
+ @Value(string=@StringValue("55"))})
public void setSet(Set set) {
...
}
- at ArrayValue({@Value(string=@StringValue("1.0")),
- @Value(string=@StringValue("2.0"))},
- elementClass="java.lang.Float")
+ at ArrayValue(elementClass="java.lang.Float",
+ {@Value(string=@StringValue("1.0")),
+ @Value(string=@StringValue("2.0"))})
public void setArray(Object[] array) {
...
} </programlisting>
- <programlisting><bean name="SimpleBean"
- class="org.jboss.example.SimpleBean">
+ <programlisting><bean name="SimpleBean" class="org.jboss.example.SimpleBean">
<property name="list">
<list elementClass="java.lang.String">
<value>my first string</value>
@@ -1821,16 +1817,16 @@
</array>
</bean> </programlisting>
<para>They can even be nested within one another if required. </para>
- <programlisting>@ListValue({@Value(string=@StringValue("my first string")),
- @Value(string=@SetValue({@Value(string=@StringValue("1")),
- @Value(string=@StringValue="2"))},
- elementClass="java.lang.Integer"))},
- elementClass="java.lang.String")
+ <programlisting>@ListValue(elementClass="java.lang.String",
+ {@Value(string=@StringValue("my first string")),
+ @Value(string=@SetValue(elementClass="java.lang.Integer",
+ {@Value(string=@StringValue("1")),
+ @Value(string=@StringValue="2"))})
+ )})
public void setList(List list) {
...
}</programlisting>
- <programlisting><bean name="SimpleBean"
- class="org.jboss.example.SimpleBean">
+ <programlisting><bean name="SimpleBean" class="org.jboss.example.SimpleBean">
<property name="list">
<list elementClass="java.lang.String">
<value>my first string</value>
@@ -1887,10 +1883,10 @@
</listitem>
</itemizedlist>
<para>If you want to override this behaviour and specify your own class then you can simply add a <code>clazz</code> attribute to your annotation or <code>class</code> attribute to your XML element containing the fully-qualified class name. This causes the microcontainer to create a new instance using the specified class.</para>
- <programlisting>@SetValue({@Value(string=@StringValue("50")),
- @Value(string=@StringValue("55"))},
- clazz="java.util.TreeSet",
- elementClass="java.lang.Integer")
+ <programlisting>@SetValue(clazz="java.util.TreeSet",
+ elementClass="java.lang.Integer",
+ {@Value(string=@StringValue("50")),
+ @Value(string=@StringValue("55"))})
public void setSet(Set set) {
...
}</programlisting>
More information about the jboss-cvs-commits
mailing list