From seam-commits at lists.jboss.org Mon Aug 20 08:10:48 2012
Content-Type: multipart/mixed; boundary="===============2049968246604427060=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r15059 -
 branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US.
Date: Mon, 20 Aug 2012 08:10:48 -0400
Message-ID: <201208201210.q7KCAmgL010123@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: manaRH
Date: 2012-08-20 08:10:48 -0400 (Mon, 20 Aug 2012)
New Revision: 15059

Modified:
   branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Confi=
guration.xml
Log:
JBSEAM-4856 added doc for initialize-in-order requirement when multiple mod=
ules

Modified: branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-U=
S/Configuration.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
--- branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Conf=
iguration.xml	2012-08-20 11:24:57 UTC (rev 15058)
+++ branches/community/Seam_2_3/seam-reference-guide/src/docbook/en-US/Conf=
iguration.xml	2012-08-20 12:10:48 UTC (rev 15059)
@@ -975,7 +975,7 @@
         =

         <para>Seam 2.3 requires to have setup special deployment metada fi=
le <filename>jboss-deployment-structure.xml</filename>
          for correct initialization. Minimal content for EAR is: =

-        <example>
+         <example>
             <title>jboss-deployment-structure.xml</title>
         <programlisting><![CDATA[<jboss-deployment-structure xmlns=3D"urn:=
jboss:deployment-structure:1.0">
   <deployment>
@@ -986,11 +986,93 @@
         </dependencies>
   </deployment>  =

 </jboss-deployment-structure>]]></programlisting> =

-    </example>
-    =

-    More details about new AS 7 classloading can be found at =

-    <ulink url=3D"https://docs.jboss.org/author/display/AS7/Developer+Guid=
e#DeveloperGuide-ClassloadinginJBossAS7">https://docs.jboss.org/author/disp=
lay/AS7/Developer+Guide#DeveloperGuide-ClassloadinginJBossAS7</ulink> =

-</para>
+        </example>    =

+            More details about new AS 7 classloading can be found at =

+            <ulink url=3D"https://docs.jboss.org/author/display/AS7/Develo=
per+Guide#DeveloperGuide-ClassloadinginJBossAS7">https://docs.jboss.org/aut=
hor/display/AS7/Developer+Guide#DeveloperGuide-ClassloadinginJBossAS7</ulin=
k> =

+        </para>
+
+   <warning>
+      <title>Deployment of multiple modules in one EAR</title>
+      <para>There is a significant enhancement for speed up the applicatio=
n deployment in AS 7. This unfortunatelly can
+         cause some issues while you have multiple war/ejb modules in your=
 application.</para>
+      <para>
+         This situation requires to use and set up new Java EE 6 configura=
tion parameter -
+         <emphasis>Module initialization order</emphasis>
+         - in
+         <filename>application.xml</filename>
+         -
+         <literal>initialize-in-order</literal>
+         to true.
+         This causes that initialization will happen in defined order like=
 it is in
+         <filename>application.xml</filename>.
+         Example of <filename>application.xml</filename>:
+         <programlisting><![CDATA[<?xml version=3D"1.0" encoding=3D"UTF-8"=
?>
+<application xmlns=3D"http://java.sun.com/xml/ns/javaee" xmlns:xsi=3D"http=
://www.w3.org/2001/XMLSchema-instance"
+  version=3D"6" xsi:schemaLocation=3D"http://java.sun.com/xml/ns/javaee ht=
tp://java.sun.com/xml/ns/javaee/application_6.xsd">
+  <application-name>test-app</application-name>
+  <initialize-in-order>true</initialize-in-order>
+  <module>
+    <ejb>jboss-seam.jar</ejb>
+  </module>
+  <module>
+    <web>
+      <web-uri>test-web1.war</web-uri>
+      <context-root>test</context-root>
+    </web>
+    <web>
+      <web-uri>test-web2.war</web-uri>
+      <context-root>test</context-root>
+    </web>
+  </module>
+</application>]]></programlisting>
+      </para>
+      =

+      <para>
+         If you are using <literal>maven-ear-plugin</literal> for generati=
on of your application,
+          you can use this plugin configuration:
+            <programlisting><![CDATA[<plugin>
+    <artifactId>maven-ear-plugin</artifactId>
+    <!-- from version 2.6 the plugin supports Java EE 6 descriptor -->
+    <version>2.7</version>
+    <configuration> =

+        <version>6</version>
+        <generateApplicationXml>true</generateApplicationXml> =

+        <defaultLibBundleDir>lib</defaultLibBundleDir>                =

+        <initializeInOrder>true</initializeInOrder>
+        <modules> =

+            <jarModule> =

+                <groupId>org.jboss.el</groupId> =

+                <artifactId>jboss-el</artifactId> =

+                <includeInApplicationXml>false</includeInApplicationXml> =

+                <bundleDir>lib</bundleDir> =

+            </jarModule> =

+            <ejbModule> =

+                <groupId>org.jboss.seam</groupId> =

+                <artifactId>jboss-seam</artifactId> =

+                <bundleFileName>jboss-seam.jar</bundleFileName>           =
              =

+            </ejbModule> =

+            <ejbModule> =

+                <groupId>some.user.module</groupId> =

+                <artifactId>hello-ejbs</artifactId> =

+                <bundleFileName>hello-ejbs.jar</bundleFileName>           =
              =

+            </ejbModule> =

+            <webModule> =

+                <groupId>some.user.module</groupId> =

+                <artifactId>hello-web1</artifactId> =

+                <contextRoot>/hello1</contextRoot> =

+                <bundleFileName>hello-web1.war</bundleFileName> =

+            </webModule> =

+            <webModule> =

+                <groupId>some.user.module</groupId> =

+                <artifactId>hello-web2</artifactId> =

+                <contextRoot>/hello2</contextRoot> =

+                <bundleFileName>hello-web2.war</bundleFileName> =

+            </webModule>                                         =

+        </modules> =

+    </configuration> =

+</plugin>]]></programlisting>
+      </para>
+   </warning>
     </section>
 =

     <section>


--===============2049968246604427060==--