You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by gc...@apache.org on 2009/12/03 22:41:36 UTC

svn commit: r886932 - /myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml

Author: gcrawford
Date: Thu Dec  3 21:41:35 2009
New Revision: 886932

URL: http://svn.apache.org/viewvc?rev=886932&view=rev
Log:
put all the state saving related params together in web.xml

Modified:
    myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml

Modified: myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml
URL: http://svn.apache.org/viewvc/myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml?rev=886932&r1=886931&r2=886932&view=diff
==============================================================================
--- myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml (original)
+++ myfaces/trinidad/branches/trinidad-2.0.x/trinidad-examples/trinidad-demo/src/main/webapp/WEB-INF/web.xml Thu Dec  3 21:41:35 2009
@@ -22,14 +22,6 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
          version="2.5">
-  <!-- Use client-side state saving.  In Trinidad, it is an
-       optimized, token-based mechanism that is almost always a
-       better choice than the standard JSF server-side state saving. -->
-  <context-param>
-    <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
-    <param-value>client</param-value>
-    <!--param-value>server</param-value-->
-  </context-param>
 
   <context-param>
     <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
@@ -47,6 +39,15 @@
     <param-name>org.apache.myfaces.trinidadinternal.ENABLE_PPR_OPTIMIZATION</param-name>
     <param-value>false</param-value>
   </context-param>
+ 
+  <!-- Use client-side state saving.  In Trinidad, it is an
+       optimized, token-based mechanism that is almost always a
+       better choice than the standard JSF server-side state saving. -->
+  <context-param>
+    <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
+    <param-value>client</param-value>
+    <!--param-value>server</param-value-->
+  </context-param>
 
   <!-- Parameter to set the maximum number of client view state tokens.
        Uncomment this to test low-token-count scenarios.
@@ -62,7 +63,24 @@
     <param-name>org.apache.myfaces.trinidad.CLIENT_STATE_METHOD</param-name>
     <param-value>all</param-value>
   </context-param-->
-
+<!-- When token client-side state saving is enabled, MyFaces Trinidad can apply an additional
+     optimization by caching an entire UIViewRoot tree with each token. 
+     (Note that this does not affect thread safety or session failover.) 
+     This is a major optimization for AJAX-intensive systems, as postbacks can be processed 
+     far more rapidly without the need to reinstantiate the UIViewRoot tree. 
+     
+     You set the org.apache.myfaces.trinidad.CACHE_VIEW_ROOT parameter to true to enable caching. 
+     True is the default. Set the parameter to false to disable caching.
+     
+     Note: This type of caching is known to interfere with some other JSF technologies. 
+     In particular, the Apache MyFaces Tomahawk saveState component does not work, 
+     and template text in Facelets may appear in duplicate.
+  -->
+  <context-param>
+    <param-name>org.apache.myfaces.trinidad.CACHE_VIEW_ROOT</param-name>
+    <param-value>true</param-value>
+  </context-param>
+  
   <!-- Trinidad also supports an optimized strategy for caching some
    view state at an application level, which significantly improves
    scalability.  However, it makes it harder to develop (updates to
@@ -73,6 +91,41 @@
     <param-name>org.apache.myfaces.trinidad.USE_APPLICATION_VIEW_CACHE</param-name>
     <param-value>false</param-value>
   </context-param>
+  
+
+  <!-- Temporarily disable partial state saving default until we make it work with Trinidad -->
+  <context-param>
+    <param-name>javax.faces.PARTIAL_STATE_SAVING</param-name>
+    <param-value>false</param-value>
+  </context-param>
+
+  <!-- Uncomment the below for use with Facelets 
+
+  <context-param>
+    <param-name>javax.faces.FACELETS_VIEW_MAPPINGS</param-name>
+    <param-value>*.xhtml</param-value>
+  </context-param>     
+
+  <context-param>
+    <param-name>javax.faces.FACELETS_SKIP_COMMENTS</param-name>
+    <param-value>true</param-value>
+  </context-param>
+
+  -->  
+
+
+  <!-- Enables Change Persistence at a session scope.  By default,
+       Change Persistence is entirely disabled. The ChangeManager is
+       an API, which can persist component modifications (like,
+       is a showDetail or tree expanded or collapsed). For providing
+       a custom Change Persistence implementation inherit from the 
+       Trinidad API's ChangeManager class. As the value you have 
+       to use the fullqualified class name. -->
+  <context-param>
+    <param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
+    <param-value>session</param-value>
+  </context-param>
+  
 <!-- Uncomment this if you are debugging skinning and want the styleclasses to not be compressed  
 <context-param>
  <param-name>org.apache.myfaces.trinidad.DISABLE_CONTENT_COMPRESSION</param-name>
@@ -92,18 +145,6 @@
     <param-value>false</param-value>
   </context-param>
 
-  <!-- Enables Change Persistence at a session scope.  By default,
-       Change Persistence is entirely disabled. The ChangeManager is
-       an API, which can persist component modifications (like,
-       is a showDetail or tree expanded or collapsed). For providing
-       a custom Change Persistence implementation inherit from the 
-       Trinidad API's ChangeManager class. As the value you have 
-       to use the fullqualified class name. -->
-  <context-param>
-    <param-name>org.apache.myfaces.trinidad.CHANGE_PERSISTENCE</param-name>
-    <param-value>session</param-value>
-  </context-param>
-  
   <context-param>
     <param-name>org.apache.myfaces.trinidad.resource.DEBUG</param-name>
     <param-value>false</param-value>
@@ -121,25 +162,6 @@
     <param-value>userInputHere:</param-value>
   </context-param--> 
 
-  <!-- Temporarily disable partial state saving default until we make it work with Trinidad -->
-  <context-param>
-    <param-name>javax.faces.PARTIAL_STATE_SAVING</param-name>
-    <param-value>false</param-value>
-  </context-param>
-
-  <!-- Uncomment the below for use with Facelets 
-
-  <context-param>
-    <param-name>javax.faces.FACELETS_VIEW_MAPPINGS</param-name>
-    <param-value>*.xhtml</param-value>
-  </context-param>     
-
-  <context-param>
-    <param-name>javax.faces.FACELETS_SKIP_COMMENTS</param-name>
-    <param-value>true</param-value>
-  </context-param>
-
-  -->
 
   <filter>
     <filter-name>trinidad</filter-name>