svn commit: r1392639 - in /tomcat/trunk/java/javax/servlet: ServletInputStream.java ServletOutputStream.java ServletRequest.java

[markt]

Author: markt
Date: Mon Oct  1 21:38:29 2012
New Revision: 1392639

URL: http://svn.apache.org/viewvc?rev=1392639&view=rev
Log:
Fix Javadoc warnings

Modified:
    tomcat/trunk/java/javax/servlet/ServletInputStream.java
    tomcat/trunk/java/javax/servlet/ServletOutputStream.java
    tomcat/trunk/java/javax/servlet/ServletRequest.java

Modified: tomcat/trunk/java/javax/servlet/ServletInputStream.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/ServletInputStream.java?rev=1392639&r1=1392638&r2=1392639&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/ServletInputStream.java (original)
+++ tomcat/trunk/java/javax/servlet/ServletInputStream.java Mon Oct  1 21:38:29 
2012
@@ -84,14 +84,14 @@ public abstract class ServletInputStream
 
     /**
      * TODO SERVLET 3.1
-     * @return
+     * @return  TODO
      */
     public abstract int dataAvailable();
 
 
     /**
      * TODO SERVLET 3.1
-     * @return
+     * @return  TODO
      */
     public abstract boolean isFinished();
 
@@ -99,7 +99,7 @@ public abstract class ServletInputStream
      * TODO SERVLET 3.1
      * If this returns false, the container will invoke
      * {@link ReadListener#onDataAvailable()} when data is available.
-     * @return
+     * @return  TODO
      */
     public abstract boolean isReady();
 

Modified: tomcat/trunk/java/javax/servlet/ServletOutputStream.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/ServletOutputStream.java?rev=1392639&r1=1392638&r2=1392639&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/ServletOutputStream.java (original)
+++ tomcat/trunk/java/javax/servlet/ServletOutputStream.java Mon Oct  1 
21:38:29 2012
@@ -276,7 +276,7 @@ public abstract class ServletOutputStrea
      * If this returns false, it will cause a callback to
      * {@link WriteListener#onWritePossible()} when the buffer has emptied
      * TODO SERVLET 3.1
-     * @return
+     * @return  TODO
      */
     public abstract boolean canWrite();
 

Modified: tomcat/trunk/java/javax/servlet/ServletRequest.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/ServletRequest.java?rev=1392639&r1=1392638&r2=1392639&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/ServletRequest.java (original)
+++ tomcat/trunk/java/javax/servlet/ServletRequest.java Mon Oct  1 21:38:29 2012
@@ -105,13 +105,17 @@ public interface ServletRequest {
      * same as the value of the CGI variable CONTENT_LENGTH.
      *
      * @return an integer containing the length of the request body or -1 if 
the
-     *         length is not known
+     *         length is not known or is greater than {@link Integer#MAX_VALUE}
      */
     public int getContentLength();
 
     /**
-     * TODO SERVLET 3.1
-     * @return
+     * Returns the length, in bytes, of the request body and made available by
+     * the input stream, or -1 if the length is not known. For HTTP servlets,
+     * same as the value of the CGI variable CONTENT_LENGTH.
+     *
+     * @return a long integer containing the length of the request body or -1 
if
+     *         the length is not known
      */
     public long getContentLengthLong();
 



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