[jboss-cvs] JBossAS SVN: r90085 - projects/microcontainer/mcdocs/trunk/userguide/src/main/docbook.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Thu Jun 11 07:49:04 EDT 2009
Author: kabir.khan at jboss.com
Date: 2009-06-11 07:49:04 -0400 (Thu, 11 Jun 2009)
New Revision: 90085
Modified:
projects/microcontainer/mcdocs/trunk/userguide/src/main/docbook/User_Guide.xml
Log:
@StringValue.type is a Class, not a String
Modified: projects/microcontainer/mcdocs/trunk/userguide/src/main/docbook/User_Guide.xml
===================================================================
--- projects/microcontainer/mcdocs/trunk/userguide/src/main/docbook/User_Guide.xml 2009-06-11 11:45:25 UTC (rev 90084)
+++ projects/microcontainer/mcdocs/trunk/userguide/src/main/docbook/User_Guide.xml 2009-06-11 11:49:04 UTC (rev 90085)
@@ -1511,7 +1511,7 @@
}
@Constructor
-public TestConstructorBean(@StringValue("this is a test constructor") String testString, @StringValue(value="25", type="long") long testNumber) {
+public TestConstructorBean(@StringValue("this is a test constructor") String testString, @StringValue(value="25", type=Long.TYPE) long testNumber) {
...
}</programlisting>
<programlisting role="XML"><bean name="Test" class="org.jboss.example.constructor.TestConstructorBean">
@@ -1744,7 +1744,7 @@
</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 role="JAVA">public class PropertiesBean {
- public void setNumber(@StringValue(value="4", type="java.lang.Long") Number number) {
+ public void setNumber(@StringValue(value="4", type=java.lang.Long.class) Number number) {
...
}
}</programlisting>
@@ -1802,7 +1802,7 @@
</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 role="JAVA">@CollectionValue(elementClass="java.lang.String",
+ <programlisting role="JAVA">@CollectionValue(elementClass=java.lang.String.class,
{@Value(string=@StringValue("string1")),
@Value(string=@StringValue("string2")),
@Value(string=@StringValue("string3")),
@@ -1821,7 +1821,7 @@
</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 role="JAVA">@CollectionValue(elementClass="java.lang.String",
+ <programlisting role="JAVA">@CollectionValue(elementClass=java.lang.String.class,
{@Value(string=@StringValue("string1")),
@Value(string=@StringValue("string2")),
@Value(string=@StringValue(value="3.0", type="java.lang.Float")),
@@ -1843,21 +1843,21 @@
<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 role="JAVA">@ListValue(elementClass="java.lang.String",
+ <programlisting role="JAVA">@ListValue(elementClass=java.lang.String.class,
{@Value(string=@StringValue("my first string")),
@Value(string=@StringValue("my second string"))})
public void setList(List list) {
...
}
- at SetValue(elementClass="java.lang.Integer",
+ at SetValue(elementClass=java.lang.Integer.class,
{@Value(string=@StringValue("50")),
@Value(string=@StringValue("55"))})
public void setSet(Set set) {
...
}
- at ArrayValue(elementClass="java.lang.Float",
+ at ArrayValue(elementClass=java.lang.Float.class,
{@Value(string=@StringValue("1.0")),
@Value(string=@StringValue("2.0"))})
public void setArray(Object[] array) {
@@ -1886,9 +1886,9 @@
</array>
</bean> </programlisting>
<para>They can even be nested within one another if required. </para>
- <programlisting role="JAVA">@ListValue(elementClass="java.lang.String",
+ <programlisting role="JAVA">@ListValue(elementClass=java.lang.String.class,
{@Value(string=@StringValue("my first string")),
- @Value(string=@SetValue(elementClass="java.lang.Integer",
+ @Value(string=@SetValue(elementClass=java.lang.Integer.class;,
{@Value(string=@StringValue("1")),
@Value(string=@StringValue="2"))})
)})
@@ -1909,8 +1909,8 @@
</property>
</bean></programlisting>
<para>Maps can also be created using multiple entries of key/value pairs. As we now have two types to consider we must use the <code>keyClass</code> and <code>valueClass</code> attributes to specify the default classes for each entry. Again these can be overriden for individual entries if necessary.</para>
- <programlisting role="JAVA">@MapValue(keyClass="java.lang.String",
- valueClass="java.lang.String",
+ <programlisting role="JAVA">@MapValue(keyClass=java.lang.String.class,
+ valueClass=java.lang.String.class;,
{@EntryValue(key=@Value(string=@StringValue("foo.bar.key")),
value=@Value(string=@StringValue("QWERT"))),
@EntryValue(key=@Value(string=@StringValue("xyz.key")),
@@ -1952,8 +1952,8 @@
</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 role="JAVA">@SetValue(clazz="java.util.TreeSet",
- elementClass="java.lang.Integer",
+ <programlisting role="JAVA">@SetValue(clazz=java.util.TreeSet.class,
+ elementClass=java.lang.Integer.class,
{@Value(string=@StringValue("50")),
@Value(string=@StringValue("55"))})
public void setSet(Set set) {
More information about the jboss-cvs-commits
mailing list