mod_proxy_ajp: Note that Tomcat getAttributeNames() does not list AJP-forwarded reque...

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934059 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_proxy_ajp.xml b/docs/manual/mod/mod_proxy_ajp.xml
index 0a35bb1318e58aa97004cbda5367774eeda1e68f..f745684d66d16d1a1f5e34f24d78a78167d10d2e 100644 (file)
--- a/docs/manual/mod/mod_proxy_ajp.xml
+++ b/docs/manual/mod/mod_proxy_ajp.xml
@@ -111,6 +111,12 @@ ProxyPassReverse "/apps/foo" "http://www.example.com/foo"
     <p>Environment variables whose names have the prefix <code>AJP_</code>
     are forwarded to the origin server as AJP request attributes
     (with the <code>AJP_</code> prefix removed from the name of the key).</p>
+
+    <p>Please be aware that these request attributes are only accessible when
+    directly asking for them using the <code>HttpServletRequest.getAttribute</code>
+    method - Tomcat's implementation of the
+    <a href="https://tomcat.apache.org/tomcat-9.0-doc/api/org/apache/catalina/connector/Request.html#getAttributeNames--"><code>getAttributeNames</code></a>
+    method does not list them as those are handled as internal attributes.</p>
 </section>
 
 <section id="overviewprotocol"><title>Overview of the protocol</title>