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

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


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

commit 590405dca249e33a0b6762b685c69815e657fe73
Author: KeiichiFujino <kfuj...@apache.org>
AuthorDate: Tue Sep 1 14:38:34 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 cb8e120..00b91e1 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -174,6 +174,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 c376c9a..e2537d7 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -2200,6 +2200,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