From seam-commits at lists.jboss.org Wed Nov  5 17:08:40 2008
Content-Type: multipart/mixed; boundary="===============5539039570658001869=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r9510 - trunk/doc/Seam_Reference_Guide/en-US.
Date: Wed, 05 Nov 2008 17:08:40 -0500
Message-ID: <E1KxqYK-0002jn-Fa@committer01.frg.pub.inap.atl.jboss.com>

--===============5539039570658001869==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: jbalunas(a)redhat.com
Date: 2008-11-05 17:08:40 -0500 (Wed, 05 Nov 2008)
New Revision: 9510

Modified:
   trunk/doc/Seam_Reference_Guide/en-US/Glassfish.xml
Log:
Updated Glassfish chapter.

Modified: trunk/doc/Seam_Reference_Guide/en-US/Glassfish.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/doc/Seam_Reference_Guide/en-US/Glassfish.xml	2008-11-05 17:59:39 =
UTC (rev 9509)
+++ trunk/doc/Seam_Reference_Guide/en-US/Glassfish.xml	2008-11-05 22:08:40 =
UTC (rev 9510)
@@ -70,12 +70,13 @@
          <programlisting>$ bin/asadmin start-domain domain1</programlistin=
g>
 =

          <para>
-            The web adminstration console is available at <literal>http://=
localhost:4848/</literal>.
+            The web administration console is available at <literal>http:/=
/localhost:4848/</literal>.
             You can access the web admin console with the default username =

             (<literal>admin</literal>) and password (<literal>adminadmin</=
literal>).
-            Alternatively, you could copy EAR/WAR file to =

-            <literal>glassfish/domains/domain1/autodeploy</literal> to dep=
loy =

-            it.
+            We will be using the the admin console to deploy our examples.=
  =

+            You can also copy EAR/WAR files to the
+            <literal>glassfish/domains/domain1/autodeploy</literal> direct=
ory =

+            to deploy them, although we are not going to cover that.
          </para>
 =

          <para>
@@ -95,7 +96,23 @@
          designed to run on GlassFish. It is located in
          <literal>$SEAM_DIST/examples/jee5/booking</literal>.
       </para>
+      =

+      <section>
+         <title>Building the <literal>jee5/booking</literal> example</titl=
e>
 =

+         <para>
+            To build the example, simply execute the default =

+            <literal>ant</literal> target:
+         </para>
+         =

+         <programlisting>$ ant</programlisting>
+         =

+         <para>
+            in the <literal>examples/jee5/booking</literal> directory.  Th=
is =

+            will create the <literal>dist</literal> and =

+            <literal>exploded-archives</literal> directories.
+         </para>
+      </section>
       <section id=3D"jee5-glassfish-deploy">
          <title>Deploying the application to GlassFish</title>
 =

@@ -187,7 +204,8 @@
 =

          <para>
             This is very similar to the <literal>jee5</literal> example at
-            <xref linkend=3D"jee5-glassfish-deploy" />.
+            <xref linkend=3D"jee5-glassfish-deploy" /> except that this is=
 a
+            <literal>war</literal> and not an <literal>ear</literal>.
          </para>
 =

          <itemizedlist>
@@ -245,7 +263,7 @@
          </note>
       </section>
 =

-      <section>
+      <section id=3D"glassfish_jpa_diff">
          <title>What's different for GlassFish v2 UR2</title>
 =

          <itemizedlist>
@@ -291,9 +309,7 @@
          quickly get an application up and running, and provides a foundat=
ion to
          add your own functionality. Out of box <literal>seam-gen</literal=
> will
          produce applications configured to run on JBoss AS. These instruc=
tions =

-         will show the steps needed to get it to run on GlassFish. As stat=
ed =

-         above in <xref linkend=3D"jee5-glassfish-section" /> it's easy to=
 deploy =

-         either an EJB3 or a Seam POJOs application on Glassfish.
+         will show the steps needed to get it to run on GlassFish. =

       </para>
 =

       <section>
@@ -419,9 +435,9 @@
                         </listitem>
                         <listitem>
                            <para>
