[jboss-cvs] JBossAS SVN: r64479 - in projects/microcontainer/trunk: kernel/src/main/org/jboss/kernel/plugins/annotations and 3 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Aug 7 06:09:55 EDT 2007
Author: alesj
Date: 2007-08-07 06:09:55 -0400 (Tue, 07 Aug 2007)
New Revision: 64479
Added:
projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase0.xml
projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase_Alias.xml
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/AliasSimpleBeanImpl.java
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasAnnotationTestCase.java
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasTestCase.java
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase.java
Modified:
projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/basics.xml
projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/examples.xml
projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/introduction.xml
projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/packaging.xml
projects/microcontainer/trunk/kernel/src/main/org/jboss/kernel/plugins/annotations/AliasesAnnotationPlugin.java
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/TestUtil.java
projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/DependencyTestSuite.java
Log:
Alias tests - plain, XML and annotations (TODO on remove).
Simple docs refactoring - by Manik.
Modified: projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/basics.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/basics.xml 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/basics.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -25,20 +25,27 @@
element acts as a container for many beans that are deployed together.
</para>
- <programlisting><?xml version="1.0" encoding="UTF-8"?>
+ <programlisting>
+<![CDATA[
- <!-- Deployment holds beans -->
- <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
- xmlns="urn:jboss:bean-deployer:2.0">
+ <?xml version="1.0" encoding="UTF-8"?>
- <!-- bean part of the deployment -->
- <bean .../>
+ <!-- Deployment holds beans -->
+ <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
+ xmlns="urn:jboss:bean-deployer:2.0">
- <!-- bean part of the deployment -->
- <bean .../>
+ <!-- bean part of the deployment -->
+ <bean .../>
- </deployment></programlisting>
+ <!-- bean part of the deployment -->
+ <bean .../>
+
+ </deployment>
+
+]]>
+ </programlisting>
+
</section>
<section>
@@ -50,14 +57,18 @@
</para>
<programlisting>
- <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
- xmlns="urn:jboss:bean-deployer:2.0">
+<![CDATA[
- <bean name="Simple"
- class="org.jboss.example.microcontainer.simple.SimpleBean"/>
+ <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
+ xmlns="urn:jboss:bean-deployer:2.0">
- </deployment>
+ <bean name="Simple"
+ class="org.jboss.example.microcontainer.simple.SimpleBean"/>
+
+ </deployment>
+
+]]>
</programlisting>
<para>The example above from the
@@ -87,14 +98,18 @@
</para>
<programlisting>
- public class ConstructorBean
- {
- ... ...
+<![CDATA[
- public ConstructorBean(int integer)
- {
+ public class ConstructorBean
+ {
+ ... ...
+
+ public ConstructorBean(int integer)
+ {
... ...
- }
+ }
+ }
+]]>
</programlisting>
<para>The
@@ -103,12 +118,17 @@
</para>
<programlisting>
- <bean name="Integer"
- class="org.jboss.example.microcontainer.constructor.ConstructorBean">
- <constructor>
- <parameter>4</parameter>
- </constructor>
- </bean>
+<![CDATA[
+
+ <bean name="Integer"
+ class="org.jboss.example.microcontainer.constructor.ConstructorBean">
+
+ <constructor>
+ <parameter>4</parameter>
+ </constructor>
+ </bean>
+
+]]>
</programlisting>
<para>The microcontainer would just use the following to create the
@@ -137,13 +157,18 @@
</para>
<programlisting>
- <bean name="StringLong"
- class="org.jboss.example.microcontainer.constructor.ConstructorBean">
- <constructor>
- <parameter>a string</parameter>
- <parameter class="long">10</parameter>
- </constructor>
- </bean>
+<![CDATA[
+
+ <bean name="StringLong"
+ class="org.jboss.example.microcontainer.constructor.ConstructorBean">
+
+ <constructor>
+ <parameter>a string</parameter>
+ <parameter class="long">10</parameter>
+ </constructor>
+ </bean>
+
+]]>
</programlisting>
<para>Behind the scene, the Micorcontainer invokes:</para>
@@ -168,13 +193,17 @@
</para>
<programlisting>
- public class StaticFactory
- {
- public static FactoryCreatedBean createBean()
- {
+<![CDATA[
+
+ public class StaticFactory
+ {
+ public static FactoryCreatedBean createBean()
+ {
return new FactoryCreatedBean("StaticFactory.createBean()");
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>The bean configuration tells the microcontainer to the use the
@@ -185,11 +214,17 @@
</para>
<programlisting>
- <bean name="StaticFactoryCreatedBean"
- class="org.jboss.example.microcontainer.factory.FactoryCreatedBean">
- <constructor factoryMethod="createBean"
+<![CDATA[
+
+ <bean name="StaticFactoryCreatedBean"
+ class="org.jboss.example.microcontainer.factory.FactoryCreatedBean">
+
+ <constructor factoryMethod="createBean"
factoryClass="org.jboss.example.microcontainer.factory.StaticFactory"/>
- </bean>
+
+ </bean>
+
+]]>
</programlisting>
<para>Of course, the factory class itself does not have to be static. The microcontainer can create a non-static
@@ -200,27 +235,32 @@
</para>
<programlisting>
- public class SingletonFactory
- {
- private static SingletonFactory singleton;
+<![CDATA[
- public synchronized static SingletonFactory getInstance()
- {
+ public class SingletonFactory
+ {
+ private static SingletonFactory singleton;
+
+ public synchronized static SingletonFactory getInstance()
+ {
if (singleton == null)
- singleton = new SingletonFactory();
+ singleton = new SingletonFactory();
+
return singleton;
- }
+ }
- public FactoryCreatedBean createBean()
- {
+ public FactoryCreatedBean createBean()
+ {
return new FactoryCreatedBean("SingletonFactory.createBean()");
- }
+ }
- private SingletonFactory()
- {
+ private SingletonFactory()
+ {
System.out.println("SingletonFactory()");
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>In the following configuration, we first create an instance of the
@@ -237,18 +277,26 @@
</para>
<programlisting>
- <bean name="SingletonFactory"
- class="org.jboss.example.microcontainer.factory.SingletonFactory">
- <constructor factoryMethod="getInstance"
+<![CDATA[
+
+ <bean name="SingletonFactory"
+ class="org.jboss.example.microcontainer.factory.SingletonFactory">
+
+ <constructor factoryMethod="getInstance"
factoryClass="org.jboss.example.microcontainer.factory.SingletonFactory"/>
- </bean>
- <bean name="SingletonFactoryCreatedBean"
- class="org.jboss.example.microcontainer.factory.FactoryCreatedBean">
- <constructor factoryMethod="createBean">
- <factory bean="SingletonFactory"/>
- </constructor>
- </bean>
+ </bean>
+
+ <bean name="SingletonFactoryCreatedBean"
+ class="org.jboss.example.microcontainer.factory.FactoryCreatedBean">
+
+ <constructor factoryMethod="createBean">
+ <factory bean="SingletonFactory"/>
+ </constructor>
+
+ </bean>
+
+]]>
</programlisting>
<para>Like the constructor method we mentioned before, the factory method can also take call parameters via the
@@ -270,33 +318,37 @@
</para>
<programlisting>
- public class PropertiesBean
- {
- public PropertiesBean()
- {
+<![CDATA[
+
+ public class PropertiesBean
+ {
+ public PropertiesBean()
+ {
System.out.println("PropertiesBean()");
- }
+ }
- public void setTitle(String title)
- {
+ public void setTitle(String title)
+ {
System.out.println("setTitle: " + title);
- }
+ }
- public void setSubTitle(String subTitle)
- {
+ public void setSubTitle(String subTitle)
+ {
System.out.println("setSubTitle: " + subTitle);
- }
+ }
- public void setLink(URL url)
- {
+ public void setLink(URL url)
+ {
System.out.println("setLink: " + url);
- }
+ }
- public void setNumber(Number number)
- {
+ public void setNumber(Number number)
+ {
System.out.println("setNumber: " + number + " type=" + number.getClass().getName());
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>The configuration creates the
@@ -305,13 +357,18 @@
</para>
<programlisting>
- <bean name="PropertiesBean"
- class="org.jboss.example.microcontainer.properties.PropertiesBean">
- <property name="title">JBoss Microcontainer property example</property>
- <property name="subTitle"><null/></property>
- <property name="link">http://www.jboss.org</property>
- <property name="number" class="java.lang.Long">4</property>
- </bean>
+<![CDATA[
+
+ <bean name="PropertiesBean"
+ class="org.jboss.example.microcontainer.properties.PropertiesBean">
+
+ <property name="title">JBoss Microcontainer property example</property>
+ <property name="subTitle"><null/></property>
+ <property name="link">http://www.jboss.org</property>
+ <property name="number" class="java.lang.Long">4</property>
+ </bean>
+
+]]>
</programlisting>
<para>Here we use the string representation of various objects, including the
@@ -339,26 +396,36 @@
</para>
<programlisting>
- import java.beans.PropertyEditorSupport;
- public class URLEditor extends PropertyEditorSupport{
- public void setAsText(final String text){
+<![CDATA[
+
+ import java.beans.PropertyEditorSupport;
+
+ public class URLEditor extends PropertyEditorSupport
+ {
+ public void setAsText(final String text)
+ {
setValue(new URL(text));
- }
- }
+ }
+ }
- public class Example{
- public URL getLink() {}
- public void setLink(URL url) {}
- }
+ public class Example
+ {
+ public URL getLink() {}
- <bean name="Name1" class=com.acme.Example">
- <property name="link">http://acme.com/index.html</property>
- </bean>
+ public void setLink(URL url) {}
- Example example = new com.acme.Example();
- PropertyEditor editor = PropertyEditorManager.findEditor(URL.class);
- editor.setAsText("http://acme.com/index.html");
- example.setLink((URL)editor.getValue());
+ }
+
+ <bean name="Name1" class=com.acme.Example">
+ <property name="link">http://acme.com/index.html</property>
+ </bean>
+
+ Example example = new com.acme.Example();
+ PropertyEditor editor = PropertyEditorManager.findEditor(URL.class);
+ editor.setAsText("http://acme.com/index.html");
+ example.setLink((URL)editor.getValue());
+
+]]>
</programlisting>
<para>Often the property takes an interface or abstract class, but you want to pass a specific implementation or a
@@ -368,90 +435,123 @@
</para>
<programlisting>
- public class Example{
+<![CDATA[
+
+ public class Example
+ {
public Number getNumber() {}
+
public void setNumber(Number number) {}
- }
- <bean name="Name1" class=com.acme.Example">
- <property name="number" class="java.lang.Long">4</property>
- </bean>
+ }
- Example example = new com.acme.Example();
- example.setNumber(new Long(4));
+ <bean name="Name1" class=com.acme.Example">
+ <property name="number" class="java.lang.Long">4</property>
+ </bean>
+
+ Example example = new com.acme.Example();
+ example.setNumber(new Long(4));
+
+]]>
</programlisting>
<para>There is also a more long-winded form of value that we will see later when configuring collections.</para>
<programlisting>
- public class Example{
- public Number getNumber() {}
- public void setNumber(Number number) {}
- }
+<![CDATA[
- <bean name="Name1" class=com.acme.Example">
- <property name="number"><value class="java.lang.Long">4</value></property>
- </bean>
+ public class Example
+ {
+ public Number getNumber() {}
- Example example = new com.acme.Example();
- example.setNumber(new Long(4));
+ public void setNumber(Number number) {}
+
+ }
+
+ <bean name="Name1" class=com.acme.Example">
+ <property name="number">
+ <value class="java.lang.Long">4</value>
+ </property>
+ </bean>
+
+ Example example = new com.acme.Example();
+ example.setNumber(new Long(4));
+
+]]>
</programlisting>
<para>Finally, the
<varname>null</varname>
- value is trivial, <null/>. But, it needs to differentiated from the string "null". Please see the example
+ value is trivial, <varname><![CDATA[<null/>]]></varname>. But, it needs to differentiated from the string "null". Please see the example
below for the usage.
</para>
<programlisting>
- public class Example{
+<![CDATA[
+
+ public class Example
+ {
public String getTitle() {}
+
public void setTitle(String string) {}
- }
- <!-- Wrong -->
- <bean name="Name1" class=com.acme.Example">
- <property name="title">null</property>
- </bean>
+ }
- Example example = new com.acme.Example();
- example.setTitle(new String("null"));
+ <!-- Wrong -->
+ <bean name="Name1" class=com.acme.Example">
+ <property name="title">null</property>
+ </bean>
- <!-- Correct -->
- <bean name="Name1" class=com.acme.Example">
- <property name="title"><null/></property>
- </bean>
+ Example example = new com.acme.Example();
+ example.setTitle(new String("null"));
- Example example = new com.acme.Example();
- example.setTitle(null);
+ <!-- Correct -->
+ <bean name="Name1" class=com.acme.Example">
+ <property name="title"><null/></property>
+ </bean>
+
+ Example example = new com.acme.Example();
+ example.setTitle(null);
+
+]]>
</programlisting>
- <para>Sometimes it is still usefull to be able to set or inject a value which can be morfed / progressed into
- needed type althogh existing type is not compatible (normally getting ClassCastException). This is mostly true
- for java.lang.Number subclasses. Let's see how <varname>progression</varname> is used on the following example
- (here we use <inject>, which is actually explained in the next chapter).
+ <para>Sometimes it is still usefull to be able to set or inject a value which can be morphed / progressed into
+ needed type althogh existing type is not compatible (normally getting <varname>ClassCastException</varname>). This is mostly true
+ for <varname>java.lang.Number</varname> subclasses. Let's see how <varname>progression</varname> is used on the following example
+ (here we use <varname><![CDATA[<inject />]]></varname>, which is actually explained in the next chapter).
</para>
<programlisting>
+<![CDATA[
- <bean name="FromBean" class="org.jboss.test.kernel.config.support.SimpleBean">
- <property name="adouble">123.456</property>
- <property name="AFloat" class="java.lang.Float">987.6543</property>
- <property name="anInt">314159</property>
- </bean>
+ <bean name="FromBean" class="org.jboss.test.kernel.config.support.SimpleBean">
+ <property name="adouble">123.456</property>
+ <property name="AFloat" class="java.lang.Float">987.6543</property>
+ <property name="anInt">314159</property>
+ </bean>
- <bean name="SimpleBean" class="org.jboss.test.kernel.config.support.SimpleBean">
- <property name="anint"><inject bean="FromBean" property="adouble" /></property>
- <property name="AShort"><inject bean="FromBean" property="AFloat" /></property>
- <property name="AFloat"><inject bean="FromBean" property="anInt" /></property>
- </bean>
+ <bean name="SimpleBean" class="org.jboss.test.kernel.config.support.SimpleBean">
+ <property name="anint">
+ <inject bean="FromBean" property="adouble" />
+ </property>
+ <property name="AShort">
+ <inject bean="FromBean" property="AFloat" />
+ </property>
+
+ <property name="AFloat">
+ <inject bean="FromBean" property="anInt" />
+ </property>
+ </bean>
+
+]]>
</programlisting>
<para>SimpleBean is a plain JavaBean, property names reflect the field type: having a<varname>double</varname>
- property name means that a field is of type double. A<varname>Float</varname> coresponds to Float type. Etc.
+ property name means that a field is of type double. A<varname>Float</varname> corresponds to Float type. Etc.
</para>
<para>You can change the progression behavior by setting System property
@@ -484,31 +584,35 @@
</para>
<programlisting>
- public class InjectionBean
- {
- String name;
+<![CDATA[
- public InjectionBean(String name)
- {
+ public class InjectionBean
+ {
+ String name;
+
+ public InjectionBean(String name)
+ {
this.name = name;
System.out.println("InjectionBean() " + this);
- }
+ }
- public String toString()
- {
+ public String toString()
+ {
return name;
- }
+ }
- public void setHost(String host)
- {
+ public void setHost(String host)
+ {
System.out.println("setHost: " + host + " on " + this);
- }
+ }
- public void setOther(InjectionBean other)
- {
+ public void setOther(InjectionBean other)
+ {
System.out.println("setOther: " + other + " on " + this);
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>The microcontainer creates the
@@ -521,19 +625,27 @@
</para>
<programlisting>
- <bean name="URL" class="java.net.URL">
- <constructor>
- <parameter>http://www.jboss.org/index.html</parameter>
- </constructor>
- </bean>
+<![CDATA[
- <bean name="InjectionBean1"
- class="org.jboss.example.microcontainer.injection.InjectionBean">
- <constructor>
- <parameter>InjectionBean1</parameter>
- </constructor>
- <property name="host"><inject bean="URL" property="host"/></property>
- </bean>
+ <bean name="URL" class="java.net.URL">
+ <constructor>
+ <parameter>http://www.jboss.org/index.html</parameter>
+ </constructor>
+ </bean>
+
+ <bean name="InjectionBean1"
+ class="org.jboss.example.microcontainer.injection.InjectionBean">
+
+ <constructor>
+ <parameter>InjectionBean1</parameter>
+ </constructor>
+
+ <property name="host">
+ <inject bean="URL" property="host"/>
+ </property>
+ </bean>
+
+]]>
</programlisting>
@@ -554,32 +666,47 @@
</para>
<programlisting>
- <bean name="Circular1"
- class="org.jboss.example.microcontainer.injection.InjectionBean">
- <constructor>
- <parameter>Circular1</parameter>
- </constructor>
- <property name="other"><inject bean="Circular2"/></property>
- </bean>
+<![CDATA[
- <bean name="Circular2"
- class="org.jboss.example.microcontainer.injection.InjectionBean">
- <constructor>
- <parameter>Circular2</parameter>
- </constructor>
- <property name="other">
- <inject bean="Circular1" state="Instantiated"/>
- </property>
- </bean>
+ <bean name="Circular1"
+ class="org.jboss.example.microcontainer.injection.InjectionBean">
+
+ <constructor>
+ <parameter>Circular1</parameter>
+ </constructor>
+
+ <property name="other">
+ <inject bean="Circular2"/>
+ </property>
+
+ </bean>
+
+ <bean name="Circular2"
+ class="org.jboss.example.microcontainer.injection.InjectionBean">
+
+ <constructor>
+ <parameter>Circular2</parameter>
+ </constructor>
+
+ <property name="other">
+ <inject bean="Circular1" state="Instantiated"/>
+ </property>
+ </bean>
+
+]]>
</programlisting>
<para>Here is the order the microcontainer instantiates those objects.</para>
<programlisting>
- InjectionBean Circular1 = new InjectionBean ();
- InjectionBean Circular2 = new InjectionBean ();
- Circular1.setOther(Circular2); // don't wait for a fully configured Circular1
- Circular2.setOther(Circular1); // Complete the confguration of Circular2
+<![CDATA[
+
+ InjectionBean Circular1 = new InjectionBean ();
+ InjectionBean Circular2 = new InjectionBean ();
+ Circular1.setOther(Circular2); // don't wait for a fully configured Circular1
+ Circular2.setOther(Circular1); // Complete the confguration of Circular2
+
+]]>
</programlisting>
</section>
@@ -587,37 +714,47 @@
<section>
<title>Value Factory</title>
- <para>Similar to using inject's property attribute, we sometimes want to use other beans to
+ <para>Similar to using <varname>inject</varname>'s property attribute, we sometimes want to use other beans to
create new values from bean's multi parameter methods.
</para>
<programlisting>
- <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
- <property name="value">
- <value-factory bean="ldap" method="getValue">
- <parameter>xyz.key</parameter>
- <parameter>xyz</parameter>
- <parameter><bean name="t" class="org.jboss.test.kernel.config.support.TrimTransformer"/></parameter>
- </value-factory>
- </property>
- </bean>
+<![CDATA[
- <bean name="ldap" class="org.jboss.test.kernel.config.support.LDAPFactory">
- <constructor>
- <parameter>
- <map keyClass="java.lang.String" valueClass="java.lang.String">
- <entry>
- <key>foo.bar.key</key>
- <value>QWERT</value>
- </entry>
- <entry>
- <key>xyz.key</key>
- <value> QWERT </value>
- </entry>
- </map>
- </parameter>
- </constructor>
- </bean>
+ <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
+ <property name="value">
+ <value-factory bean="ldap" method="getValue">
+ <parameter>xyz.key</parameter>
+ <parameter>xyz</parameter>
+ <parameter>
+ <bean name="t" class="org.jboss.test.kernel.config.support.TrimTransformer"/>
+ </parameter>
+ </value-factory>
+ </property>
+ </bean>
+
+ <bean name="ldap" class="org.jboss.test.kernel.config.support.LDAPFactory">
+ <constructor>
+ <parameter>
+ <map keyClass="java.lang.String" valueClass="java.lang.String">
+
+ <entry>
+ <key>foo.bar.key</key>
+ <value>QWERT</value>
+ </entry>
+
+ <entry>
+ <key>xyz.key</key>
+ <value>QWERT</value>
+ </entry>
+
+ </map>
+
+ </parameter>
+ </constructor>
+ </bean>
+
+]]>
</programlisting>
<para>For the quick usage there is also shorthand version of the value-factory element, having single parameter
@@ -625,28 +762,36 @@
</para>
<programlisting>
- <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
- <constructor>
- <parameter>
- <value-factory bean="ldap" method="getValue" parameter="foo.bar.key"/>
- </parameter>
- </constructor>
- </bean>
+<![CDATA[
+
+ <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
+ <constructor>
+ <parameter>
+ <value-factory bean="ldap" method="getValue" parameter="foo.bar.key"/>
+ </parameter>
+ </constructor>
+ </bean>
+
+]]>
</programlisting>
<para>You can also define a default value for the value-factory return value.
</para>
<programlisting>
- <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
- <property name="list">
- <list elementClass="java.lang.String">
- <value-factory bean="ldap" method="getValue" default="QWERT">
- <parameter>no.such.key</parameter>
- </value-factory>
- </list>
- <property>
- </bean>
+<![CDATA[
+
+ <bean name="PropHolder" class="org.jboss.test.kernel.config.support.PropHolder">
+ <property name="list">
+ <list elementClass="java.lang.String">
+ <value-factory bean="ldap" method="getValue" default="QWERT">
+ <parameter>no.such.key</parameter>
+ </value-factory>
+ </list>
+ <property>
+ </bean>
+
+]]>
</programlisting>
</section>
@@ -704,16 +849,24 @@
</para>
<programlisting>
- <bean name="PrintList"
- class="org.jboss.example.microcontainer.collections.ObjectPrinter">
- <constructor><parameter>List</parameter></constructor>
- <property name="print">
- <list elementClass="java.lang.String">
- <value>Value of type elementClass</value>
- <value class="java.lang.Integer">4</value>
- </list>
- </property>
- </bean>
+<![CDATA[
+
+ <bean name="PrintList"
+ class="org.jboss.example.microcontainer.collections.ObjectPrinter">
+
+ <constructor>
+ <parameter>List</parameter>
+ </constructor>
+
+ <property name="print">
+ <list elementClass="java.lang.String">
+ <value>Value of type elementClass</value>
+ <value class="java.lang.Integer">4</value>
+ </list>
+ </property>
+ </bean>
+
+]]>
</programlisting>
<para>It is also possible to use a
@@ -724,39 +877,47 @@
</para>
<programlisting>
- <bean name="Name1" class=com.acme.Example">
- <property name="list">
- <list class="java.util.LinkedList" elementClass="java.lang.String">
+<![CDATA[
- <value>A string</value> <!-- uses elementClass -->
+ <bean name="Name1" class="com.acme.Example">
+ <property name="list">
+ <list class="java.util.LinkedList" elementClass="java.lang.String">
- <value class="java.lang.URL">http://acme.com/index.html</value> <!-- a URL -->
+ <value>A string</value> <!-- uses elementClass -->
- <value><inject bean="SomeBean"/></value> <!-- inject some other bean -->
+ <value class="java.lang.URL">http://acme.com/index.html</value> <!-- a URL -->
- <value> <!-- a list inside a list -->
- <list elementClass="java.lang.String">
- <value>Another string</value>
- </list>
- </value>
+ <value><inject bean="SomeBean"/></value> <!-- inject some other bean -->
- </list>
- </property>
- </bean>
+ <value> <!-- a list inside a list -->
+ <list elementClass="java.lang.String">
+ <value>Another string</value>
+ </list>
+ </value>
+
+ </list>
+ </property>
+ </bean>
+
+]]>
</programlisting>
<para>Below is what happens inside the microcontainer.</para>
<programlisting>
- Example example = new com.acme.Example();
- List list = new LinkedList();
- list.add(new String("A string"));
- list.add(new URL("http://acme.com/index.html"));
- list.add(someBean);
- List subList = new ArrayList();
- subList.add(new String("Another string"));
- list.add(subList);
- element.setList(list);
+<![CDATA[
+
+ Example example = new com.acme.Example();
+ List list = new LinkedList();
+ list.add(new String("A string"));
+ list.add(new URL("http://acme.com/index.html"));
+ list.add(someBean);
+ List subList = new ArrayList();
+ subList.add(new String("Another string"));
+ list.add(subList);
+ element.setList(list);
+
+]]>
</programlisting>
<para>The other type of collection is a map which also covers Properties and Hashtables. The default is
@@ -777,26 +938,37 @@
</para>
<programlisting>
- <bean name="PrintMap"
- class="org.jboss.example.microcontainer.collections.ObjectPrinter">
- <constructor><parameter>Map</parameter></constructor>
- <property name="print">
- <map keyClass="java.lang.String" valueClass="java.lang.String">
- <entry>
- <key>Key1 of type keyClass</key>
- <value>Value1 of type valueClass</value>
- </entry>
- <entry>
- <key>Key2 of type keyClass</key>
- <value class="java.lang.Integer">4</value>
- </entry>
- <entry>
- <key class="java.lang.Long">4</key>
- <value>Value of type valueClass</value>
- </entry>
- </map>
- </property>
- </bean>
+<![CDATA[
+
+ <bean name="PrintMap"
+ class="org.jboss.example.microcontainer.collections.ObjectPrinter">
+
+ <constructor>
+ <parameter>Map</parameter>
+ </constructor>
+
+ <property name="print">
+ <map keyClass="java.lang.String" valueClass="java.lang.String">
+ <entry>
+ <key>Key1 of type keyClass</key>
+ <value>Value1 of type valueClass</value>
+ </entry>
+
+ <entry>
+ <key>Key2 of type keyClass</key>
+ <value class="java.lang.Integer">4</value>
+ </entry>
+
+ <entry>
+ <key class="java.lang.Long">4</key>
+ <value>Value of type valueClass</value>
+ </entry>
+ </map>
+ </property>
+
+ </bean>
+
+]]>
</programlisting>
<para>When using collections in your bean configuration, this is the order Microcontainer will use for new
@@ -824,14 +996,18 @@
</para>
<programlisting>
- <bean name="SimpleBean" class="org.jboss.test.kernel.config.support.UnmodifiableGetterBean">
- <property name="list" preinstantiate="false">
- <list elementClass="java.lang.String">
- <value>string1</value>
- <value>string2</value>
- </list>
- </property>
- </bean>
+<![CDATA[
+
+ <bean name="SimpleBean" class="org.jboss.test.kernel.config.support.UnmodifiableGetterBean">
+ <property name="list" preinstantiate="false">
+ <list elementClass="java.lang.String">
+ <value>string1</value>
+ <value>string2</value>
+ </list>
+ </property>
+ </bean>
+
+]]>
</programlisting>
</section>
@@ -895,41 +1071,45 @@
</para>
<programlisting>
- public class LifecycleBean
- {
- String name;
+<![CDATA[
- public LifecycleBean(String name)
- {
+ public class LifecycleBean
+ {
+ String name;
+
+ public LifecycleBean(String name)
+ {
this.name = name;
System.out.println("LifecycleBean() " + this);
- }
+ }
- public void create()
- {
+ public void create()
+ {
System.out.println("create: " + this);
- }
+ }
- public void start()
- {
+ public void start()
+ {
System.out.println("start: " + this);
- }
+ }
- public void stop()
- {
+ public void stop()
+ {
System.out.println("stop: " + this);
- }
+ }
- public void destroy()
- {
+ public void destroy()
+ {
System.out.println("destroy: " + this);
- }
+ }
- public String toString()
- {
+ public String toString()
+ {
return name;
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>The
@@ -938,20 +1118,29 @@
</para>
<programlisting>
- <bean name="Lifecycle1"
- class="org.jboss.example.microcontainer.lifecycle.LifecycleBean">
- <constructor>
- <parameter>Lifecycle1</parameter>
- </constructor>
- <depends>Lifecycle2</depends>
- </bean>
+<![CDATA[
- <bean name="Lifecycle2"
- class="org.jboss.example.microcontainer.lifecycle.LifecycleBean">
- <constructor>
- <parameter>Lifecycle2</parameter>
- </constructor>
- </bean>
+ <bean name="Lifecycle1"
+ class="org.jboss.example.microcontainer.lifecycle.LifecycleBean">
+
+ <constructor>
+ <parameter>Lifecycle1</parameter>
+ </constructor>
+
+ <depends>Lifecycle2</depends>
+
+ </bean>
+
+ <bean name="Lifecycle2"
+ class="org.jboss.example.microcontainer.lifecycle.LifecycleBean">
+
+ <constructor>
+ <parameter>Lifecycle2</parameter>
+ </constructor>
+
+ </bean>
+
+]]>
</programlisting>
<para>The microcontainer resolves the dependency and starts both beans in the appropriate order. Below is the
@@ -990,15 +1179,20 @@
</para>
<programlisting>
- public class Example{
- public void initialize(Object someObject) {}
- }
+<![CDATA[
- <bean name="Name1" class="com.acme.Example">
- <create method="initialize">
- <parameter><inject bean="SomeBean"/></parameter>
- </create>
- </bean>
+ public class Example
+ {
+ public void initialize(Object someObject) {}
+ }
+
+ <bean name="Name1" class="com.acme.Example">
+ <create method="initialize">
+ <parameter><inject bean="SomeBean"/></parameter>
+ </create>
+ </bean>
+
+]]>
</programlisting>
<para>They can also be ignored. See the
@@ -1007,13 +1201,18 @@
</para>
<programlisting>
- public class Example{
- public void start() {}
- }
+<![CDATA[
- <bean name="Name1" class="com.acme.Example">
- <start ignore="true"/>
- </bean>
+ public class Example
+ {
+ public void start() {}
+ }
+
+ <bean name="Name1" class="com.acme.Example">
+ <start ignore="true"/>
+ </bean>
+
+]]>
</programlisting>
<para>In this case Microcontainer would not
@@ -1032,23 +1231,30 @@
</para>
<programlisting>
- <bean name="Name1" class="java.util.Timer"/>
- <bean name="Name2" ...>
- <install bean="Name1" method="schedule">
- <parameter><this/></parameter>
- <parameter>100</parameter>
- <parameter>10000</parameter>
- </install>
- <uninstall method="cancel"/>
- </bean>
+<![CDATA[
- // Install
- Name1 = new Timer();
- Name2 = ...;
- Name1.schedule(Name2, 100, 10000);
+ <bean name="name1" class="java.util.Timer"/>
- // Uninstall
- name2.cancel();
+ <bean name="name2" ...>
+ <install bean="name1" method="schedule">
+ <parameter><this/></parameter>
+ <parameter>100</parameter>
+ <parameter>10000</parameter>
+ </install>
+
+ <uninstall method="cancel"/>
+
+ </bean>
+
+ // Install
+ name1 = new Timer();
+ name2 = ...;
+ name1.schedule(Name2, 100, 10000);
+
+ // Uninstall
+ name2.cancel();
+
+]]>
</programlisting>
</section>
@@ -1060,23 +1266,29 @@
</para>
<programlisting>
- // deployment level - applies to all beans in the deployment
- <deployment>
- <classloader><inject bean="ClassLoaderName"/></classloader>
+<![CDATA[
- // bean level
- <bean name="Name2" ...>
- <classloader><inject bean="ClassLoaderName"/></classloader>
- </bean>
+ <!-- deployment level - applies to all beans in the deployment -->
+ <deployment>
+ <classloader><inject bean="ClassLoaderName"/></classloader>
- // bean level will use any deployment level classloader
- <bean name="Name2" ...>
- </bean>
+ <!-- bean level -->
+ <bean name="Name2" ...>
+ <classloader><inject bean="ClassLoaderName"/></classloader>
+ </bean>
- // bean level as null to not use any deployment level classloader
- <bean name="Name2" ...>
- <classloader><null/></classloader>
- </bean>
+ <!-- bean level will use any deployment level classloader -->
+ <bean name="Name2" ...>
+ </bean>
+
+ <!-- bean level as null to not use any deployment level classloader -->
+ <bean name="Name2" ...>
+ <classloader><null/></classloader>
+ </bean>
+
+ </deployment>
+
+]]>
</programlisting>
</section>
@@ -1084,7 +1296,7 @@
<title>Annotations via XML</title>
<para>With the new Microcontainer 2.0 we've added support for annotations via XML. Meaning you can have annotation
- support even in Java 1.4 and before, depending on the retrowowen Microcontainer project.
+ support even in Java 1.4 and before, depending on the retrowoven Microcontainer project.
Each annotation is set per bean instance and you can set annotations on the following types:
<itemizedlist>
<listitem>deployment (all beans inherit this annotations)</listitem>
@@ -1099,47 +1311,51 @@
</para>
<programlisting>
- <deployment name="SimpleDeployment" xmlns="urn:jboss:bean-deployer:2.0">
+<![CDATA[
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
- <annotation>@org.jboss.test.kernel.deployment.xml.support.AnnotationWithAttributes(clazz=java.lang.Integer.class, integer=100, str="Annotations are nice")</annotation>
+ <deployment name="SimpleDeployment" xmlns="urn:jboss:bean-deployer:2.0">
- <bean name="bn1" class="org.jboss.test.Example1">
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation2</annotation>
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation3</annotation>
- </bean>
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.AnnotationWithAttributes(clazz=java.lang.Integer.class, integer=100, str="Annotations are nice")</annotation>
- <bean name="bn2" class="org.jboss.test.Example2">
- <constructor>
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation3</annotation>
- </constructor>
- </bean>
+ <bean name="bn1" class="org.jboss.test.Example1">
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation2</annotation>
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation3</annotation>
+ </bean>
- <bean name="bn3" class="org.jboss.test.Example3">
- <install method="someMethod">
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
- </install>
- </bean>
+ <bean name="bn2" class="org.jboss.test.Example2">
+ <constructor>
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation3</annotation>
+ </constructor>
+ </bean>
- <bean name="bn4" class="org.jboss.test.Example4">
- <create>
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
- </create>
- </bean>
+ <bean name="bn3" class="org.jboss.test.Example3">
+ <install method="someMethod">
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
+ </install>
+ </bean>
- <bean name="bn5" class="org.jboss.test.Example5">
- <property name="PropertyName">
- <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
- <value>123</value>
- </property>
- </bean>
+ <bean name="bn4" class="org.jboss.test.Example4">
+ <create>
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
+ </create>
+ </bean>
- </deployment>
+ <bean name="bn5" class="org.jboss.test.Example5">
+ <property name="PropertyName">
+ <annotation>@org.jboss.test.kernel.deployment.xml.support.Annotation1</annotation>
+ <value>123</value>
+ </property>
+ </bean>
+
+ </deployment>
+
+]]>
</programlisting>
<para>The only issue with having annotations defined via XML is that they are per instance basis -
as already mentioned, not added at compile time. In this case you need an external mechanism in
- order to do the annotation inspection. In Microcontainer this is its MetaData Repository.
+ order to do the annotation inspection. In Microcontainer this is its metadata repository.
See how this is done in Reference Manual, TODO.
</para>
@@ -1148,58 +1364,73 @@
<section>
<title>Alias</title>
- <para>Mostly bean will have one unique name, but sometimes it is useful to be able to have an extra name.
+ <para>Mostly each bean will have one unique name, but sometimes it is useful to be able to have an extra name.
The extra ones are considered aliases.
</para>
<programlisting>
- <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
- <alias>SimpleAlias</alias>
- </bean>
+<![CDATA[
+
+ <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
+ <alias>SimpleAlias</alias>
+ </bean>
+
+]]>
</programlisting>
<para>As with all String values you can have System property replacement as part of actual alias value.
Additionally you can specify if this replacement is ignored. Or you can even convert final alias String value
- into any other class supported by PropertyEditors by setting class attribute on alias element. Let see this
- configuration on examples below.
+ into any other class supported by PropertyEditors by setting class attribute on alias element. Lets see this
+ configuration on the examples below.
</para>
<programlisting>
- <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
- <alias>${example.cluster.name}</alias>
- </bean>
+<![CDATA[
- <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
- <alias replace="false">X${alias.test.name}X</alias>
- </bean>
+ <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
+ <alias>${example.cluster.name}</alias>
+ </bean>
- <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
- <alias class="java.lang.Integer">12345</alias>
- </bean>
+ <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
+ <alias replace="false">X${alias.test.name}X</alias>
+ </bean>
+
+ <bean xmlns="urn:jboss:bean-deployer:2.0" class="org.acme.Example">
+ <alias class="java.lang.Integer">12345</alias>
+ </bean>
+
+]]>
</programlisting>
<para>Having to specify all aliases when the bean is actually defined is not always adequate however. It is
sometimes desirable to introduce an alias for a bean which is defined elsewhere. In XML-based configuration
- metadata this may be accomplished via the use of the standalone <alias/> element.
+ metadata this may be accomplished via the use of the standalone <varname><![CDATA[<alias/>]]></varname> element.
</para>
<programlisting>
- <deployment name="FirstDeployment" xmlns="urn:jboss:bean-deployer:2.0">
- <bean name="Bean1" class="java.lang.Object"/>
+<![CDATA[
- <bean name="Bean2" class="java.lang.Object"/>
- </deployment>
+ <deployment name="FirstDeployment" xmlns="urn:jboss:bean-deployer:2.0">
- <deployment name="SecondDeployment" xmlns="urn:jboss:bean-deployer:2.0">
- <bean name="Xyz1" class="java.lang.Object">
- <property name="locker1"><inject name="Lock1"></property>
- <property name="locker2"><inject name="Lock2"></property>
- </bean>
+ <bean name="Bean1" class="java.lang.Object"/>
- <alias name="Bean1">Lock1</alias>
+ <bean name="Bean2" class="java.lang.Object"/>
- <alias name="Bean2">Lock2</alias>
- </deployment>
+ </deployment>
+
+ <deployment name="SecondDeployment" xmlns="urn:jboss:bean-deployer:2.0">
+
+ <bean name="Xyz1" class="java.lang.Object">
+ <property name="locker1"><inject name="Lock1"></property>
+ <property name="locker2"><inject name="Lock2"></property>
+ </bean>
+
+ <alias name="Bean1">Lock1</alias>
+
+ <alias name="Bean2">Lock2</alias>
+ </deployment>
+
+]]>
</programlisting>
<para>
@@ -1214,43 +1445,48 @@
</section>
<section>
- <title>Demand / Supply</title>
+ <title>Supply and Demand</title>
<para>
- There is another useful definition of loosly coupled dependency.
+ There is another useful definition of loosely coupled dependency.
Each bean can define which beans should be installed for it to move
to certain state.
</para>
<programlisting>
- <bean name="TM" class="com.acme.SomeSingleton1">
- <property name="host">http://www.jboss.org</property>
- </bean>
+<![CDATA[
- <bean name="SM" class="com.acme.AnotherSingleton">
- <property name="treadSize">10</property>
- </bean>
+ <bean name="TM" class="com.acme.SomeSingleton">
+ <property name="host">http://www.jboss.org</property>
+ </bean>
- <bean name="Name2" class="com.acme.Example">
- <property name="threadPool"><inject bean="pool"/></property>
- <demand state="Start">TM</demand>
- <demand state="Configure">SM</demand>
- </bean>
+ <bean name="SM" class="com.acme.AnotherSingleton">
+ <property name="treadSize">10</property>
+ </bean>
- // Example class
- public class Example{
+ <bean name="Name2" class="com.acme.Example">
+ <property name="threadPool"><inject bean="pool"/></property>
+ <demand state="Start">TM</demand>
+ <demand state="Configure">SM</demand>
+ </bean>
- public void start() {
+ // Example class
+ public class Example
+ {
+ public void start()
+ {
SomeSingleton tm = ...; // should be there!
- }
+ }
- public void setThreadPool(ThreadPool pool) {
+ public void setThreadPool(ThreadPool pool)
+ {
AnotherSingleton config = ...; // should be there
pool.setThreadSize(config.getThreadSize());
- }
+ }
- }
+ }
+]]>
</programlisting>
<para>
@@ -1261,28 +1497,35 @@
</para>
<programlisting>
- public class FooBarBinder extends JndiBinder {
+<![CDATA[
- public void start() {
+ public class FooBarBinder extends JndiBinder
+ {
+ public void start()
+ {
FooBar foobar = new FooBar();
bindToJndi("fbName", foobar);
- }
+ }
- }
+ }
- public class FooBarConsumer {
- public FooBarConsumer() {
+ public class FooBarConsumer
+ {
+ public FooBarConsumer()
+ {
FooBar foobar = ...; // get it from jndi. should be there
- }
- }
+ }
+ }
- <bean name="provider" class="com.acme.FooBarBinder">
- <supply>foobar</property>
- </bean>
+ <bean name="provider" class="com.acme.FooBarBinder">
+ <supply>foobar</supply>
+ </bean>
- <bean name="consumer" class="com.acme.FooBarConsumer">
- <demand state="Instantiate">foobar</>;
- </bean>
+ <bean name="consumer" class="com.acme.FooBarConsumer">
+ <demand state="Instantiate">foobar</demand>
+ </bean>
+
+]]>
</programlisting>
</section>
@@ -1314,8 +1557,11 @@
</para>
<programlisting>
- <bean name="ignored" class="com.acme.Example" autowire-candidate="false">
- </bean>
+<![CDATA[
+
+ <bean name="ignored" class="com.acme.Example" autowire-candidate="false" />
+
+]]>
</programlisting>
<para>
@@ -1323,8 +1569,11 @@
</para>
<programlisting>
- <bean name="autowired" class="com.acme.Example" autowire="true">
- </bean>
+<![CDATA[
+
+ <bean name="autowired" class="com.acme.Example" autowire="true" />
+
+]]>
</programlisting>
<para>
@@ -1337,28 +1586,39 @@
</para>
<programlisting>
- <bean name="propInj" class="com.acme.ThreadPoolImpl"/>
+<![CDATA[
- <bean name="propInj" class="com.acme.Example">
- <property name="threadPool"><inject/></property>
- </bean>
+ <bean name="propInj" class="com.acme.ThreadPoolImpl"/>
- <bean name="paramInj" class="com.acme.Example">
- <constructor>
- <parameter name="threadPool"><inject/></parameter>
- </constructor>
- </bean>
+ <bean name="propInj" class="com.acme.Example">
+ <property name="threadPool"><inject/></property>
+ </bean>
- public class Example {
- protected ThreadPool pool;
- public Example() {}
- public Example(ThreadPool pool) {
+ <bean name="paramInj" class="com.acme.Example">
+ <constructor>
+ <parameter name="threadPool"><inject/></parameter>
+ </constructor>
+ </bean>
+
+ public class Example
+ {
+ protected ThreadPool pool;
+
+ public Example() {}
+
+ public Example(ThreadPool pool)
+ {
this.pool = pool;
- }
- public void setThreadPool(ThreadPool pool) {
+ }
+
+ public void setThreadPool(ThreadPool pool)
+ {
this.pool = pool;
- }
- }
+ }
+
+ }
+
+]]>
</programlisting>
<para>
@@ -1370,23 +1630,33 @@
</para>
<programlisting>
- <bean name="editorHolder" class="com.acme.Example">
- <incallback method="addEditor" />
- <uncallback method="removeEditor" />
- </bean>
+<![CDATA[
- <bean name="fbEditor" class="com.acme.FooEditor"/>
+ <bean name="editorHolder" class="com.acme.Example">
+ <incallback method="addEditor" />
+ <uncallback method="removeEditor" />
+ </bean>
- public class Example {
- protected Set<Editor> editors = new HashSet<Editor>();
- public Example() {}
- public void addEditor(Editor editor) {
+ <bean name="fbEditor" class="com.acme.FooEditor"/>
+
+ public class Example
+ {
+ protected Set<Editor> editors = new HashSet<Editor>();
+
+ public Example() {}
+
+ public void addEditor(Editor editor)
+ {
editors.add(editor);
- }
- public void removeEditor(Editor editor) {
+ }
+
+ public void removeEditor(Editor editor)
+ {
editors.remove(editor);
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>
@@ -1398,21 +1668,30 @@
</para>
<programlisting>
- <bean name="editorHolder" class="com.acme.Example">
- <incallback property="editors" cardinality="2..n" />
- <uncallback property="editors" />
- </bean>
+<![CDATA[
- <bean name="fbEditor" class="com.acme.FooEditor"/>
- <bean name="xyzEditor" class="com.acme.XYZEditor"/>
+ <bean name="editorHolder" class="com.acme.Example">
+ <incallback property="editors" cardinality="2..n" />
+ <uncallback property="editors" />
+ </bean>
- public class Example {
- protected Set<Editor> editors;
- public Example() {}
- public void setEditors(Set<Editor> editors) {
+ <bean name="fbEditor" class="com.acme.FooEditor"/>
+
+ <bean name="xyzEditor" class="com.acme.XYZEditor"/>
+
+ public class Example
+ {
+ protected Set<Editor> editors;
+
+ public Example() {}
+
+ public void setEditors(Set<Editor> editors)
+ {
this.editors = editors;
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>While using callbacks on the Collection subclasses, currently only basic Collection subinterfaces
@@ -1435,46 +1714,50 @@
</para>
<para>
- With already known injection concept (<inject\>), now you can also inject some information from the context.
+ With already known injection concept (<varname><![CDATA[<inject />]]></varname>), now you can also inject some information from the context.
This is what you can currently get a hold on from the underlying context:
<itemizedlist>
<listitem>
- <para>name - <inject fromContext="name"/></para>
+ <para>name - <varname><![CDATA[<inject fromContext="name"/>]]></varname></para>
</listitem>
<listitem>
- <para>aliases - <inject fromContext="aliases"/></para>
+ <para>aliases - <varname><![CDATA[<inject fromContext="aliases"/>]]></varname></para>
</listitem>
<listitem>
- <para>metadata - <inject fromContext="metadata"/></para>
+ <para>metadata - <varname><![CDATA[<inject fromContext="metadata"/>]]></varname></para>
</listitem>
<listitem>
- <para>beaninfo - <inject fromContext="beaninfo"/></para>
+ <para>beaninfo - <varname><![CDATA[<inject fromContext="beaninfo"/>]]></varname></para>
</listitem>
<listitem>
- <para>scope - <inject fromContext="scope"/></para>
+ <para>scope - <varname><![CDATA[<inject fromContext="scope"/>]]></varname></para>
</listitem>
<listitem>
- <para>id - <inject fromContext="id"/></para>
+ <para>id - <varname><![CDATA[<inject fromContext="id"/>]]></varname></para>
</listitem>
<listitem>
- <para>context itself - <inject fromContext="context"/></para>
+ <para>context itself - <varname><![CDATA[<inject fromContext="context"/>]]></varname></para>
</listitem>
</itemizedlist>
</para>
<para>All this information is wrapped into unmodifiable objects, preventing user to add or set additional
information outside Microcontainer's Controller.
- As we already know, <inject/> element can take bean attribute. In this case, if bean attribute is set,
+ As we already know, <varname><![CDATA[<inject/>]]></varname> element can take bean attribute. In this case, if bean attribute is set,
we are not targeting bean's underlying context, but context that coresponds to set bean attribute.
</para>
<programlisting>
- <bean name="sndBean" class="org.jboss.test.kernel.deployment.support.NameAwareBean">
- <property name="beaninfo"><inject bean="otherBean" fromContext="beaninfo"/></property>
- </bean>
+<![CDATA[
+
+ <bean name="sndBean" class="org.jboss.test.kernel.deployment.support.NameAwareBean">
+ <property name="beaninfo"><inject bean="otherBean" fromContext="beaninfo"/></property>
+ </bean>
+
+]]>
</programlisting>
<para>In this example we inject otherBean's beaninfo information into sndBean bean.</para>
</section>
-</section>
\ No newline at end of file
+</section>
Modified: projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/examples.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/examples.xml 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/examples.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -9,7 +9,7 @@
<title>A Simple IoC Examples</title>
<para>The best way to learn the Microcontainer is through examples. The Microcontainer distribution is bundled
- with several examples, which we will discuss in later this guide. In this section, let's first have a look at
+ with several examples, which we will discuss in later this guide. In this section, let us first have a look at
the
<varname>simple</varname>
example. It shows the structure of a simple Microcontainer application and how to run the application in both
@@ -26,13 +26,17 @@
</para>
<programlisting>
- public class SimpleBean
- {
- public SimpleBean()
- {
+<![CDATA[
+
+ public class SimpleBean
+ {
+ public SimpleBean()
+ {
System.out.println("SimpleBean() constructor");
- }
- }
+ }
+ }
+
+]]>
</programlisting>
<para>The
@@ -46,14 +50,18 @@
</para>
<programlisting>
- <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
- xmlns="urn:jboss:bean-deployer:2.0">
+<![CDATA[
- <bean name="Simple"
+ <deployment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="urn:jboss:bean-deployer bean-deployer_2_0.xsd"
+ xmlns="urn:jboss:bean-deployer:2.0">
+
+ <bean name="Simple"
class="org.jboss.example.microcontainer.simple.SimpleBean"/>
- </deployment>
+ </deployment>
+
+]]>
</programlisting>
<para>This configuration file tells the Microcontainer to create an instance of the
@@ -62,13 +70,13 @@
<varname>Simple</varname>
. When other objects in the application need to access this
<varname>SimpleBean</varname>
- instance, they can simply ask for the
+ instance, they can simply ask the Microcontainer API for the
<varname>Simple</varname>
- object from the Microcontainer API. Essentially, we just created a
+ object. Essentially, we just created a
<varname>SimpleBean</varname>
singleton instance here. When we run this application, we are expected to see the
<varname>"SimpleBean() constructor"</varname>
- printout from the console when the Microcontainer creates the
+ printout on the console when the Microcontainer creates the
<varname>Simple</varname>
object.
</para>
@@ -96,39 +104,45 @@
</para>
<programlisting>
- <target name="compile">
+<![CDATA[
- <mkdir dir="build"/>
+ <target name="compile">
- <javac destdir="build"
+ <mkdir dir="build"/>
+
+ <javac destdir="build"
debug="on"
deprecation="on"
optimize="on"
classpathref="compile.classpath">
- <src path="src"/>
- </javac>
- </target>
- <target name="dist" depends="compile">
+ <src path="src"/>
+ </javac>
- <copy todir="build">
- <fileset dir="src/resources"/>
- </copy>
+ </target>
- <mkdir dir="dist"/>
+ <target name="dist" depends="compile">
- <jar jarfile="dist/${ant.project.name}.beans" basedir="build"/>
+ <copy todir="build">
+ <fileset dir="src/resources"/>
+ </copy>
- </target>
+ <mkdir dir="dist"/>
+
+ <jar jarfile="dist/${ant.project.name}.beans" basedir="build"/>
+
+ </target>
+
+]]>
</programlisting>
<para>The
<varname>compile</varname>
- task compiles the Java source files into class files under the
+ target compiles the Java source files into class files under the
<varname>build</varname>
directory. Then, the
<varname>dist</varname>
- task packages the class files and the
+ target packages the class files and the
<varname>META-INF/jboss-beans.xml</varname>
file together in a JAR file named
<varname>example-simple.jar</varname>
@@ -143,7 +157,7 @@
<para>This just skims the surface of the Microcontainer, showing the most
common usecases. Other more complicated examples can be found in the tests
- (available from SVN).</para>
+ (available in the source code repository).</para>
</section>
-</chapter>
\ No newline at end of file
+</chapter>
Modified: projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/introduction.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/introduction.xml 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/introduction.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -9,15 +9,15 @@
used standalone outside the JBoss Application Server.
</para>
- <para>As we mention JBoss Application Server, while rewritting its Microkernel to POJO environment, there were other
+ <para>As we mention JBoss Application Server, while rewriting its Microkernel to a POJO environment, there were other
aspects that also needed to be considered while changing the core functionality. New modules or subprojects were
- introduced to the Microcontainer project to tightly integrate those aspects with the new POJO direction and to
+ introduced to the Microcontainer project to tightly integrate those aspects with the new POJO approach and to
eventually solve some of the basic problems that arose over the years with the changes application server went
through.
- We will discuss those modules or subproject later on.
+ We will discuss these modules and subproject later on.
</para>
- <para>At its core, the JBoss Microcontainer is a generic "dependency injection" framework. It's primary function is
+ <para>At its core, the JBoss Microcontainer is a generic "dependency injection" framework. Its primary function is
to instantiate objects, figure out their dependencies (e.g., object A must be instantiated before object B), and
then manage the relationship between those objects (e.g., object A is a property of object B). With the JBoss
Microcontainer, you can build applications or shared services using simple POJOs. The JBoss Microcontainer is
@@ -29,7 +29,7 @@
existing
dependency injection frameworks such as the Spring framework and HiveMind framework. However, JBoss
Microcontainer
- also has several important new features that set it apart from existing frameworks.
+ also has several important new features that sets it apart from existing frameworks.
</para>
<itemizedlist mark="bullet">
@@ -50,7 +50,7 @@
</para>
</listitem>
<listitem>
- <para>JBoss Microcontainer is used as a replacement for JMX based kernel in the new JBoss AS 5.x and above.
+ <para>JBoss Microcontainer is used as a replacement for the JMX-based Microkernel in JBoss AS 5.x and above.
All
the existing features of MBeans are thightly integrated into new Microcontainer based ServiceController.
</para>
@@ -106,9 +106,8 @@
<para>This document takes you through some example deployments into
JBoss Microcontainer 2.0 explaining how to configure POJOs and link them together
through injection.
- We will also explain how to use other Microcontainer modules inside new JBoss AS 5.x, specially the re-written
- deployers and classloader modules.
- Later will show how to do the same thing outside the application server.
+ We will also explain how to use other Microcontainer modules inside JBoss AS 5.x, especially the re-written
+ deployers and classloader modules. Later, we will discuss how to do the same thing outside the application server.
</para>
-</chapter>
\ No newline at end of file
+</chapter>
Modified: projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/packaging.xml
===================================================================
--- projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/packaging.xml 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/docs/gettingstarted/src/docbkx/en/modules/packaging.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -6,7 +6,7 @@
<title>Packaging</title>
<para>We had a brief discussion on the
- <varname>-beans.xml</varname>
+ <varname>jboss-beans.xml</varname>
file in
<xref
linkend="examples"/>
@@ -43,18 +43,23 @@
</para>
<programlisting>
- <?xml version='1.0' encoding='UTF-8'?>
+<![CDATA[
- <!DOCTYPE jboss-app
- PUBLIC "-//JBoss//DTD J2EE Application 1.4//EN"
- "http://www.jboss.org/j2ee/dtd/jboss-app_4_0.dtd"
- >
+ <xml version='1.0' encoding='UTF-8'?>
- <jboss-app>
+ <!DOCTYPE jboss-app
+ PUBLIC "-//JBoss//DTD J2EE Application 1.4//EN"
+ "http://www.jboss.org/j2ee/dtd/jboss-app_4_0.dtd">
- <module><service>example.jar</service></module>
+ <jboss-app>
- </jboss-app>
+ <module>
+ <service>example.jar</service>
+ </module>
+
+ </jboss-app>
+
+]]>
</programlisting>
-</chapter>
\ No newline at end of file
+</chapter>
Modified: projects/microcontainer/trunk/kernel/src/main/org/jboss/kernel/plugins/annotations/AliasesAnnotationPlugin.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/main/org/jboss/kernel/plugins/annotations/AliasesAnnotationPlugin.java 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/kernel/src/main/org/jboss/kernel/plugins/annotations/AliasesAnnotationPlugin.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -21,15 +21,16 @@
*/
package org.jboss.kernel.plugins.annotations;
+import java.util.List;
import java.util.Set;
-import java.util.List;
import org.jboss.beans.metadata.plugins.annotations.Aliases;
import org.jboss.beans.metadata.spi.BeanMetaData;
import org.jboss.beans.metadata.spi.MetaDataVisitorNode;
+import org.jboss.dependency.spi.Controller;
+import org.jboss.dependency.spi.ControllerContext;
+import org.jboss.kernel.spi.dependency.KernelControllerContext;
import org.jboss.reflect.spi.ClassInfo;
-import org.jboss.kernel.spi.dependency.KernelControllerContext;
-import org.jboss.dependency.spi.Controller;
import org.jboss.util.StringPropertyReplacer;
/**
@@ -55,8 +56,18 @@
if (aliases == null || aliases.contains(alias) == false)
{
- // alias will get removed when original will be undeployed
- controller.addAlias(alias, beanMetaData.getName());
+ // impl detail (_Alias)
+ if (controller.getContext(alias + "_Alias", null) == null)
+ {
+ // TODO!! impl remove
+ controller.addAlias(alias, beanMetaData.getName());
+ }
+ else
+ {
+ ControllerContext existingContext = controller.getContext(alias, null);
+ if (existingContext != null && existingContext != context)
+ throw new IllegalArgumentException("Alias " + alias + " already registered for different bean: " + existingContext);
+ }
}
}
// no metadata added
Added: projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase0.xml
===================================================================
--- projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase0.xml (rev 0)
+++ projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase0.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<deployment xmlns="urn:jboss:bean-deployer:2.0">
+ <bean name="OriginalBean" class="org.jboss.test.kernel.dependency.support.SimpleBeanImpl">
+ <property name="string">String1</property>
+ </bean>
+</deployment>
Added: projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase_Alias.xml
===================================================================
--- projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase_Alias.xml (rev 0)
+++ projects/microcontainer/trunk/kernel/src/resources/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase_Alias.xml 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<deployment xmlns="urn:jboss:bean-deployer:2.0">
+ <alias name="OriginalBean">MyAlias</alias>
+</deployment>
Added: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/AliasSimpleBeanImpl.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/AliasSimpleBeanImpl.java (rev 0)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/AliasSimpleBeanImpl.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,42 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2006, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+package org.jboss.test.kernel.dependency.support;
+
+import org.jboss.beans.metadata.plugins.annotations.Aliases;
+import org.jboss.beans.metadata.plugins.annotations.StringValue;
+
+/**
+ * A simple bean
+ *
+ * @author <a href="ales.justin at jboss.com">Ales Justin</a>
+ */
+ at Aliases({"MyAlias"})
+public class AliasSimpleBeanImpl extends SimpleBeanImpl
+{
+ private static final long serialVersionUID = 3258132440433243443L;
+
+ @StringValue("String1")
+ public void setString(String string)
+ {
+ super.setString(string);
+ }
+}
Modified: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/TestUtil.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/TestUtil.java 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/support/TestUtil.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -29,6 +29,7 @@
import org.jboss.kernel.plugins.deployment.xml.BasicXMLDeployer;
import org.jboss.kernel.spi.dependency.KernelController;
import org.jboss.kernel.spi.dependency.KernelControllerContext;
+import org.jboss.kernel.spi.deployment.KernelDeployment;
import org.jboss.test.kernel.AbstractKernelTest;
/**
@@ -137,10 +138,11 @@
* Deploy a url
*
* @param url the url
+ * @return KernelDeployment the deployment
* @throws Throwable for any error
*/
- public void deploy(URL url) throws Throwable
+ public KernelDeployment deploy(URL url) throws Throwable
{
- deployer.deploy(url);
+ return deployer.deploy(url);
}
}
Modified: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/DependencyTestSuite.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/DependencyTestSuite.java 2007-08-07 08:53:40 UTC (rev 64478)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/DependencyTestSuite.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -88,6 +88,9 @@
suite.addTest(FromContextTestCase.suite());
suite.addTest(FromContextXMLTestCase.suite());
suite.addTest(FromContextAnnotationTestCase.suite());
+ suite.addTest(PlainAliasTestCase.suite());
+ suite.addTest(PlainAliasXMLTestCase.suite());
+ suite.addTest(PlainAliasAnnotationTestCase.suite());
return suite;
}
}
Added: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasAnnotationTestCase.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasAnnotationTestCase.java (rev 0)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasAnnotationTestCase.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,67 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2006, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+package org.jboss.test.kernel.dependency.test;
+
+import junit.framework.Test;
+import org.jboss.beans.metadata.spi.BeanMetaData;
+import org.jboss.beans.metadata.plugins.AbstractBeanMetaData;
+import org.jboss.test.kernel.dependency.support.AliasSimpleBeanImpl;
+import org.jboss.dependency.spi.ControllerContext;
+
+/**
+ * Plain alias tests.
+ *
+ * @author <a href="mailto:ales.justin at jboss.com">Ales Justin</a>
+ */
+public class PlainAliasAnnotationTestCase extends PlainAliasTestCase
+{
+ public PlainAliasAnnotationTestCase(String name)
+ throws Throwable
+ {
+ super(name);
+ }
+
+ public static Test suite()
+ {
+ return suite(PlainAliasAnnotationTestCase.class);
+ }
+
+ protected void checkLastSimpleAliasInstall(ControllerContext context) throws Throwable
+ {
+ // do nothing
+ }
+
+ protected void buildMetaData() throws Throwable
+ {
+ setBeanMetaDatas(new BeanMetaData[]{new AbstractBeanMetaData("OriginalBean", AliasSimpleBeanImpl.class.getName())});
+ }
+
+ protected void checkDirectAlias() throws Throwable
+ {
+ // not yet registered
+ }
+
+ protected void installAlias() throws Throwable
+ {
+ // do nothing should be part of @annotations
+ }
+}
Added: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasTestCase.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasTestCase.java (rev 0)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasTestCase.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,174 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2006, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+package org.jboss.test.kernel.dependency.test;
+
+import java.util.HashSet;
+
+import junit.framework.Test;
+import org.jboss.dependency.spi.ControllerContext;
+import org.jboss.dependency.spi.ControllerState;
+import org.jboss.dependency.spi.Controller;
+import org.jboss.test.kernel.dependency.support.SimpleBean;
+import org.jboss.test.kernel.dependency.support.SimpleBeanImpl;
+import org.jboss.beans.metadata.plugins.AbstractBeanMetaData;
+import org.jboss.beans.metadata.plugins.AbstractPropertyMetaData;
+import org.jboss.beans.metadata.spi.PropertyMetaData;
+import org.jboss.beans.metadata.spi.BeanMetaData;
+
+/**
+ * Plain alias tests.
+ *
+ * @author <a href="mailto:ales.justin at jboss.com">Ales Justin</a>
+ */
+public class PlainAliasTestCase extends AbstractKernelDependencyTest
+{
+ public PlainAliasTestCase(String name)
+ throws Throwable
+ {
+ super(name);
+ }
+
+ public PlainAliasTestCase(String name, boolean xmltest)
+ throws Throwable
+ {
+ super(name, xmltest);
+ }
+
+ public static Test suite()
+ {
+ return suite(PlainAliasTestCase.class);
+ }
+
+ protected ControllerContext getAlias(String name) throws Throwable
+ {
+ installAlias();
+ return getUtil().getContext(name);
+ }
+
+ public void testPlainAliasCorrectOrder() throws Throwable
+ {
+ buildMetaData();
+
+ ControllerContext context1 = assertInstall(0, "OriginalBean");
+ ControllerContext context2 = getAlias("MyAlias");
+ assertContext("MyAlias_Alias");
+
+ SimpleBean bean1 = (SimpleBean) context1.getTarget();
+ assertNotNull(bean1);
+ assertEquals("String1", bean1.getString());
+ assertEquals(ControllerState.INSTALLED, context2.getState());
+
+ ControllerContext alias = assertContext("MyAlias");
+ assertEquals(alias, context1);
+ }
+
+ public void testPlainAliasWrongOrder() throws Throwable
+ {
+ buildMetaData();
+
+ ControllerContext context1 = getAlias("MyAlias");
+ assertNull(context1);
+
+ checkDirectAlias();
+
+ ControllerContext context2 = assertInstall(0, "OriginalBean");
+ context1 = assertContext("MyAlias");
+ assertEquals(ControllerState.INSTALLED, context1.getState());
+ getDirectAlias(ControllerState.INSTALLED);
+
+ SimpleBean bean1 = (SimpleBean) context2.getTarget();
+ assertNotNull(bean1);
+ assertEquals("String1", bean1.getString());
+
+ ControllerContext alias = assertContext("MyAlias");
+ assertEquals(alias, context1);
+ }
+
+ protected void checkDirectAlias() throws Throwable
+ {
+ getDirectAlias(ControllerState.START).getState();
+ }
+
+ protected ControllerContext getDirectAlias(ControllerState state) throws Throwable
+ {
+ return assertContext("MyAlias_Alias", state);
+ }
+
+ public void testPlainAliasReinstall() throws Throwable
+ {
+ buildMetaData();
+
+ ControllerContext context1 = assertInstall(0, "OriginalBean");
+ ControllerContext context2 = getAlias("MyAlias");
+
+ SimpleBean bean1 = (SimpleBean) context1.getTarget();
+ assertNotNull(bean1);
+ assertEquals("String1", bean1.getString());
+ assertEquals(ControllerState.INSTALLED, context2.getState());
+
+ ControllerContext alias = assertContext("MyAlias");
+ assertEquals(alias, context1);
+
+ ControllerContext directAlias = assertContext("MyAlias_Alias");
+ assertEquals(ControllerState.INSTALLED, directAlias.getState());
+
+ assertUninstall("OriginalBean");
+ assertEquals(ControllerState.ERROR, context1.getState());
+ assertEquals(ControllerState.ERROR, alias.getState());
+ assertEquals(ControllerState.START, directAlias.getState());
+ assertNull(getUtil().getContext("OriginalBean"));
+ assertNull(getUtil().getContext("MyAlias"));
+
+ context1 = assertInstall(0, "OriginalBean");
+ assertEquals(ControllerState.INSTALLED, directAlias.getState());
+ assertEquals(context1, assertContext("MyAlias"));
+
+ assertUninstall("MyAlias_Alias");
+ assertEquals(ControllerState.ERROR, directAlias.getState());
+ assertEquals(ControllerState.INSTALLED, context1.getState());
+ assertNull(getUtil().getContext("MyAlias"));
+
+ checkLastSimpleAliasInstall(context1);
+ }
+
+ protected void checkLastSimpleAliasInstall(ControllerContext context) throws Throwable
+ {
+ installAlias();
+ assertEquals(context, assertContext("MyAlias"));
+ }
+
+ protected void buildMetaData() throws Throwable
+ {
+ AbstractBeanMetaData metaData1 = new AbstractBeanMetaData("OriginalBean", SimpleBeanImpl.class.getName());
+ HashSet<PropertyMetaData> attributes1 = new HashSet<PropertyMetaData>();
+ attributes1.add(new AbstractPropertyMetaData("string", "String1"));
+ metaData1.setProperties(attributes1);
+ setBeanMetaDatas(new BeanMetaData[]{metaData1});
+ }
+
+ protected void installAlias()
+ throws Throwable
+ {
+ Controller controller = getUtil().getKernel().getController();
+ controller.addAlias("MyAlias", "OriginalBean");
+ }
+}
Added: projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase.java
===================================================================
--- projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase.java (rev 0)
+++ projects/microcontainer/trunk/kernel/src/tests/org/jboss/test/kernel/dependency/test/PlainAliasXMLTestCase.java 2007-08-07 10:09:55 UTC (rev 64479)
@@ -0,0 +1,67 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2006, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+package org.jboss.test.kernel.dependency.test;
+
+import java.net.URL;
+import java.util.Set;
+
+import junit.framework.Test;
+import org.jboss.kernel.spi.deployment.KernelDeployment;
+import org.jboss.dependency.spi.Controller;
+import org.jboss.beans.metadata.spi.NamedAliasMetaData;
+
+/**
+ * Plain alias tests.
+ *
+ * @author <a href="mailto:ales.justin at jboss.com">Ales Justin</a>
+ */
+public class PlainAliasXMLTestCase extends PlainAliasTestCase
+{
+ public PlainAliasXMLTestCase(String name)
+ throws Throwable
+ {
+ super(name, true);
+ }
+
+ public static Test suite()
+ {
+ return suite(PlainAliasXMLTestCase.class);
+ }
+
+ protected void installAlias() throws Throwable
+ {
+ String url = getClass().getSimpleName() + "_Alias.xml";
+ URL resource = getResource(url);
+ if (resource == null)
+ throw new IllegalArgumentException("Null resource: " + url);
+ KernelDeployment deployment = getUtil().deploy(resource);
+ Set<NamedAliasMetaData> aliases = deployment.getAliases();
+ if (aliases != null && aliases.isEmpty() == false)
+ {
+ Controller controller = getUtil().getKernel().getController();
+ for (NamedAliasMetaData namd : aliases)
+ {
+ controller.addAlias(namd.getAliasValue(), namd.getName());
+ }
+ }
+ }
+}
More information about the jboss-cvs-commits
mailing list