This is an automated email from the ASF dual-hosted git repository.

kfujino pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/9.0.x by this push:
     new 6af00e7  Add document for PersistentValve
6af00e7 is described below

commit 6af00e77683eda319dc995226199056352066d11
Author: KeiichiFujino <kfuj...@apache.org>
AuthorDate: Tue Sep 1 14:31:52 2020 +0900

    Add document for PersistentValve
---
 webapps/docs/changelog.xml    |  3 +++
 webapps/docs/config/valve.xml | 37 +++++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index acb907c..1e57e6f 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -185,6 +185,9 @@
         Extracted CSS styles from the Manager we application for better code
         maintenance and replaced the GIF logo with SVG. (isapir)
       </fix>
+      <add>
+        Add document for <code>PersistentValve</code>. (kfujino)
+      </add>
     </changelog>
   </subsection>
   <subsection name="Other">
diff --git a/webapps/docs/config/valve.xml b/webapps/docs/config/valve.xml
index 00c25eb..aac0d5a 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -2261,6 +2261,43 @@
 
 </section>
 
+<section name="Persistent Valve">
+
+  <subsection name="Introduction">
+
+    <p>The <strong>PersistentValve</strong> that implements per-request session
+    persistence. It is intended to be used with non-sticky load-balancers.</p>
+
+  </subsection>
+
+  <subsection name="Attributes">
+
+    <p>The <strong>PersistentValve Valve</strong> supports the
+    following configuration attributes:</p>
+
+    <attributes>
+
+      <attribute name="className" required="true">
+        <p>Java class name of the implementation to use.  This MUST be set to
+        <strong>org.apache.catalina.valves.PersistentValve</strong>.</p>
+      </attribute>
+
+      <attribute name="filter" required="false">
+        <p>For known file extensions or urls, you can use this filter pattern 
to
+        notify the valve that no session required during this request. If the
+        request matches this filter pattern, the valve assumes there has been 
no
+        need to restore session. An example filter would look like <code>
+        filter=&quot;.*\.gif|.*\.js|.*\.jpeg|.*\.jpg|.*\.png|.*\.htm|.*\.html|
+        .*\.css|.*\.txt&quot;</code>. The filter is a regular expression using
+        <code>java.util.regex</code>.</p>
+      </attribute>
+
+    </attributes>
+
+  </subsection>
+
+</section>
+
 </body>
 
 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to