Hi,
The attached patch is to update the Servlet 2.4 API as follows:
1) Add "@since 2.4" into the added methods in:
jsr154/src/share/javax/servlet/ServletRequest.java
jsr154/src/share/javax/servlet/ServletRequestWrapper.java
jsr154/src/share/javax/servlet/ServletResponse.java
jsr154/src/share/javax/servlet/ServletResponseWrapper.java
jsr154/src/share/javax/servlet/http/HttpSession.java
2) Add "summary" in the <table>
jsr154/src/share/javax/servlet/http/HttpServletRequest.java
--------------
Yutaka Yoshida
Java/XML Software Group
Sun Microsystems Inc.
Index: jsr154/src/share/javax/servlet/ServletRequest.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletRequest.java,v
retrieving revision 1.3
diff -u -r1.3 ServletRequest.java
--- jsr154/src/share/javax/servlet/ServletRequest.java 5 Mar 2003 19:42:48 -0000
1.3
+++ jsr154/src/share/javax/servlet/ServletRequest.java 20 Mar 2003 21:50:06 -0000
@@ -592,6 +592,8 @@
/**
* Returns the Internet Protocol (IP) source port of the client
* or last proxy that sent the request.
+ *
+ * @since 2.4
*/
public int getRemotePort();
@@ -602,6 +604,8 @@
*
* @return a <code>String</code> containing the host
* name of the IP on which the request was received.
+ *
+ * @since 2.4
*/
public String getLocalName();
@@ -612,6 +616,8 @@
* @return a <code>String</code> containing the
* IP address on which the request was received.
*
+ * @since 2.4
+ *
*/
public String getLocalAddr();
@@ -621,6 +627,8 @@
* on which the request was received.
*
* @return an integer specifying the port number
+ *
+ * @since 2.4
*/
public int getLocalPort();
Index: jsr154/src/share/javax/servlet/ServletRequestWrapper.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletRequestWrapper.java,v
retrieving revision 1.3
diff -u -r1.3 ServletRequestWrapper.java
--- jsr154/src/share/javax/servlet/ServletRequestWrapper.java 5 Mar 2003 19:42:48
-0000 1.3
+++ jsr154/src/share/javax/servlet/ServletRequestWrapper.java 20 Mar 2003 21:50:06
-0000
@@ -403,6 +403,8 @@
/**
* The default behavior of this method is to return
* getRemotePort() on the wrapped request object.
+ *
+ * @since 2.4
*/
public int getRemotePort(){
return this.request.getRemotePort();
@@ -412,6 +414,8 @@
/**
* The default behavior of this method is to return
* getLocalName() on the wrapped request object.
+ *
+ * @since 2.4
*/
public String getLocalName(){
return this.request.getLocalName();
@@ -420,6 +424,8 @@
/**
* The default behavior of this method is to return
* getLocalAddr() on the wrapped request object.
+ *
+ * @since 2.4
*/
public String getLocalAddr(){
return this.request.getLocalAddr();
@@ -429,6 +435,8 @@
/**
* The default behavior of this method is to return
* getLocalPort() on the wrapped request object.
+ *
+ * @since 2.4
*/
public int getLocalPort(){
return this.request.getLocalPort();
Index: jsr154/src/share/javax/servlet/ServletResponse.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletResponse.java,v
retrieving revision 1.2
diff -u -r1.2 ServletResponse.java
--- jsr154/src/share/javax/servlet/ServletResponse.java 5 Mar 2003 19:42:48 -0000
1.2
+++ jsr154/src/share/javax/servlet/ServletResponse.java 20 Mar 2003 21:50:06 -0000
@@ -149,6 +149,8 @@
* content type, for example,
* <code>text/html; charset=UTF-8</code>,
* or null
+ *
+ * @since 2.4
*/
public String getContentType();
@@ -243,6 +245,8 @@
*
* @see #setContentType
* #setLocale
+ *
+ * @since 2.4
*
*/
Index: jsr154/src/share/javax/servlet/ServletResponseWrapper.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/ServletResponseWrapper.java,v
retrieving revision 1.1.1.1
diff -u -r1.1.1.1 ServletResponseWrapper.java
--- jsr154/src/share/javax/servlet/ServletResponseWrapper.java 13 Aug 2002 16:21:43
-0000 1.1.1.1
+++ jsr154/src/share/javax/servlet/ServletResponseWrapper.java 20 Mar 2003 21:50:06
-0000
@@ -120,6 +120,8 @@
/**
* The default behavior of this method is to call setCharacterEncoding(String
charset)
* on the wrapped response object.
+ *
+ * @since 2.4
*/
public void setCharacterEncoding(String charset) {
@@ -176,6 +178,8 @@
/**
* The default behavior of this method is to return getContentType()
* on the wrapped response object.
+ *
+ * @since 2.4
*/
public String getContentType() {
Index: jsr154/src/share/javax/servlet/http/HttpServletRequest.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpServletRequest.java,v
retrieving revision 1.2
diff -u -r1.2 HttpServletRequest.java
--- jsr154/src/share/javax/servlet/http/HttpServletRequest.java 5 Mar 2003 19:42:48
-0000 1.2
+++ jsr154/src/share/javax/servlet/http/HttpServletRequest.java 20 Mar 2003 21:50:06
-0000
@@ -501,7 +501,7 @@
*
*
- * <table>
+ * <table summary="Examples of Returned Values">
* <tr align=left><th>First line of HTTP request </th>
* <th> Returned Value</th>
* <tr><td>POST /some/path.html HTTP/1.1<td><td>/some/path.html
Index: jsr154/src/share/javax/servlet/http/HttpSession.java
===================================================================
RCS file:
/home/cvspublic/jakarta-servletapi-5/jsr154/src/share/javax/servlet/http/HttpSession.java,v
retrieving revision 1.1.1.1
diff -u -r1.1.1.1 HttpSession.java
--- jsr154/src/share/javax/servlet/http/HttpSession.java 13 Aug 2002 16:21:46
-0000 1.1.1.1
+++ jsr154/src/share/javax/servlet/http/HttpSession.java 20 Mar 2003 21:50:07
-0000
@@ -474,6 +474,8 @@
*
* @exception IllegalStateException if this method is called on an
* already invalidated session
+ *
+ * @since 2.4
*/
public void logout();
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]