-                              Add or change the properties below. These are
-                              described in detail at =

-                              <xref linkend=3D"jee5-glassfish-section" />:
+                              Replace all of the properties with the follo=
wing.
+                              The key differences are briefly described in =

+                              <xref linkend=3D"glassfish_jpa_diff" />:
                            </para>
                            <programlisting role=3D"XML"><![CDATA[<property=
 name=3D"hibernate.dialect" value=3D"GlassFishDerbyDialect"/>
 <property name=3D"hibernate.hbm2ddl.auto" value=3D"update"/>
@@ -499,7 +515,7 @@
                         <listitem>
                            <para>
                               Alter the <literal>jndi-pattern</literal> to
-                              <literal>java:comp/env/seamgen_example/#{ejb=
Name}/local</literal>
+                              <literal>java:comp/env/seamgen_example/#{ejb=
Name}</literal>
                            </para>
                         </listitem>
                      </itemizedlist>
@@ -604,7 +620,6 @@
                This application has similar requirements as the
                <literal>jee5/booking</literal> example.
             </para>
-
             <itemizedlist>
                <listitem>
                   <para>
@@ -614,30 +629,12 @@
 =

                   <programlisting role=3D"XML"><![CDATA[<project name=3D"s=
eamgen_example" default=3D"archive" basedir=3D".">]]></programlisting>
                </listitem>
-
                <listitem>
                   <para>
-                     Websphere looks for the drools <literal>/security.drl=
</literal>
-                     file in the root of the <literal>war</literal> file i=
nstead of the root of the
-                     <literal>seamgen_example.jar</literal> so we need to =
have
-                     the <literal>build.xml</literal> move it to the corre=
ct =

-                     location at build time. The following must be added a=
t the
-                     top of the <literal><![CDATA[<target name=3D"war" dep=
ends=3D"compile" description=3D"Build the distribution .war file">]]></lite=
ral>
-                     target.
-                  </para>
-
-                  <programlisting role=3D"XML"><![CDATA[<copy todir=3D"${w=
ar.dir}">
-   <fileset dir=3D"${basedir}/resources">
-      <include name=3D"*.drl" />
-   </fileset> =

-</copy>]]></programlisting>
-               </listitem>
-
-               <listitem>
-                  <para>
                      We need to get the <literal>GlassFishDerbyDialect.cla=
ss</literal>
                      into our application jar. To do that find the <litera=
l>jar</literal>
-                     task and modify the top of it so that it looks like t=
his:
+                     task and add the <literal>GlassFishDerbyDialect.class=
</literal>
+                     line as shown below:
                   </para>
 =

                   <programlisting role=3D"XML"><![CDATA[<target name=3D"ja=
r" depends=3D"compile,copyclasses" description=3D"Build the distribution .j=
ar file">
@@ -650,156 +647,65 @@
    </copy>
    ...]]></programlisting>
                </listitem>
-
                <listitem>
                   <para>
-                     Next we need to get the <literal>jboss-seam.jar</lite=
ral>
-                     into the base of the <literal>EAR</literal> file. For =

-                     deployment GlassFish requires this jar to be in both =
the
-                     <literal>/lib</literal> directory and at the base of =
the
-                     <literal>EAR</literal>. You must add the following to=
 the
-                     <literal>archive</literal> task:
+                     Now we need to get extra jars into the <literal>ear</=
literal>
+                     file.  Look for the =

+                     <literal><![CDATA[<copy todir=3D"${ear.dir}/lib">]]><=
/literal>
+                     section of the <literal>ear</literal> target. Add the=
 following
+                     to the child =

+                     <literal><![CDATA[<fileset dir=3D"${lib.dir}">]]></li=
teral>
+                     element.
                   </para>
-
-                  <programlisting role=3D"XML"><![CDATA[<fileset dir=3D"${=
lib.dir}">
-   <include name=3D"jboss-seam.jar" >
-</fileset>]]></programlisting>
-
-                  <para>
-                     So that the whole <literal>archive</literal> task loo=
ks =

