Author: pete.muir(a)jboss.org Date: 2008-12-19 13:33:45 -0500 (Fri, 19 Dec 2008) New Revision: 595 Added: doc/trunk/reference/en/modules/ri.xml Modified: doc/trunk/reference/ doc/trunk/reference/en/master.xml doc/trunk/reference/en/modules/intro.xml Log: Move RI to it's own chapter, update for new location of jboss installer Property changes on: doc/trunk/reference ___________________________________________________________________ Name: svn:ignore - target .project + target .project webbeans_reference.pdf Modified: doc/trunk/reference/en/master.xml =================================================================== --- doc/trunk/reference/en/master.xml 2008-12-19 18:32:52 UTC (rev 594) +++ doc/trunk/reference/en/master.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -36,6 +36,7 @@ <xi:include href="modules/part1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/intro.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="modules/ri.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/example.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/injection.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="modules/scopescontexts.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> Modified: doc/trunk/reference/en/modules/intro.xml =================================================================== --- doc/trunk/reference/en/modules/intro.xml 2008-12-19 18:32:52 UTC (rev 594) +++ doc/trunk/reference/en/modules/intro.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -535,134 +535,4 @@ </section> -<section> - <title>Using the Web Beans Reference Implementation</title> - - <para> - The Web Beans RI comes with a two examples, - <literal>webbeans-numberguess</literal> (a war example, containing only - simple beans) and <literal>webbeans-translator</literal> (an ear example, - containing enterprise beans). - </para> - - <para> - Currently, the Web Beans RI only runs on JBoss Application Server 5. - You'll need to download JBoss AS 5.0.0.GA from - <ulink url="http://www.jboss.org/jbossas/downloads/">jboss.org</...;, - and unzip it. For example: - </para> - - <programlisting><![CDATA[$ cd /Applications -$ unzip ~/jboss-5.0.0.GA.zip]]></programlisting> - - <para> - Next, download the Web Beans RI from - <ulink url="http://seamframework.org/WebBeans">seamframework.org<...;, - and unzip it. For example - </para> - - <programlisting><![CDATA[$ cd ~/ -$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]></programlisting> - - <para> - As Web Beans is a new piece of software, you need to update JBoss AS to - run the Web Beans RI. Future versions of JBoss AS will include these - updates, and this step won't be necessary. - </para> - - <note> - <para> - Currently, two updates are needed. Firstly, a new deployer, - <literal>webbeans.deployer</literal> is added. This adds supports for - Web Bean archives to JBoss AS, and allows the Web Beans RI to query the - EJB3 container and discover which EJBs are installed in your - application. Secondly, an update to JBoss EJB3 is needed. - </para> - </note> - - <para> - To install the update, you'll need ant 1.7.0 installed, and the - <literal>ANT_HOME</literal> environment variable set. For example: - </para> - - <programlisting>$ unzip apache-ant-1.7.0.zip -$ export ANT_HOME=~/apache-ant-1.7.0</programlisting> - - <para> - Then, you can install the update. The update script will use Maven to - download the Web Beans and EJB3 automatically. - </para> - - <programlisting>$ cd webbeans-1.0.0.ALPHA1 -$ ant install-jboss5-update</programlisting> - - <para> - Now, you're ready to deploy your first example! - </para> - - <note> - <para> - The build scripts for the examples offer a number of targets, these - are: - </para> - <itemizedlist> - <listitem> - <para> - <literal>ant restart</literal> - deploy the example in exploded - format - </para> - </listitem> - <listitem> - <para> - <literal>ant explode</literal> - update an exploded example, without - restarting the deployment - </para> - </listitem> - <listitem> - <para> - <literal>ant deploy</literal> - deploy the example in compressed jar format - </para> - </listitem> - <listitem> - <para> - <literal>ant undeploy</literal> - remove the example from the server - </para> - </listitem> - <listitem> - <para> - <literal>ant clean</literal> - clean the example - </para> - </listitem> - </itemizedlist> - </note> - - <para> - To deploy the numberguess example: - </para> - - <programlisting>$ cd examples/numberguess -ant deploy</programlisting> - - <para> - Wait for the application to deploy, and enjoy hours of fun at - <ulink url="http://localhost:8080/webbeans-numberguess" />! - </para> - - <para> - The Web Beans RI includes a second simple example that will translate your text - into Latin. The numberguess example is a war example, and uses only simple - beans; the translator example is an ear example, and includes enterprise - beans, packaged in an EJB module. To try it out: - </para> - - <programlisting>$ cd examples/traslator -ant deploy</programlisting> - - <para> - Wait for the application to deploy, and visit - <ulink url="http://localhost:8080/webbeans-translator" />! - </para> - -</section> - </chapter> \ No newline at end of file Added: doc/trunk/reference/en/modules/ri.xml =================================================================== --- doc/trunk/reference/en/modules/ri.xml (rev 0) +++ doc/trunk/reference/en/modules/ri.xml 2008-12-19 18:33:45 UTC (rev 595) @@ -0,0 +1,131 @@ +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ ]> + +<chapter id="ri"> + <title>Using the Web Beans Reference Implementation</title> + + <para> + The Web Beans RI comes with a two examples, + <literal>webbeans-numberguess</literal> (a war example, containing only + simple beans) and <literal>webbeans-translator</literal> (an ear example, + containing enterprise beans). + </para> + + <para> + Currently, the Web Beans RI only runs on JBoss Application Server 5. + You'll need to download JBoss AS 5.0.0.GA from + <ulink url="http://www.jboss.org/jbossas/downloads/">jboss.org</...;, + and unzip it. For example: + </para> + + <programlisting><![CDATA[$ cd /Applications +$ unzip ~/jboss-5.0.0.GA.zip]]></programlisting> + + <para> + Next, download the Web Beans RI from + <ulink url="http://seamframework.org/WebBeans">seamframework.org<...;, + and unzip it. For example + </para> + + <programlisting><![CDATA[$ cd ~/ +$ unzip ~/webbeans-1.0.0.ALPHA1.zip]]></programlisting> + + <para> + As Web Beans is a new piece of software, you need to update JBoss AS to + run the Web Beans RI. Future versions of JBoss AS will include these + updates, and this step won't be necessary. + </para> + + <note> + <para> + Currently, two updates are needed. Firstly, a new deployer, + <literal>webbeans.deployer</literal> is added. This adds supports for + Web Bean archives to JBoss AS, and allows the Web Beans RI to query the + EJB3 container and discover which EJBs are installed in your + application. Secondly, an update to JBoss EJB3 is needed. + </para> + </note> + + <para> + To install the update, you'll need ant 1.7.0 installed, and the + <literal>ANT_HOME</literal> environment variable set. For example: + </para> + + <programlisting>$ unzip apache-ant-1.7.0.zip +$ export ANT_HOME=~/apache-ant-1.7.0</programlisting> + + <para> + Then, you can install the update. The update script will use Maven to + download the Web Beans and EJB3 automatically. + </para> + + <programlisting>$ cd webbeans-1.0.0.ALPHA1/jboss-as +$ ant update</programlisting> + + <para> + Now, you're ready to deploy your first example! + </para> + + <note> + <para> + The build scripts for the examples offer a number of targets, these + are: + </para> + <itemizedlist> + <listitem> + <para> + <literal>ant restart</literal> - deploy the example in exploded + format + </para> + </listitem> + <listitem> + <para> + <literal>ant explode</literal> - update an exploded example, without + restarting the deployment + </para> + </listitem> + <listitem> + <para> + <literal>ant deploy</literal> - deploy the example in compressed jar format + </para> + </listitem> + <listitem> + <para> + <literal>ant undeploy</literal> - remove the example from the server + </para> + </listitem> + <listitem> + <para> + <literal>ant clean</literal> - clean the example + </para> + </listitem> + </itemizedlist> + </note> + + <para> + To deploy the numberguess example: + </para> + + <programlisting>$ cd examples/numberguess +ant deploy</programlisting> + + <para> + Wait for the application to deploy, and enjoy hours of fun at + <ulink url="http://localhost:8080/webbeans-numberguess" />! + </para> + + <para> + The Web Beans RI includes a second simple example that will translate your text + into Latin. The numberguess example is a war example, and uses only simple + beans; the translator example is an ear example, and includes enterprise + beans, packaged in an EJB module. To try it out: + </para> + + <programlisting>$ cd examples/traslator +ant deploy</programlisting> + + <para> + Wait for the application to deploy, and visit + <ulink url="http://localhost:8080/webbeans-translator" />! + </para> + +</chapter> \ No newline at end of file Property changes on: doc/trunk/reference/en/modules/ri.xml ___________________________________________________________________ Name: svn:mime-type + text/plain