dannyc 01/07/10 13:44:54
Modified: src/share/javax/servlet ServletContext.java
ServletRequest.java
src/share/javax/servlet/http Cookie.java
HttpServletResponse.java
HttpSessionBindingListener.java
Log:
All typos and editorial changes in javadocs, except for the addition of status code
307 to the HttpServletResponse as per the Servlet 2.2 errata.
Revision Changes Path
1.4 +1 -1 jakarta-servletapi-4/src/share/javax/servlet/ServletContext.java
Index: ServletContext.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-4/src/share/javax/servlet/ServletContext.java,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ServletContext.java 2001/04/24 20:20:37 1.3
+++ ServletContext.java 2001/07/10 20:44:47 1.4
@@ -147,7 +147,7 @@
/**
* Returns the minor version of the Servlet API that this
* servlet container supports. All implementations that comply
- * with Version 2.2 must have this method
+ * with Version 2.3 must have this method
* return the integer 3.
*
* @return 3
1.3 +10 -6 jakarta-servletapi-4/src/share/javax/servlet/ServletRequest.java
Index: ServletRequest.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-4/src/share/javax/servlet/ServletRequest.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- ServletRequest.java 2001/04/24 20:20:38 1.2
+++ ServletRequest.java 2001/07/10 20:44:48 1.3
@@ -195,7 +195,7 @@
*
* @return a <code>String</code> containing the name
* of the MIME type of
- * the request, or -1 if the type is not known
+ * the request, or null if the type is not known
*
*/
@@ -380,7 +380,7 @@
* Retrieves the body of the request as character data using
* a <code>BufferedReader</code>. The reader translates the character
* data according to the character encoding used on the body.
- * Either this method or {@link #getReader} may be called to read the
+ * Either this method or {@link #getInputStream} may be called to read the
* body, not both.
*
*
@@ -422,12 +422,13 @@
/**
* Returns the fully qualified name of the client that sent the
- * request, or the IP address of the client if the name cannot be
- * determined. For HTTP servlets, same as the value of the CGI variable
+ * request. If the engine cannot or chooses not to resolve the hostname
+ * (to improve performance), this method returns the dotted-string form of
+ * the IP address. For HTTP servlets, same as the value of the CGI variable
* <code>REMOTE_HOST</code>.
*
- * @return a <code>String</code> containing the fully qualified
name
- * of the client
+ * @return a <code>String</code> containing the fully
+ * qualified name of the client
*
*/
@@ -446,6 +447,9 @@
* package names. Names beginning with <code>java.*</code>,
* <code>javax.*</code>, and <code>com.sun.*</code>, are
* reserved for use by Sun Microsystems.
+ *<br> If the value passed in is null, the effect is the same as
+ * calling {@link #removeAttribute}.
+ *
*
*
* @param name a <code>String</code> specifying
1.2 +2 -2 jakarta-servletapi-4/src/share/javax/servlet/http/Cookie.java
Index: Cookie.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi-4/src/share/javax/servlet/http/Cookie.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Cookie.java 2001/01/09 03:24:18 1.1
+++ Cookie.java 2001/07/10 20:44:51 1.2
@@ -405,8 +405,8 @@
* only over a secure protocol, or <code>false</code> if the
* browser can send cookies using any protocol.
*
- * @return <code>true</code> if the browser can use
- * any standard protocol; otherwise, <code>false</code>
+ * @return <code>true</code> if the browser uses a secure
protocol;
+ * otherwise, <code>true</code>
*
* @see #setSecure
*
1.3 +9 -0
jakarta-servletapi-4/src/share/javax/servlet/http/HttpServletResponse.java
Index: HttpServletResponse.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-4/src/share/javax/servlet/http/HttpServletResponse.java,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- HttpServletResponse.java 2001/04/12 19:41:13 1.2
+++ HttpServletResponse.java 2001/07/10 20:44:52 1.3
@@ -471,6 +471,15 @@
public static final int SC_USE_PROXY = 305;
+ /**
+ * Status code (307) indicating that the requested resource
+ * resides temporarily under a different URI. The temporary URI
+ * <em>SHOULD</em> be given by the <code><em>Location</em></code>
+ * field in the response.
+ */
+
+ public static final int SC_TEMPORARY_DIRECT = 307;
+
/**
* Status code (400) indicating the request sent by the client was
* syntactically incorrect.
1.2 +1 -1
jakarta-servletapi-4/src/share/javax/servlet/http/HttpSessionBindingListener.java
Index: HttpSessionBindingListener.java
===================================================================
RCS file:
/home/cvs/jakarta-servletapi-4/src/share/javax/servlet/http/HttpSessionBindingListener.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- HttpSessionBindingListener.java 2001/01/09 03:24:20 1.1
+++ HttpSessionBindingListener.java 2001/07/10 20:44:52 1.2
@@ -72,7 +72,7 @@
* or unbound from a session. The object is notified
* by an {@link HttpSessionBindingEvent} object. This may be as a result
* of a servlet programmer explicitly unbinding an attribute from a session,
- * due to a session being invalidated, or die to a session timing out.
+ * due to a session being invalidated, or due to a session timing out.
*
*
* @author Various