-                     like:
-                  </para>
-
-                  <programlisting role=3D"XML"><![CDATA[<target name=3D"ar=
chive" depends=3D"jar,war,ear" description=3D"Package the archives">
-   <jar jarfile=3D"${dist.dir}/${project.name}.jar" basedir=3D"${jar.dir}"=
/> =

-   <jar jarfile=3D"${dist.dir}/${project.name}.war" basedir=3D"${war.dir}"=
/>
-   <jar jarfile=3D"${dist.dir}/${project.name}.ear">
-      <fileset dir=3D"${ear.dir}"/>
-      <fileset dir=3D"${dist.dir}">
-         <include name=3D"${project.name}.jar"/>
-         <include name=3D"${project.name}.war"/>
-      </fileset>
-      <fileset dir=3D"${lib.dir}">
-         <include name=3D"jboss-seam.jar" />
-      </fileset>
-   </jar>
-</target>]]></programlisting>
                </listitem>
-               <listitem>
-                  <para>
-                     Now we need to get extra jars into the <literal>build=
.xml</literal>.
-                     Look for the <literal><![CDATA[<fileset dir=3D"${base=
dir}">]]></literal>
-                     section of the task below. Add the new includes at the
-                     bottom of the fileset.
-                  </para>
-
-                  <programlisting role=3D"XML"><![CDATA[<target name=3D"ea=
r" description=3D"Build the EAR">
-   <copy todir=3D"${ear.dir}">
-      <fileset dir=3D"${basedir}/resources">
-         <include name=3D"*jpdl.xml" />
-         <include name=3D"*hibernate.cfg.xml" />
-         <include name=3D"jbpm.cfg.xml" /> =

-      </fileset>
-      <fileset dir=3D"${lib.dir}">
-         <include name=3D"jboss-seam.jar" />
-      </fileset>
-      <fileset dir=3D"${basedir}">
-         <include name=3D"lib/jbpm*.jar" />
-         <include name=3D"lib/jboss-el.jar" />
-         <include name=3D"lib/drools-*.jar"/>
-         <include name=3D"lib/core.jar"/>
-         <include name=3D"lib/janino*.jar"/>
-         <include name=3D"lib/antlr-*.jar"/>
-         <include name=3D"lib/mvel*.jar"/> =

-         <include name=3D"lib/richfaces-api*.jar" />
-      </fileset>
-   </copy>
-   <copy todir=3D"${ear.dir}/META-INF">
-      <fileset dir=3D"${basedir}/resources/META-INF">
-         <include name=3D"application.xml" />
-         <include name=3D"jboss-app.xml" />
-      </fileset>
-   </copy>
-</target>]]></programlisting>
-
+               <listitem> =

                   <itemizedlist>
                      <listitem>
                         <para>Add Hibernate dependencies</para>
-
                         <programlisting role=3D"XML"><![CDATA[<!-- Hiberna=
te and deps --> =

-<include name=3D"lib/hibernate.jar"/>
-<include name=3D"lib/hibernate-commons-annotations.jar"/>
-<include name=3D"lib/hibernate-annotations.jar"/>
-<include name=3D"lib/hibernate-entitymanager.jar"/>
-<include name=3D"lib/hibernate-validator.jar"/>
-<include name=3D"lib/jboss-common-core.jar"/>]]></programlisting>
+<include name=3D"hibernate.jar"/>
+<include name=3D"hibernate-commons-annotations.jar"/>
+<include name=3D"hibernate-annotations.jar"/>
+<include name=3D"hibernate-entitymanager.jar"/>
+<include name=3D"hibernate-validator.jar"/>
+<include name=3D"jboss-common-core.jar"/>]]></programlisting>
                      </listitem>
-
                      <listitem>
-                        <para>
-                           Add JSF dependencies. You will need to copy the
-                           <literal>el-ri.jar</literal> from the
-                           <literal>$SEAM_DIST/lib</literal> directory.
-                        </para>
-
-                        <programlisting role=3D"XML"><![CDATA[<!-- jsf lib=
s --> =

-<include name=3D"lib/jsf-api.jar" />
-<include name=3D"lib/jsf-impl.jar" />
-<include name=3D"lib/el-api.jar" />
-<include  name=3D"lib/el-ri.jar"/>]]></programlisting>
-                     </listitem>
-
-                     <listitem>
                         <para>Add third party dependencies.</para>
