Menu
▾
▴
[jboss-cvs] jboss-spring/src/resources/test/docs ...
|
From: Ales J. <ale...@ge...> - 2006-07-09 13:18:55
|
User: alesj Date: 06/07/09 09:18:49 Modified: src/resources/test/docs JBoss-Spring-Example.html Log: Reformat code + Spring-MC fix. Revision Changes Path 1.2 +645 -219 jboss-spring/src/resources/test/docs/JBoss-Spring-Example.html (In the diff below, changes in quantity of whitespace are not shown.) Index: JBoss-Spring-Example.html =================================================================== RCS file: /cvsroot/jboss/jboss-spring/src/resources/test/docs/JBoss-Spring-Example.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -b -r1.1 -r1.2 --- JBoss-Spring-Example.html 23 Aug 2005 18:22:27 -0000 1.1 +++ JBoss-Spring-Example.html 9 Jul 2006 13:18:49 -0000 1.2 @@ -1,6 +1,6 @@ <html xmlns:o="urn:schemas-microsoft-com:office:office" -xmlns:w="urn:schemas-microsoft-com:office:word" -xmlns="http://www.w3.org/TR/REC-html40"> + xmlns:w="urn:schemas-microsoft-com:office:word" + xmlns="http://www.w3.org/TR/REC-html40"> <head> <meta http-equiv=Content-Type content="text/html; charset=windows-1252"> @@ -11,8 +11,8 @@ <title>JBoss + Spring example:</title> <!--[if gte mso 9]><xml> <o:DocumentProperties> - <o:Author>Ale Justin</o:Author> - <o:LastAuthor>Ale Justin</o:LastAuthor> + <o:Author>Ale� Justin</o:Author> + <o:LastAuthor>Ale� Justin</o:LastAuthor> <o:Revision>2</o:Revision> <o:TotalTime>263</o:TotalTime> <o:Created>2005-08-10T12:16:00Z</o:Created> @@ -40,164 +40,580 @@ </xml><![endif]--> <style> <!-- - /* Style Definitions */ - p.MsoNormal, li.MsoNormal, div.MsoNormal - {mso-style-parent:""; - margin:0cm; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:12.0pt; - font-family:"Times New Roman"; - mso-fareast-font-family:"Times New Roman";} -h2 - {mso-style-next:Normal; - margin-top:12.0pt; - margin-right:0cm; - margin-bottom:3.0pt; - margin-left:0cm; - mso-pagination:widow-orphan; - page-break-after:avoid; - mso-outline-level:2; - font-size:14.0pt; - font-family:Arial; - font-style:italic;} -a:link, span.MsoHyperlink - {color:blue; - text-decoration:underline; - text-underline:single;} -a:visited, span.MsoHyperlinkFollowed - {color:purple; - text-decoration:underline; - text-underline:single;} -pre - {margin:0cm; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - tab-stops:36.0pt; - font-size:10.0pt; - font-family:"Courier New"; - mso-fareast-font-family:"Times New Roman";} -span.GramE - {mso-style-name:""; - mso-gram-e:yes;} -@page Section1 - {size:612.0pt 792.0pt; - margin:72.0pt 90.0pt 72.0pt 90.0pt; - mso-header-margin:35.4pt; - mso-footer-margin:35.4pt; - mso-paper-source:0;} -div.Section1 - {page:Section1;} - /* List Definitions */ - @list l0 - {mso-list-id:-132; - mso-list-type:simple; - mso-list-template-ids:1016904304;} -@list l0:level1 - {mso-level-tab-stop:74.6pt; - mso-level-number-position:left; - margin-left:74.6pt; - text-indent:-18.0pt;} -@list l1 - {mso-list-id:-131; - mso-list-type:simple; - mso-list-template-ids:1933872080;} -@list l1:level1 - {mso-level-tab-stop:60.45pt; - mso-level-number-position:left; - margin-left:60.45pt; - text-indent:-18.0pt;} -@list l2 - {mso-list-id:-130; - mso-list-type:simple; - mso-list-template-ids:1828635132;} -@list l2:level1 - {mso-level-tab-stop:46.3pt; - mso-level-number-position:left; - margin-left:46.3pt; - text-indent:-18.0pt;} -@list l3 - {mso-list-id:-129; - mso-list-type:simple; - mso-list-template-ids:-1641540048;} -@list l3:level1 - {mso-level-tab-stop:32.15pt; - mso-level-number-position:left; - margin-left:32.15pt; - text-indent:-18.0pt;} -@list l4 - {mso-list-id:-128; - mso-list-type:simple; - mso-list-template-ids:2112010756;} -@list l4:level1 - {mso-level-number-format:bullet; - mso-level-text:\F0B7; - mso-level-tab-stop:74.6pt; - mso-level-number-position:left; - margin-left:74.6pt; - text-indent:-18.0pt; - font-family:Symbol;} -@list l5 - {mso-list-id:-127; - mso-list-type:simple; - mso-list-template-ids:-1777165296;} -@list l5:level1 - {mso-level-number-format:bullet; - mso-level-text:\F0B7; - mso-level-tab-stop:60.45pt; - mso-level-number-position:left; - margin-left:60.45pt; - text-indent:-18.0pt; - font-family:Symbol;} -@list l6 - {mso-list-id:-126; - mso-list-type:simple; - mso-list-template-ids:1029624058;} -@list l6:level1 - {mso-level-number-format:bullet; - mso-level-text:\F0B7; - mso-level-tab-stop:46.3pt; - mso-level-number-position:left; - margin-left:46.3pt; - text-indent:-18.0pt; - font-family:Symbol;} -@list l7 - {mso-list-id:-125; - mso-list-type:simple; - mso-list-template-ids:-563021474;} -@list l7:level1 - {mso-level-number-format:bullet; - mso-level-text:\F0B7; - mso-level-tab-stop:32.15pt; - mso-level-number-position:left; - margin-left:32.15pt; - text-indent:-18.0pt; - font-family:Symbol;} -@list l8 - {mso-list-id:-120; - mso-list-type:simple; - mso-list-template-ids:-799663524;} -@list l8:level1 - {mso-level-tab-stop:18.0pt; - mso-level-number-position:left; - margin-left:18.0pt; - text-indent:-18.0pt;} -@list l9 - {mso-list-id:-119; - mso-list-type:simple; - mso-list-template-ids:-1707604292;} -@list l9:level1 - {mso-level-number-format:bullet; - mso-level-text:\F0B7; - mso-level-tab-stop:18.0pt; - mso-level-number-position:left; - margin-left:18.0pt; - text-indent:-18.0pt; - font-family:Symbol;} -ol - {margin-bottom:0cm;} -ul - {margin-bottom:0cm;} +/* Style Definitions */ +p.MsoNormal, li.MsoNormal, div.MsoNormal { + mso-style-parent: ""; + margin: 0cm; + margin-bottom: .0001pt; + mso-pagination: widow-orphan; + font-size: 12.0pt; + font-family: "Times New Roman"; + mso-fareast-font-family: "Times New Roman"; +} + +h2 { + mso-style-next: Normal; + margin-top: 12.0pt; + margin-right: 0cm; + margin-bottom: 3.0pt; + margin-left: 0cm; + mso-pagination: widow-orphan; + page-break-after: avoid; + mso-outline-level: 2; + font-size: 14.0pt; + font-family: Arial; + font-style: italic; +} + +a:link, span.MsoHyperlink { + color: blue; + text-decoration: underline; + text-underline: single; +} + +a:visited, span.MsoHyperlinkFollowed { + color: purple; + text-decoration: underline; + text-underline: single; +} + +pre { + margin: 0cm; + margin-bottom: .0001pt; + mso-pagination: widow-orphan; + tab-stops: 36.0pt; + font-size: 10.0pt; + font-family: "Courier New"; + mso-fareast-font-family: "Times New Roman"; +} + +span.GramE { + mso-style-name: ""; + mso-gram-e: yes; +} + +@page +Section1 +{ + size: 612.0pt 792.0pt +; + margin: 72.0pt 90.0pt 72.0pt 90.0pt +; + mso-header-margin: 35.4pt +; + mso-footer-margin: 35.4pt +; + mso-paper-source: 0 +; +} +div.Section1 { + page: Section1; +} + +/* List Definitions */ +@list +l0 +{ +mso-list-id +: +- +132 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +1016904304 +; +} +@list +l0 +: +level1 +{ +mso-level-tab-stop +: +74.6 +pt +; +mso-level-number-position +: +left +; +margin-left +: +74.6 +pt +; +text-indent +: +- +18.0 +pt +; +} +@list +l1 +{ +mso-list-id +: +- +131 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +1933872080 +; +} +@list +l1 +: +level1 +{ +mso-level-tab-stop +: +60.45 +pt +; +mso-level-number-position +: +left +; +margin-left +: +60.45 +pt +; +text-indent +: +- +18.0 +pt +; +} +@list +l2 +{ +mso-list-id +: +- +130 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +1828635132 +; +} +@list +l2 +: +level1 +{ +mso-level-tab-stop +: +46.3 +pt +; +mso-level-number-position +: +left +; +margin-left +: +46.3 +pt +; +text-indent +: +- +18.0 +pt +; +} +@list +l3 +{ +mso-list-id +: +- +129 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +- +1641540048 +; +} +@list +l3 +: +level1 +{ +mso-level-tab-stop +: +32.15 +pt +; +mso-level-number-position +: +left +; +margin-left +: +32.15 +pt +; +text-indent +: +- +18.0 +pt +; +} +@list +l4 +{ +mso-list-id +: +- +128 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +2112010756 +; +} +@list +l4 +: +level1 +{ +mso-level-number-format +: +bullet +; +mso-level-text +: +\F0B7 +; +mso-level-tab-stop +: +74.6 +pt +; +mso-level-number-position +: +left +; +margin-left +: +74.6 +pt +; +text-indent +: +- +18.0 +pt +; +font-family +: +Symbol +; +} +@list +l5 +{ +mso-list-id +: +- +127 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +- +1777165296 +; +} +@list +l5 +: +level1 +{ +mso-level-number-format +: +bullet +; +mso-level-text +: +\F0B7 +; +mso-level-tab-stop +: +60.45 +pt +; +mso-level-number-position +: +left +; +margin-left +: +60.45 +pt +; +text-indent +: +- +18.0 +pt +; +font-family +: +Symbol +; +} +@list +l6 +{ +mso-list-id +: +- +126 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +1029624058 +; +} +@list +l6 +: +level1 +{ +mso-level-number-format +: +bullet +; +mso-level-text +: +\F0B7 +; +mso-level-tab-stop +: +46.3 +pt +; +mso-level-number-position +: +left +; +margin-left +: +46.3 +pt +; +text-indent +: +- +18.0 +pt +; +font-family +: +Symbol +; +} +@list +l7 +{ +mso-list-id +: +- +125 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +- +563021474 +; +} +@list +l7 +: +level1 +{ +mso-level-number-format +: +bullet +; +mso-level-text +: +\F0B7 +; +mso-level-tab-stop +: +32.15 +pt +; +mso-level-number-position +: +left +; +margin-left +: +32.15 +pt +; +text-indent +: +- +18.0 +pt +; +font-family +: +Symbol +; +} +@list +l8 +{ +mso-list-id +: +- +120 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +- +799663524 +; +} +@list +l8 +: +level1 +{ +mso-level-tab-stop +: +18.0 +pt +; +mso-level-number-position +: +left +; +margin-left +: +18.0 +pt +; +text-indent +: +- +18.0 +pt +; +} +@list +l9 +{ +mso-list-id +: +- +119 +; +mso-list-type +: +simple +; +mso-list-template-ids +: +- +1707604292 +; +} +@list +l9 +: +level1 +{ +mso-level-number-format +: +bullet +; +mso-level-text +: +\F0B7 +; +mso-level-tab-stop +: +18.0 +pt +; +mso-level-number-position +: +left +; +margin-left +: +18.0 +pt +; +text-indent +: +- +18.0 +pt +; +font-family +: +Symbol +; +} +ol { + margin-bottom: 0cm; +} + +ul { + margin-bottom: 0cm; +} + --> </style> <!--[if gte mso 10]> @@ -228,38 +644,45 @@ <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>The source shows how simple it is to inject <span -class=GramE>Spring</span> managed fine grained POJO beans into EJB components.</p> + class=GramE>Spring</span> managed fine grained POJO beans into EJB components.</p> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>First make sure that you have <span class=GramE>Spring</span> -deployer in your JBOSS_HOME/server/default/deploy directory. That should be -jboss-spring-jdk5.deployer directory with three jars and META-INF directory -inside (jboss-spring-jdk5.jar, spring-beans.jar, spring-core.jar and -META-INF/jboss-service.xml).</p> + deployer in your JBOSS_HOME/server/default/deploy directory. That should be + jboss-spring-jdk5.deployer directory with three jars and META-INF directory + inside (jboss-spring-jdk5.jar, spring-beans.jar, spring-core.jar and + META-INF/jboss-service.xml).</p> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>Since our code is dependant on <span class=GramE>Spring</span> -library, we must make sure that all of the needed classes are in our classpath. -Copy spring-aop.jar, spring-context.jar, spring-web.jar and spring-webmvc.jar -into JBOSS_HOME/server/default/lib directory.</p> + library, we must make sure that all of the needed classes are in our classpath. + Copy spring-aop.jar, spring-context.jar, spring-web.jar and spring-webmvc.jar + into JBOSS_HOME/server/default/lib directory.</p> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>Fix ejb3-interceptors-aop.xml in your JBOSS_HOME/server/default/deploy -directory:</p> + directory:</p> <p class=MsoNormal><o:p> </o:p></p> -<pre><span style='mso-spacerun:yes'> </span><interceptor class="org.jboss.ejb3.AllowedOperationsInterceptor" scope="PER_VM"/></pre><pre><o:p> </o:p></pre><pre><b -style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'> </span><interceptor class="org.jboss.spring.interceptor.SpringInjectionInterceptor" scope="PER_VM"/><o:p></o:p></b></pre><pre><o:p> </o:p></pre><pre><span style='mso-spacerun:yes'> </span><typedef name="ejb3intercepted" expr="<span -class=GramE>class(</span>@javax.ejb.Interceptors) OR class(@javax.ejb.Interceptor) OR has(* *->@javax.ejb.AroundInvoke(..))"/></pre><pre><o:p> </o:p></pre><pre><span style='mso-spacerun:yes'> </span><domain name="Stateless Bean"></pre><pre><b -style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'> </span><bind pointcut="<span -class=GramE>execution(</span>*->new(..))"><o:p></o:p></b></pre><pre><b -style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'> </span><<span -class=GramE>interceptor-ref</span> name="org.jboss.spring.interceptor.SpringInjectionInterceptor"/><o:p></o:p></b></pre><pre><b -style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'> </span></bind><o:p></o:p></b></pre> +<pre><span style='mso-spacerun:yes'>�� </span><interceptor class="org.jboss.ejb3.AllowedOperationsInterceptor" + scope="PER_VM"/></pre><pre><o:p> </o:p></pre><pre><b + style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'>�� </span><interceptor class="org.jboss.spring.interceptor.SpringInjectionInterceptor" + scope="PER_VM"/><o:p></o:p></b></pre><pre><o:p> </o:p></pre><pre><span + style='mso-spacerun:yes'>�� </span><typedef name="ejb3intercepted" expr="<span + class=GramE>class(</span>@javax.ejb.Interceptors) OR class(@javax.ejb.Interceptor) OR has(* *->@javax.ejb.AroundInvoke(..))"/> +</pre><pre><o:p> </o:p></pre><pre><span style='mso-spacerun:yes'>�� </span><domain name="Stateless Bean"> +</pre><pre><b + style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'>����� </span><bind pointcut="<span + class=GramE>execution(</span>*->new(..))"><o:p></o:p></b></pre><pre><b + style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'>�������� </span><<span + class=GramE>interceptor-ref</span> name="org.jboss.spring.interceptor.SpringInjectionInterceptor"/> + <o:p></o:p></b></pre><pre><b + style='mso-bidi-font-weight:normal'><span style='mso-spacerun:yes'>����� </span></bind><o:p></o:p></b> +</pre> <p class=MsoNormal><b style='mso-bidi-font-weight:normal'><o:p> </o:p></b></p> @@ -268,78 +691,81 @@ <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>Looking at the source code you will see that our -RandomizerBean class is declared as @Stateless session bean. The pointcut above -will pick up our stateless session bean at instantiation time and perform <span -class=GramE>Spring</span> injection interception.</p> + RandomizerBean class is declared as @Stateless session bean. The pointcut above + will pick up our stateless session bean at instantiation time and perform <span + class=GramE>Spring</span> injection interception.</p> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>The second example from source code shows how we can do <span -class=GramE>Spring</span> bean injection in a <b style='mso-bidi-font-weight: + class=GramE>Spring</span> bean injection in a <b style='mso-bidi-font-weight: normal'>non</b> AOP way. Look at the HoroscopeBean class which has a @CallbackListener -annotation with the value SpringCallbackListener.class. Read the EJB3Trail -applications documentation (<a -href="http://trailblazer.demo.jboss.com/EJB3Trail/serviceobjects/lifecycle/index.html">http://trailblazer.demo.jboss.com/EJB3Trail/serviceobjects/lifecycle/index.html</a>) -on how callback listeners are used.</p> + annotation with the value SpringCallbackListener.class. Read the EJB3Trail + application�s documentation (<a + href="http://trailblazer.demo.jboss.com/EJB3Trail/serviceobjects/lifecycle/index.html">http://trailblazer.demo.jboss.com/EJB3Trail/serviceobjects/lifecycle/index.html</a>) + on how callback listeners are used.</p> <p class=MsoNormal><o:p> </o:p></p> -<p class=MsoNormal>Now you are all set to go. Unzip examples archive into -APP_HOME. Run Ants build script (APP_HOME/build.bat in Windows or -APP_HOME/build.sh in Linux/Unix). Run default JBoss server (JBOSS_HOME/bin run). -Drop JBoss-Spring.ear from APP_HOME/build/jar into JBOSS_HOME/server/default/deploy. -The <span class=GramE>Spring</span> injection should take place the moment you -will click on the applications web page (<a -href="http://localhost:8080/jboss-spring">http://localhost:8080/jboss-spring</a>).</p> +<p class=MsoNormal>Now you are all set to go. Unzip example�s archive into + APP_HOME. Run Ant�s build script (APP_HOME/build.bat in Windows or + APP_HOME/build.sh in Linux/Unix). Run default JBoss server (JBOSS_HOME/bin run). + Drop JBoss-Spring.ear from APP_HOME/build/jar into JBOSS_HOME/server/default/deploy. + The <span class=GramE>Spring</span> injection should take place the moment you + will click on the application�s web page (<a + href="http://localhost:8080/jboss-spring">http://localhost:8080/jboss-spring</a>).</p> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>Our <span class=GramE>Spring</span> deployer watches for the -Spring components which should have the following suffixes: .spring for archive -or spring.xml for the beans descriptor. Spring beans descriptor inside archive -is expected to be in META-INF directory by the name jboss-spring.xml.</p> + Spring components which should have the following suffixes: .spring for archive + or �spring.xml for the beans descriptor. Spring beans descriptor inside archive + is expected to be in META-INF directory by the name jboss-spring.xml.</p> <p class=MsoNormal><o:p> </o:p></p> -<p class=MsoNormal>By default our bean factorys JNDI name equals <span -class=GramE>Spring</span> components name: <name>.spring or -<name>-spring.xml. It can be overridden inside beans descriptor -description tag. You can also set parent bean factory JNDI name:</p> +<p class=MsoNormal>By default our bean factory�s JNDI name equals <span + class=GramE>Spring</span> components name: <name>.spring or + <name>-spring.xml. It can be overridden inside beans descriptor + description tag. You can also set parent bean factory JNDI name:</p> <p class=MsoNormal><o:p> </o:p></p> -<pre><<span class=GramE>beans</span>></pre><pre><o:p> </o:p></pre><pre><span style='mso-spacerun:yes'> </span><<span -class=GramE>description></span>BeanFactory=(<name>) ParentBeanFactory=(<parent name>)</description></pre><pre><o:p> </o:p></pre> +<pre><<span class=GramE>beans</span>></pre><pre><o:p> </o:p></pre><pre><span + style='mso-spacerun:yes'>��� </span><<span + class=GramE>description></span>BeanFactory=(<name>) ParentBeanFactory=(<parent name>)</description> +</pre><pre><o:p> </o:p></pre> <p class=MsoNormal>There are different ways to deploy your <span class=GramE>Spring</span> -beans. One with .ear file we just saw. But you can also deploy only your <span -class=GramE>Spring</span> beans and let them be used by different applications. -Instead of droping the whole .ear, you can just deploy .spring archive file or -only beans descriptor. In descriptors case, its name must end with spring.xml -and, as expected, all the classes must already be made available on the -classpath to the descriptor.</p> + beans. One with .ear file we just saw. But you can also deploy only your <span + class=GramE>Spring</span> beans and let them be used by different applications. + Instead of droping the whole .ear, you can just deploy .spring archive file or + only beans descriptor. In descriptor�s case, its name must end with �spring.xml + and, as expected, all the classes must already be made available on the + classpath to the descriptor.</p> <p class=MsoNormal><o:p> </o:p></p> -<p class=MsoNormal>Lets look this on the example. Just drop spring-pojo.spring -file from APP_HOME/build/jar into JBOSS_HOME/server/default/<span class=GramE>deploy -.</span> As before, bean factory with JNDI name spring-pojo gets deployed. -You can now include this bean factory by setting its name as the parent bean -factory name in your new beans factory xml descriptor:</p> +<p class=MsoNormal>Let�s look this on the example. Just drop spring-pojo.spring + file from APP_HOME/build/jar into JBOSS_HOME/server/default/<span class=GramE>deploy +.</span> As before, bean factory with JNDI name �spring-pojo� gets deployed. + You can now include this bean factory by setting its name as the parent bean + factory name in your new beans factory xml descriptor:</p> <p class=MsoNormal><o:p> </o:p></p> -<pre><<span class=GramE>beans</span>></pre><pre><o:p> </o:p></pre><pre> <span style='mso-spacerun:yes'> </span><<span -class=GramE>description></span>ParentBeanFactory=(spring-pojo)</description></pre> +<pre><<span class=GramE>beans</span>></pre><pre><o:p> </o:p></pre><pre><span + style='mso-spacerun:yes'>���</span><<span + class=GramE>description></span>ParentBeanFactory=(spring-pojo)</description></pre> <p class=MsoNormal><o:p> </o:p></p> <p class=MsoNormal>When undeploying single files, be careful of the order of -undeploying take notice of bean factory hierarchy.</p> + undeploying � take notice of bean factory hierarchy.</p> <p class=MsoNormal>When shutting down application server, the <span -class=GramE>Spring</span> deployer will take care of correct undeployment -order.</p> + class=GramE>Spring</span> deployer will take care of correct undeployment + order.</p> </div> |
