[seam-commits] Seam SVN: r10208 - in branches/enterprise/JBPAPP_4_3_FP01: doc/Seam_Reference_Guide/en-US and 1 other directory.
seam-commits at lists.jboss.org
seam-commits at lists.jboss.org
Tue Mar 24 10:28:11 EDT 2009
Author: manaRH
Date: 2009-03-24 10:28:11 -0400 (Tue, 24 Mar 2009)
New Revision: 10208
Removed:
branches/enterprise/JBPAPP_4_3_FP01/readme.txt
Modified:
branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Configuration.xml
branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/I18n.xml
branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Preface.xml
branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Tutorial.xml
Log:
JBPAPP-1769
Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Configuration.xml
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Configuration.xml 2009-03-24 14:05:09 UTC (rev 10207)
+++ branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Configuration.xml 2009-03-24 14:28:11 UTC (rev 10208)
@@ -665,7 +665,7 @@
register.jsp
...]]></programlisting>
- <para> If we want to deploy Hibernate in a non-EE environment like Tomcat or TestNG, we need to do a little
+ <para> If we want to deploy Hibernate in a non-EE environment like TestNG, we need to do a little
bit more work. </para>
</sect2>
@@ -685,142 +685,9 @@
<programlisting role="XML"><![CDATA[<transaction:hibernate-transaction session="#{session}"/>]]></programlisting>
<para> Of course, you'll also need to define a datasource.</para>
-
- <para> A better alternative is to use JBoss Embedded to get access to the EE APIs. </para>
-
</sect1>
<sect1>
- <title>Configuring Seam in Java SE, with JBoss Embedded</title>
-
- <para> JBoss Embedded lets you run EJB3 components outside the context of the Java EE 5 application server. This
- is especially, but not only, useful for testing. </para>
-
- <para> The Seam booking example application includes a TestNG integration test suite that runs on JBoss Embedded
- via <literal>SeamTest</literal>. </para>
-
- <mediaobject>
- <imageobject role="fo">
- <imagedata fileref="images/testng.png" align="center"/>
- </imageobject>
- <imageobject role="html">
- <imagedata fileref="images/testng.png" align="center"/>
- </imageobject>
- </mediaobject>
-
- <para> The booking example application may even be deployed to Tomcat. </para>
-
- <mediaobject>
- <imageobject role="fo">
- <imagedata fileref="images/e-ejb3.png" align="center"/>
- </imageobject>
- <imageobject role="html">
- <imagedata fileref="images/e-ejb3.png" align="center"/>
- </imageobject>
- </mediaobject>
-
- <sect2 id="config.install.embedded">
- <title>Installing Embedded JBoss</title>
-
-
- <para>
- Embedded JBoss must by installed into Tomcat for Seam applications
- to run correctly on it. Embedded JBoss only runs on JDK 1.5 (not JDK 1.6).
- Embedded JBoss can be downloaded
- <ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_id=228977">here</ulink>.
- The process for installing Embedded JBoss into Tomcat 6 is quite
- simple. First, you should copy the Embedded JBoss JARs and
- configuration files into Tomcat.
- </para>
-
- <itemizedlist>
-
- <listitem>
- <para> Copy all files and directories under the Embedded JBoss <literal>bootstrap</literal> and
- <literal>lib</literal> directories, except for the <literal>jndi.properties</literal> file,
- into the Tomcat <literal>lib</literal> directory. </para>
- </listitem>
-
-
- <listitem>
- <para>Remove the <literal>annotations-api.jar</literal> file from the Tomcat <literal>lib</literal>
- directory. </para>
- </listitem>
- </itemizedlist>
-
-
- <para>Next, two configuration files need to be updated to add Embedded JBoss-specific functionality.</para>
-
- <itemizedlist>
-
-
- <listitem>
- <para> Add the Embedded JBoss listener to <literal>conf/server.xml</literal>. It should appear after
- all other listeners in the file.</para>
-
- <programlisting role="XML"><![CDATA[<Listener className="org.jboss.embedded.tomcat.EmbeddedJBossBootstrapListener"/>]]></programlisting>
- </listitem>
-
- <listitem>
- <para>WAR file scanning should be enabled by adding a listener to
- <literal>conf/context.xml</literal>. </para>
-
- <programlisting role="XML"><![CDATA[<Listener className="org.jboss.embedded.tomcat.WebinfScanner"/>]]></programlisting>
- </listitem>
- </itemizedlist>
-
- <para>For more configuration options, please see the Embedded JBoss Tomcat integration
- <ulink url="http://wiki.jboss.org/wiki/Wiki.jsp?page=EmbeddedAndTomcat">wiki entry</ulink>.</para>
-
- </sect2>
-
- <sect2>
- <title>Packaging</title>
-
- <para> The archive structure of a WAR-based deployment on an servlet engine like Tomcat will look something
- like this: </para>
-
- <programlisting><![CDATA[my-application.war/
- META-INF/
- MANIFEST.MF
- WEB-INF/
- web.xml
- components.xml
- faces-config.xml
- lib/
- jboss-seam.jar
- jboss-seam-ui.jar
- jboss-el.jar
- jsf-facelets.jar
- jsf-api.jar
- jsf-impl.jar
- ...
- my-application.jar/
- META-INF/
- MANIFEST.MF
- persistence.xml
- seam.properties
- org/
- jboss/
- myapplication/
- User.class
- Login.class
- LoginBean.class
- Register.class
- RegisterBean.class
- ...
- login.jsp
- register.jsp
- ...]]></programlisting>
-
- <para> Most of the Seam example applications may be deployed to Tomcat by running <literal>ant
- deploy.tomcat</literal>. </para>
-
- </sect2>
-
- </sect1>
-
- <sect1>
<title>Configuring jBPM in Seam</title>
<para> Seam's jBPM integration is not installed by default, so you'll need to enable jBPM by installing a
built-in component. You'll also need to explicitly list your process and pageflow definitions. In
Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/I18n.xml
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/I18n.xml 2009-03-24 14:05:09 UTC (rev 10207)
+++ branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/I18n.xml 2009-03-24 14:28:11 UTC (rev 10208)
@@ -31,7 +31,7 @@
<para>
To ensure that the application server receives the request
parameters in the correct encoding from client requests you have to
- configure the tomcat connector. If you use Tomcat or JBoss AS, add
+ configure the JBoss-web connector. Add
the <literal>URIEncoding="UTF-8"</literal> attribute to the
connector configuration. For JBoss EAP AS 4.3 change
<literal>${JBOSS_HOME}/server/production/deploy/jboss-web.deployer/server.xml</literal>:
Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Preface.xml
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Preface.xml 2009-03-24 14:05:09 UTC (rev 10207)
+++ branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Preface.xml 2009-03-24 14:28:11 UTC (rev 10208)
@@ -269,18 +269,6 @@
</para>
</listitem>
</varlistentry>
-
- <varlistentry>
- <term><emphasis>Get started now!</emphasis></term>
- <listitem>
- <para>
- Seam works in any Java EE application server, and even works in Tomcat. If your environment
- supports EJB 3.0, great! If it doesn't, no problem, you can use Seam's built-in transaction
- management with JPA or Hibernate3 for persistence. Or, you can deploy JBoss Embedded in
- Tomcat, and get full support for EJB 3.0.
- </para>
- </listitem>
- </varlistentry>
</variablelist>
<mediaobject>
Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Tutorial.xml
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Tutorial.xml 2009-03-24 14:05:09 UTC (rev 10207)
+++ branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Tutorial.xml 2009-03-24 14:28:11 UTC (rev 10208)
@@ -39,8 +39,8 @@
<para> First, make sure you have Ant correctly installed, with <literal>$ANT_HOME</literal> and
<literal>$JAVA_HOME</literal> set correctly. Next, make sure you set the location of your EAP embedded JBoss AS
installation in the <literal>build.properties</literal> file in the root folder of your Seam
- installation, predefined location is /var/lib/jboss-as. If you haven't already done so,
- start JBoss AS now by typing <literal>bin/run.sh</literal>
+ installation, predefined location is /var/lib/jbossas. If you haven't already done so,
+ start JBoss EAP AS now by typing <literal>bin/run.sh</literal>
or <literal>bin/run.bat</literal> in the root directory of your JBoss installation. </para>
<para> Now, build and deploy the example by typing <literal>ant deploy</literal> in the
@@ -52,48 +52,6 @@
</section>
- <section>
- <title>Running the examples on Tomcat</title>
-
- <para>
- First, make sure you have Ant correctly installed, with <literal>$ANT_HOME</literal> and
- <literal>$JAVA_HOME</literal> set correctly. Next, make sure you set the location of your Tomcat
- 6.0 installation in the <literal>build.properties</literal> file in the root folder of your Seam
- installation. You will need to follow the instructions in embedded installation configuration section of this book
- for installing JBoss Embedded on Tomcat 6.0. JBoss Embedded is required to run the Seam demo
- applications on Tomcat. (However, it is possible to use Seam on Tomcat without JBoss Embedded.)
- </para>
-
- <para>
- Now, build and deploy the example by typing <literal>ant tomcat.deploy</literal> in the
- <filename>examples/<replaceable>registration</replaceable></filename> directory.
- </para>
-
- <para>Finally, start Tomcat.</para>
-
- <para>
- Try it out by accessing <ulink url="http://localhost:8080/jboss-seam-registration/">
- <literal>http://localhost:8080/jboss-seam-registration/</literal>
- </ulink> with your web browser.
- </para>
-
- <para>
- When you deploy the example to Tomcat, any EJB3 components will run inside the JBoss Embeddable EJB3
- container, a complete standalone EJB3 container environment.
- </para>
-
- </section>
-
- <section>
- <title>Running the example tests</title>
- <para>
- Most of the examples come with a suite of TestNG integration tests. The easiest way to run the tests
- is to run <literal>ant testexample</literal> inside the
- <filename>examples/<replaceable>registration</replaceable></filename> directory. It is also possible
- to run the tests inside your IDE using the TestNG plugin.
- </para>
- </section>
-
</section>
<section id="registration-example">
Deleted: branches/enterprise/JBPAPP_4_3_FP01/readme.txt
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/readme.txt 2009-03-24 14:05:09 UTC (rev 10207)
+++ branches/enterprise/JBPAPP_4_3_FP01/readme.txt 2009-03-24 14:28:11 UTC (rev 10208)
@@ -1,55 +0,0 @@
-JBoss Seam FP - Contextual Component framework for Java EE 5
-=========================================================
-version 2.0.2-FP, May 2008
-
-This software is distributed under the terms of the FSF Lesser Gnu
-Public License (see lgpl.txt).
-
-Get Up And Running Quick
-------------------------
-
-1. Install JBoss AS 4.2.2.GA. The JEMS installer is no longer required for EJB3 support.
-
-2. Edit the "build.properties" file and change jboss.home to your
- JBoss AS installation directory
-
-3. Start JBoss AS by typing "bin/run.sh" in the JBoss home directory
-
-4. In the "examples/booking" directory, type "ant deploy" and check
- for any error messages
-
-5. Point your browser to
-
- http://localhost:8080/seam-booking/
-
-6. Register an account, search for hotels, book a room...
-
-Running The TestNG Tests
-------------------------
-
-In the jboss-seam-x.x.x.x directory, type "ant testcore testreport" or "ant testall testreport".
-
-Then checkout the report in the /test-report directory.
-
-
-Running the TestNG Tests in Eclipse
------------------------------------
-
-1. Install the TestNG Eclipse plugin from http://beust.com/eclipse
-
-2. Create the jboss-seam Eclipse project with the following directories
- in your source path:
-
- src/main/
- src/test/misc
-
- And all jar files from the lib/ directory in your classpath.
-
-3. Run src/test/misc/org/jboss/seam/test/testng.xml using the TestNG
- plugin.
-
-Learn more
-----------
-
-* Read the documentation in the "doc/reference/en" directory
-* Read the online FAQ http://www.seamframework.org
More information about the seam-commits
mailing list