-
                         <programlisting role=3D"XML"><![CDATA[<!-- 3rd par=
ty and supporting jars -->
-<include name=3D"lib/javassist.jar"/>
-<include name=3D"lib/dom4j.jar"/> =

-<include name=3D"lib/concurrent.jar" />
-<include name=3D"lib/cglib.jar"/>
-<include name=3D"lib/asm.jar"/>
-<include name=3D"lib/antlr.jar" />
-<include name=3D"lib/commons-logging.jar" />
-<include name=3D"lib/commons-collections.jar" />]]></programlisting>
+<include name=3D"javassist.jar"/>
+<include name=3D"dom4j.jar"/> =

+<include name=3D"concurrent.jar" />
+<include name=3D"cglib.jar"/>
+<include name=3D"asm.jar"/>
+<include name=3D"antlr.jar" />
+<include name=3D"commons-logging.jar" />
+<include name=3D"commons-collections.jar" />]]></programlisting>
                      </listitem>
                   </itemizedlist>
 =

                   <para>You should end up with something like:</para>
 =

-                  <programlisting role=3D"XML"><![CDATA[<fileset dir=3D"${=
basedir}">
-   <include name=3D"lib/jbpm*.jar" />
-   <include name=3D"lib/jboss-el.jar" />
-   <include name=3D"lib/drools-*.jar"/>
-   <include name=3D"lib/core.jar"/>
-   <include name=3D"lib/janino*.jar"/>
-   <include name=3D"lib/antlr-*.jar"/>
-   <include name=3D"lib/mvel*.jar"/>
-   <include name=3D"lib/richfaces-api*.jar" />
-
+                  <programlisting role=3D"XML"><![CDATA[<fileset dir=3D"${=
lib.dir}">
+   <includesfile name=3D"deployed-jars-ear.list" />
+   =

    <!-- Hibernate and deps -->
-   <include name=3D"lib/hibernate.jar"/>
-   <include name=3D"lib/hibernate-commons-annotations.jar"/>
-   <include name=3D"lib/hibernate-annotations.jar"/>
-   <include name=3D"lib/hibernate-entitymanager.jar"/>
-   <include name=3D"lib/hibernate-validator.jar"/>
-   <include name=3D"lib/jboss-common-core.jar" />
-
-   <!-- jsf libs -->
-   <include name=3D"lib/jsf-api.jar" />
-   <include name=3D"lib/jsf-impl.jar" />
-   <include name=3D"lib/el-api.jar" />
-   <include name=3D"lib/el-ri.jar"/>
-
+   <include name=3D"hibernate.jar"/>
+   <include name=3D"hibernate-commons-annotations.jar"/>
+   <include name=3D"hibernate-annotations.jar"/>
+   <include name=3D"hibernate-entitymanager.jar"/>
+   <include name=3D"hibernate-validator.jar"/>
+   <include name=3D"jboss-common-core.jar" />
+   =

    <!-- 3rd party and supporting jars -->
-   <include name=3D"lib/javassist.jar" />
-   <include name=3D"lib/dom4j.jar" />
-   <include name=3D"lib/concurrent.jar" />
-   <include name=3D"lib/cglib.jar" />
-   <include name=3D"lib/asm.jar" />
-   <include name=3D"lib/antlr.jar" />
-   <include name=3D"lib/commons-logging.jar" />
-   <include name=3D"lib/commons-collections.jar" />
-
+   <include name=3D"javassist.jar" />
+   <include name=3D"dom4j.jar" />
+   <include name=3D"concurrent.jar" />
+   <include name=3D"cglib.jar" />
+   <include name=3D"asm.jar" />
+   <include name=3D"antlr.jar" />
+   <include name=3D"commons-logging.jar" />
+   <include name=3D"commons-collections.jar" />
 </fileset>]]></programlisting>
                </listitem>
             </itemizedlist>


--===============5539039570658001869==--