You are viewing a plain text version of this content. The canonical link for it is here.
Posted to taglibs-dev@jakarta.apache.org by lu...@apache.org on 2001/12/19 21:01:56 UTC
cvs commit: jakarta-taglibs/standard/doc/web I18N_FunctionalDescription_6_EA3.html
luehe 01/12/19 12:01:56
Modified: standard/doc/web I18N_FunctionalDescription_6_EA3.html
Log:
Added response buffering assumption/requirement to section discussing response encoding (section 3)
Revision Changes Path
1.5 +14 -12 jakarta-taglibs/standard/doc/web/I18N_FunctionalDescription_6_EA3.html
Index: I18N_FunctionalDescription_6_EA3.html
===================================================================
RCS file: /home/cvs/jakarta-taglibs/standard/doc/web/I18N_FunctionalDescription_6_EA3.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- I18N_FunctionalDescription_6_EA3.html 2001/12/19 01:46:02 1.4
+++ I18N_FunctionalDescription_6_EA3.html 2001/12/19 20:01:56 1.5
@@ -250,10 +250,15 @@
3. Response encoding</h3>
Every action that is responsible for establishing a locale passes that
locale to the <tt>setLocale()</tt> method of the <tt>javax.servlet.ServletResponse</tt>.
+(This assumes that the response is buffered with a big enough buffer size,
+since <tt>setLocale()</tt> and <tt>setContentType()</tt> must be called
+before <tt>ServletResponse.getWriter()</tt> in order for the charset to
+affect the construction of the writer.)
<p>More specifically, the response's <tt>setLocale()</tt> method is always
called by the <tt><locale></tt> action. In addition, it is called by
-the following actions in the absence of the <tt>javax.servlet.jsp.jstl.i18n.locale</tt>
-attribute:
+the following actions if browser-sensing capabilities for locales are enabled
+(that is, in the absence of the <tt>javax.servlet.jsp.jstl.i18n.locale</tt>
+attribute):
<br>
<li>
Any <tt><bundle></tt> action.</li>
@@ -266,19 +271,16 @@
A <tt><formatNumber></tt> or <tt><formatDate></tt> action that is
not enclosed within a <tt><bundle> </tt>action.</li>
-<br>
-<p>
-<br>
-<br>
-<p>After an action has called <tt>ServletResponse.setLocale()</tt>, it
-determines the character encoding associated with the locale (by calling
+<p><br>After an action has called <tt>ServletResponse.setLocale()</tt>,
+it determines the character encoding associated with the locale (by calling
<tt>ServletResponse.getCharacterEncoding()</tt>)
and stores it in the <tt>javax.servlet.jsp.jstl.i18n.request.charset</tt>
session attribute. This attribute may be used by the <tt><requestEncoding></tt>
-action in a page invoked by a form included in the response to set the
-request charset to the same as the response charset. This makes it possible
-for the container to decode the form parameter values properly, since browsers
-typically encode form field values using the response's charset.
+action (see Section 16) in a page invoked by a form included in the
+response to set the request charset to the same as the response charset.
+This makes it possible for the container to decode the form parameter values
+properly, since browsers typically encode form field values using the response's
+charset.
<h3>
4. Time zone</h3>
The <tt>javax.servlet.jsp.jstl.i18n.timeZone </tt>JSP attribute specifies
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>