[seam-commits] Seam SVN: r9212 - trunk/doc/Seam_Reference_Guide/en-US.
seam-commits at lists.jboss.org
seam-commits at lists.jboss.org
Mon Oct 6 21:35:50 EDT 2008
Author: shane.bryzak at jboss.com
Date: 2008-10-06 21:35:50 -0400 (Mon, 06 Oct 2008)
New Revision: 9212
Modified:
trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml
Log:
JBSEAM-3461
Modified: trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml
===================================================================
--- trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml 2008-10-06 18:57:08 UTC (rev 9211)
+++ trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml 2008-10-07 01:35:50 UTC (rev 9212)
@@ -48,24 +48,24 @@
<param-name>javax.faces.STATE_SAVING_METHOD</param-name>
<param-value>client</param-value>
</context-param>]]></programlisting>
-
- <para>
- There is a minor gray area in the JSF specification regarding the mutability of view state values. Since
- Seam uses the JSF view state to back its PAGE scope this can become an issue in some cases. If you're
- using server side state saving with the JSF-RI and you want a PAGE scoped bean to keep its exact value
- for a given view of a page you will need to specify the following context-param. Otherwise if a user
- uses the "back" button a PAGE scoped component will have the latest value if it has changed not the
- value of the "back" page. (see
- <ulink url="https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=295">
- Spec Issue
- </ulink>
- ). This setting is not enabled by default because of the performance hit of serializing the JSF view
- with every request.
- </para>
-
- <programlisting role="XML"><![CDATA[<context-param>
- <param-name>com.sun.faces.serializeServerState</param-name>
- <param-value>true</param-value>
+
+ <para>
+ There is a minor gray area in the JSF specification regarding the mutability of view state values. Since
+ Seam uses the JSF view state to back its PAGE scope this can become an issue in some cases. If you're
+ using server side state saving with the JSF-RI and you want a PAGE scoped bean to keep its exact value
+ for a given view of a page you will need to specify the following context-param. Otherwise if a user
+ uses the "back" button a PAGE scoped component will have the latest value if it has changed not the
+ value of the "back" page. (see
+ <ulink url="https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=295">
+ Spec Issue
+ </ulink>
+ ). This setting is not enabled by default because of the performance hit of serializing the JSF view
+ with every request.
+ </para>
+
+ <programlisting role="XML"><![CDATA[<context-param>
+ <param-name>com.sun.faces.serializeServerState</param-name>
+ <param-value>true</param-value>
</context-param>]]></programlisting>
</sect2>
@@ -844,18 +844,45 @@
<listitem>
- <para> Add the Embedded JBoss listener to <literal>conf/server.xml</literal>. It should appear after
- all other listeners in the file.</para>
+ <para> Add the Embedded JBoss listener <literal>EmbeddedJBossBootstrapListener</literal> to
+ <literal>conf/server.xml</literal>. It must appear after all other listeners in the file:</para>
- <programlisting role="XML"><![CDATA[<Listener className="org.jboss.embedded.tomcat.EmbeddedJBossBootstrapListener"/>]]></programlisting>
+ <programlisting role="XML"><![CDATA[<Server port="8005" shutdown="SHUTDOWN">
+
+ <!-- Comment these entries out to disable JMX MBeans support used for the
+ administration web application -->
+ <Listener className="org.apache.catalina.core.AprLifecycleListener" />
+ <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener" />
+ <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
+ <Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>]]></programlisting>
+ <programlisting role="XML"><![CDATA[<!-- Add this listener -->
+ <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>
+ <para>WAR file scanning should be enabled by adding the <literal>WebinfScanner</literal> listener to
+ <literal>conf/context.xml</literal>: </para>
- <programlisting role="XML"><![CDATA[<Listener className="org.jboss.embedded.tomcat.WebinfScanner"/>]]></programlisting>
+ <programlisting role="XML"><![CDATA[<Context>
+ <!-- Default set of monitored resources -->
+ <WatchedResource>WEB-INF/web.xml</WatchedResource>
+
+ <!-- Uncomment this to disable session persistence across Tomcat restarts -->
+ <!--
+ <Manager pathname="" />
+ -->]]></programlisting>
+ <programlisting role="XML"><![CDATA[<!-- Add this listener -->
+ <Listener className="org.jboss.embedded.tomcat.WebinfScanner"/>]]></programlisting>
+ <programlisting role="XML"><![CDATA[</Context>]]></programlisting>
</listitem>
+
+ <listitem>
+ <para>If you are using JDK 6, you must set the Java option <literal>sun.lang.ClassLoader.allowArraySyntax</literal> to
+ <literal>true</literal> in Tomcat's startup script (either catalina.bat or catalina.sh):
+ </para>
+
+ <programlisting><![CDATA[set JAVA_OPTS=%JAVA_OPTS% -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djava.util.logging.config.file="%CATALINA_BASE%\conf\logging.properties" -Dsun.lang.ClassLoader.allowArraySyntax=true]]></programlisting>
+ </listitem>
</itemizedlist>
<para>For more configuration options, please see the Embedded JBoss Tomcat integration
More information about the seam-commits
mailing list