You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by jf...@apache.org on 2003/08/18 18:50:33 UTC
cvs commit: jakarta-servletapi-5/jsr154/src/share/javax/servlet/http Cookie.java HttpServlet.java HttpServletRequest.java HttpServletResponse.java HttpSession.java HttpSessionListener.java
jfarcand 2003/08/18 09:50:33
Modified: jsr154/src/share/javax/servlet Filter.java FilterConfig.java
ServletConfig.java ServletContext.java
ServletContextAttributeEvent.java
ServletContextListener.java
ServletOutputStream.java ServletRequest.java
ServletResponse.java UnavailableException.java
jsr154/src/share/javax/servlet/http Cookie.java
HttpServlet.java HttpServletRequest.java
HttpServletResponse.java HttpSession.java
HttpSessionListener.java
Log:
Apply documentation patch submitted by Yutaka Yoshida at sun.com
Revision Changes Path
1.2 +2 -2 jakarta-servletapi-5/jsr154/src/share/javax/servlet/Filter.java
Index: Filter.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/Filter.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Filter.java 13 Aug 2002 16:21:42 -0000 1.1
+++ Filter.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -63,7 +63,7 @@
import java.io.IOException;
/**
- * A filter is an object than perform filtering tasks on either the request to a resource (a servlet or static content), or on the response from a resource, or both.
+ * A filter is an object that performs filtering tasks on either the request to a resource (a servlet or static content), or on the response from a resource, or both.
* <br><br>
* Filters perform filtering in the <code>doFilter</code> method. Every Filter has access to
** a FilterConfig object from which it can obtain its initialization parameters, a
@@ -114,7 +114,7 @@
* filter content or headers for output filtering <br>
* 4. a) <strong>Either</strong> invoke the next entity in the chain using the FilterChain object (<code>chain.doFilter()</code>), <br>
** 4. b) <strong>or</strong> not pass on the request/response pair to the next entity in the filter chain to block the request processing<br>
- ** 5. Directly set headers on the response after invokation of the next entity in ther filter chain.
+ ** 5. Directly set headers on the response after invocation of the next entity in ther filter chain.
**/
public void doFilter ( ServletRequest request, ServletResponse response, FilterChain chain ) throws IOException, ServletException;
1.2 +4 -4 jakarta-servletapi-5/jsr154/src/share/javax/servlet/FilterConfig.java
Index: FilterConfig.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/FilterConfig.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- FilterConfig.java 13 Aug 2002 16:21:42 -0000 1.1
+++ FilterConfig.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -68,7 +68,7 @@
/**
*
* A filter configuration object used by a servlet container
- * used to pass information to a filter during initialization.
+ * to pass information to a filter during initialization.
* @see Filter
* @since Servlet 2.3
*
@@ -116,13 +116,13 @@
/**
- * Returns the names of the servlet's initialization parameters
+ * Returns the names of the filter's initialization parameters
* as an <code>Enumeration</code> of <code>String</code> objects,
- * or an empty <code>Enumeration</code> if the servlet has
+ * or an empty <code>Enumeration</code> if the filter has
* no initialization parameters.
*
* @return an <code>Enumeration</code> of <code>String</code>
- * objects containing the names of the servlet's
+ * objects containing the names of the filter's
* initialization parameters
*
*
1.2 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletConfig.java
Index: ServletConfig.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletConfig.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ServletConfig.java 13 Aug 2002 16:21:43 -0000 1.1
+++ ServletConfig.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -67,7 +67,7 @@
/**
*
* A servlet configuration object used by a servlet container
- * used to pass information to a servlet during initialization.
+ * to pass information to a servlet during initialization.
*
*/
1.4 +6 -2 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContext.java
Index: ServletContext.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContext.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ServletContext.java 11 Apr 2003 15:02:40 -0000 1.3
+++ ServletContext.java 18 Aug 2003 16:50:33 -0000 1.4
@@ -312,7 +312,9 @@
*
* @return a <code>RequestDispatcher</code> object
* that acts as a wrapper for the resource
- * at the specified path
+ * at the specified path, or <code>null</code> if
+ * the <code>ServletContext</code> cannot return
+ * a <code>RequestDispatcher</code>
*
* @see RequestDispatcher
* @see ServletContext#getContext
@@ -340,7 +342,9 @@
* of a servlet to wrap
*
* @return a <code>RequestDispatcher</code> object
- * that acts as a wrapper for the named servlet
+ * that acts as a wrapper for the named servlet,
+ * or <code>null</code> if the <code>ServletContext</code>
+ * cannot return a <code>RequestDispatcher</code>
*
* @see RequestDispatcher
* @see ServletContext#getContext
1.2 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContextAttributeEvent.java
Index: ServletContextAttributeEvent.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContextAttributeEvent.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ServletContextAttributeEvent.java 13 Aug 2002 16:21:43 -0000 1.1
+++ ServletContextAttributeEvent.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -90,7 +90,7 @@
}
/**
- * Returns the value of the attribute that has been added removed or replaced.
+ * Returns the value of the attribute that has been added, removed, or replaced.
* If the attribute was added, this is the value of the attribute. If the attrubute was
* removed, this is the value of the removed attribute. If the attribute was replaced, this
* is the old value of the attribute.
1.3 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContextListener.java
Index: ServletContextListener.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletContextListener.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ServletContextListener.java 5 Mar 2003 19:42:48 -0000 1.2
+++ ServletContextListener.java 18 Aug 2003 16:50:33 -0000 1.3
@@ -81,7 +81,7 @@
public void contextInitialized ( ServletContextEvent sce );
/** Notification that the servlet context is about to be shut down. All servlets
- have been dstroy()ed before any ServletContextListeners are notified of context
+ have been destroy()ed before any ServletContextListeners are notified of context
destruction. */
public void contextDestroyed ( ServletContextEvent sce );
}
1.2 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletOutputStream.java
Index: ServletOutputStream.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletOutputStream.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ServletOutputStream.java 13 Aug 2002 16:21:43 -0000 1.1
+++ ServletOutputStream.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -107,7 +107,7 @@
* character at the end.
*
*
- * @param s the <code>String</code to send to the client
+ * @param s the <code>String</code> to send to the client
*
* @exception IOException if an input or output exception occurred
*
1.6 +3 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletRequest.java
Index: ServletRequest.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletRequest.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- ServletRequest.java 11 Apr 2003 15:02:40 -0000 1.5
+++ ServletRequest.java 18 Aug 2003 16:50:33 -0000 1.6
@@ -567,7 +567,9 @@
*
* @return a <code>RequestDispatcher</code> object
* that acts as a wrapper for the resource
- * at the specified path
+ * at the specified path, or <code>null</code>
+ * if the servlet container cannot return a
+ * <code>RequestDispatcher</code>
*
* @see RequestDispatcher
* @see ServletContext#getRequestDispatcher
1.4 +42 -18 jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletResponse.java
Index: ServletResponse.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletResponse.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ServletResponse.java 22 Mar 2003 15:22:00 -0000 1.3
+++ ServletResponse.java 18 Aug 2003 16:50:33 -0000 1.4
@@ -235,9 +235,19 @@
* is equivalent with calling
* <code>setContentType</code> with the <code>String</code> of
* <code>text/html; charset=UTF-8</code>.
- * <p>This method has no effect if it is called after
+ * <p>This method can be called repeatedly to change the character
+ * encoding.
+ * This method has no effect if it is called after
* <code>getWriter</code> has been
* called or after the response has been committed.
+ * <p>Containers must communicate the character encoding used for
+ * the servlet response's writer to the client if the protocol
+ * provides a way for doing so. In the case of HTTP, the character
+ * encoding is communicated as part of the <code>Content-Type</code>
+ * header for text media types. Note that the character encoding
+ * cannot be communicated via HTTP headers if the servlet does not
+ * specify a content type; however, it is still used to encode text
+ * written via the servlet response's writer.
*
* @param charset a String specifying only the character set
* defined by IANA Character Sets
@@ -278,10 +288,16 @@
* The response's character encoding is only set from the given
* content type if this method is called before <code>getWriter</code>
* is called.
- * <p>This method has no effect if called after the response
+ * <p>This method may be called repeatedly to change content type and
+ * character encoding.
+ * This method has no effect if called after the response
* has been committed. It does not set the response's character
* encoding if it is called after <code>getWriter</code>
* has been called or after the response has been committed.
+ * <p>Containers must communicate the content type and the character
+ * encoding used for the servlet response's writer to the client if
+ * the protocol provides a way for doing so. In the case of HTTP,
+ * the <code>Content-Type</code> header is used.
*
* @param type a <code>String</code> specifying the MIME
* type of the content
@@ -418,26 +434,34 @@
/**
- * Sets the locale of the response, setting the
- * <code>Content-Language</code> header,
- * if the response has not been committed yet.
- * It also sets the response's character encoding appropriately
- * for the locale, if the character encoding has not been
- * explicitly set using {@link #setContentType} or
+ * Sets the locale of the response, if the response has not been
+ * committed yet. It also sets the response's character encoding
+ * appropriately for the locale, if the character encoding has not
+ * been explicitly set using {@link #setContentType} or
* {@link #setCharacterEncoding}, <code>getWriter</code> hasn't
* been called yet, and the response hasn't been committed yet.
- * If the deployment descriptor contains a
- * <code>locale-encoding-mapping-list</code> element,
- * and that element provides a mapping for the given locale,
- * that mapping is used. Otherwise, the mapping from locale to
- * character encoding is container dependent.
- * <p>This method has no effect if called after the response has been
- * committed. It does not set the response's character encoding if
- * it is called after <code>setContentType</code> has been called
- * with a charset specification, after
- * <code>setCharacterEncoding</code> has been called, after
+ * If the deployment descriptor contains a
+ * <code>locale-encoding-mapping-list</code> element, and that
+ * element provides a mapping for the given locale, that mapping
+ * is used. Otherwise, the mapping from locale to character
+ * encoding is container dependent.
+ * <p>This method may be called repeatedly to change locale and
+ * character encoding. The method has no effect if called after the
+ * response has been committed. It does not set the response's
+ * character encoding if it is called after {@link #setContentType}
+ * has been called with a charset specification, after
+ * {@link #setCharacterEncoding} has been called, after
* <code>getWriter</code> has been called, or after the response
* has been committed.
+ * <p>Containers must communicate the locale and the character encoding
+ * used for the servlet response's writer to the client if the protocol
+ * provides a way for doing so. In the case of HTTP, the locale is
+ * communicated via the <code>Content-Language</code> header,
+ * the character encoding as part of the <code>Content-Type</code>
+ * header for text media types. Note that the character encoding
+ * cannot be communicated via HTTP headers if the servlet does not
+ * specify a content type; however, it is still used to encode text
+ * written via the servlet response's writer.
*
* @param loc the locale of the response
*
1.2 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/UnavailableException.java
Index: UnavailableException.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/UnavailableException.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- UnavailableException.java 13 Aug 2002 16:21:43 -0000 1.1
+++ UnavailableException.java 18 Aug 2003 16:50:33 -0000 1.2
@@ -66,7 +66,7 @@
* that it is permanently or temporarily unavailable.
*
* <p>When a servlet or filter is permanently unavailable, something is wrong
- * with the it, and it cannot handle
+ * with it, and it cannot handle
* requests until some action is taken. For example, a servlet
* might be configured incorrectly, or a filter's state may be corrupted.
* The component should log both the error and the corrective action
1.4 +1 -1 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/Cookie.java
Index: Cookie.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/Cookie.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Cookie.java 29 Apr 2003 20:46:51 -0000 1.3
+++ Cookie.java 18 Aug 2003 16:50:33 -0000 1.4
@@ -387,7 +387,7 @@
* <p>The default value is <code>false</code>.
*
* @param flag if <code>true</code>, sends the cookie from the browser
- * to the server using only when using a secure protocol;
+ * to the server only when using a secure protocol;
* if <code>false</code>, sent on any protocol
*
* @see #getSecure
1.6 +3 -3 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServlet.java
Index: HttpServlet.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServlet.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- HttpServlet.java 28 Apr 2003 23:37:33 -0000 1.5
+++ HttpServlet.java 18 Aug 2003 16:50:33 -0000 1.6
@@ -831,10 +831,10 @@
*
* @exception IOException if an input or output error occurs
* while the servlet is handling the
- * TRACE request
+ * HTTP request
*
- * @exception ServletException if the request for the
- * TRACE cannot be handled
+ * @exception ServletException if the HTTP request cannot
+ * be handled
*
*
* @see javax.servlet.Servlet#service
1.5 +7 -7 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServletRequest.java
Index: HttpServletRequest.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServletRequest.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- HttpServletRequest.java 11 Apr 2003 15:02:40 -0000 1.4
+++ HttpServletRequest.java 18 Aug 2003 16:50:33 -0000 1.5
@@ -87,15 +87,15 @@
*/
public static final String BASIC_AUTH = "BASIC";
/**
- * String identifier for Basic authentication. Value "FORM"
+ * String identifier for Form authentication. Value "FORM"
*/
public static final String FORM_AUTH = "FORM";
/**
- * String identifier for Basic authentication. Value "CLIENT_CERT"
+ * String identifier for Client Certificate authentication. Value "CLIENT_CERT"
*/
public static final String CLIENT_CERT_AUTH = "CLIENT_CERT";
/**
- * String identifier for Basic authentication. Value "DIGEST"
+ * String identifier for Digest authentication. Value "DIGEST"
*/
public static final String DIGEST_AUTH = "DIGEST";
@@ -248,7 +248,7 @@
* this request contains. If the request has no
* headers, this method returns an empty enumeration.
*
- * <p>Some servlet containers do not allow do not allow
+ * <p>Some servlet containers do not allow
* servlets to access headers using this method, in
* which case this method returns <code>null</code>
*
@@ -420,7 +420,7 @@
* value of the CGI variable REMOTE_USER.
*
* @return a <code>String</code> specifying the login
- * of the user making this request, or <code>null</code
+ * of the user making this request, or <code>null</code>
* if the user login is not known
*
*/
@@ -509,7 +509,7 @@
* <td><td>/a.html
* <tr><td>HEAD /xyz?a=b HTTP/1.1<td><td>/xyz
* </table>
- *
+ *
* <p>To reconstruct an URL with a scheme and host, use
* {@link HttpUtils#getRequestURL}.
*
@@ -529,7 +529,7 @@
* The returned URL contains a protocol, server name, port
* number, and server path, but it does not include query
* string parameters.
- *
+ *
* <p>Because this method returns a <code>StringBuffer</code>,
* not a string, you can modify the URL easily, for example,
* to append query parameters.
1.5 +4 -4 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServletResponse.java
Index: HttpServletResponse.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServletResponse.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- HttpServletResponse.java 22 Apr 2003 15:18:01 -0000 1.4
+++ HttpServletResponse.java 18 Aug 2003 16:50:33 -0000 1.5
@@ -135,7 +135,7 @@
* includes the logic to determine whether the session ID
* needs to be encoded in the URL. Because the rules for making
* this determination can differ from those used to decide whether to
- * encode a normal link, this method is seperate from the
+ * encode a normal link, this method is separete from the
* <code>encodeURL</code> method.
*
* <p>All URLs sent to the <code>HttpServletResponse.sendRedirect</code>
@@ -338,7 +338,7 @@
* Sets the status code for this response. This method is used to
* set the return status code when there is no error (for example,
* for the status codes SC_OK or SC_MOVED_TEMPORARILY). If there
- * is an error, and the caller wishes to invoke an <error-page> defined
+ * is an error, and the caller wishes to invoke an error-page defined
* in the web applicaion, the <code>sendError</code> method should be used
* instead.
* <p> The container clears the buffer and sets the Location header, preserving
@@ -546,7 +546,7 @@
* Status code (406) indicating that the resource identified by the
* request is only capable of generating response entities which have
* content characteristics not acceptable according to the accept
- * headerssent in the request.
+ * headers sent in the request.
*/
public static final int SC_NOT_ACCEPTABLE = 406;
@@ -560,7 +560,7 @@
/**
* Status code (408) indicating that the client did not produce a
- * requestwithin the time that the server was prepared to wait.
+ * request within the time that the server was prepared to wait.
*/
public static final int SC_REQUEST_TIMEOUT = 408;
1.4 +2 -2 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpSession.java
Index: HttpSession.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpSession.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- HttpSession.java 7 Apr 2003 21:27:36 -0000 1.3
+++ HttpSession.java 18 Aug 2003 16:50:33 -0000 1.4
@@ -92,7 +92,7 @@
* the session has been invalidatd or expired.
*
* <p> When container migrates a session between VMs in a distributed container
- * setting, all session atributes implementing the {@link HttpSessionActivationListener}
+ * setting, all session attributes implementing the {@link HttpSessionActivationListener}
* interface are notified.
*
* <p>A servlet should be able to handle cases in which
@@ -165,7 +165,7 @@
*
* Returns the last time the client sent a request associated with
* this session, as the number of milliseconds since midnight
- * January 1, 1970 GMT, and marked by the time the container recieved the request.
+ * January 1, 1970 GMT, and marked by the time the container received the request.
*
* <p>Actions that your application takes, such as getting or setting
* a value associated with the session, do not affect the access
1.3 +2 -2 jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpSessionListener.java
Index: HttpSessionListener.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpSessionListener.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- HttpSessionListener.java 5 Mar 2003 19:42:48 -0000 1.2
+++ HttpSessionListener.java 18 Aug 2003 16:50:33 -0000 1.3
@@ -63,9 +63,9 @@
import java.util.EventListener;
/**
- * Implementations of this interface may are notified of changes to the
+ * Implementations of this interface are notified of changes to the
* list of active sessions in a web application.
- * To recieve notification events, the implementation class
+ * To receive notification events, the implementation class
* must be configured in the deployment descriptor for the web application.
* @see HttpSessionEvent
* @since v 2.3
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org