Author: youngm Date: 2008-10-01 17:21:05 -0400 (Wed, 01 Oct 2008) New Revision: 9165 Modified: trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml Log: JBSEAM-1922 Modified: trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml =================================================================== --- trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml 2008-10-01 18:05:49 UTC (rev 9164) +++ trunk/doc/Seam_Reference_Guide/en-US/Configuration.xml 2008-10-01 21:21:05 UTC (rev 9165) @@ -48,7 +48,25 @@ <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_bu... + 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> <sect2>