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&...;.
- 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"...
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