svn commit: r1654735 - in /tomcat/trunk/webapps/docs/config: ajp.xml http.xml

[kk...@apache.org]

Author: kkolinko
Date: Mon Jan 26 07:52:39 2015
New Revision: 1654735

URL: http://svn.apache.org/r1654735
Log:
Clarify behaviour of useBodyEncodingForURI attribute and its relation to URIEncoding.

This is based on source code inspection. I have not run any tests for it.
Important places:
- org.apache.catalina.connector.Request.parseParameters() - query parameters parsing
- org.apache.catalina.connector.CoyoteAdapter.convertURI() (called from CoyoteAdapter.postParseRequest() - URI decoding

Modified:
    tomcat/trunk/webapps/docs/config/ajp.xml
    tomcat/trunk/webapps/docs/config/http.xml

Modified: tomcat/trunk/webapps/docs/config/ajp.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/config/ajp.xml?rev=1654735&r1=1654734&r2=1654735&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/config/ajp.xml (original)
+++ tomcat/trunk/webapps/docs/config/ajp.xml Mon Jan 26 07:52:39 2015
@@ -238,6 +238,8 @@
       Request.setCharacterEncoding method was also used for the parameters from
       the URL. The default value is <code>false</code>.
       </p>
+      <p><em>Notes:</em> See notes on this attribute in
+      <a href="http.html">HTTP Connector</a> documentation.</p>
     </attribute>
 
     <attribute name="useIPVHosts" required="false">

Modified: tomcat/trunk/webapps/docs/config/http.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/config/http.xml?rev=1654735&r1=1654734&r2=1654735&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/config/http.xml (original)
+++ tomcat/trunk/webapps/docs/config/http.xml Mon Jan 26 07:52:39 2015
@@ -239,6 +239,15 @@
       Request.setCharacterEncoding method was also used for the parameters from
       the URL. The default value is <code>false</code>.
       </p>
+      <p><strong>Notes:</strong> 1) This setting is applied only to the
+      query string of a request. Unlike <code>URIEncoding</code> it does not
+      affect the path portion of a request URI. 2) If request character
+      encoding is not known (is not provided by a browser and is not set by
+      <code>SetCharacterEncodingFilter</code> or a similar filter using
+      Request.setCharacterEncoding method), the default encoding is always
+      "ISO-8859-1". The <code>URIEncoding</code> setting has no effect on
+      this default.
+      </p>
     </attribute>
 
     <attribute name="useIPVHosts" required="false">



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