svn commit: r1492579 - in /tomcat/trunk/java/javax/servlet: ReadListener.java WriteListener.java

[ma...@apache.org]

Author: markt
Date: Thu Jun 13 09:04:00 2013
New Revision: 1492579

URL: http://svn.apache.org/r1492579
Log:
Servlet 3.1 Javadoc updates

Modified:
    tomcat/trunk/java/javax/servlet/ReadListener.java
    tomcat/trunk/java/javax/servlet/WriteListener.java

Modified: tomcat/trunk/java/javax/servlet/ReadListener.java
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/ReadListener.java?rev=1492579&r1=1492578&r2=1492579&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/ReadListener.java (original)
+++ tomcat/trunk/java/javax/servlet/ReadListener.java Thu Jun 13 09:04:00 2013
@@ -19,7 +19,7 @@ package javax.servlet;
 import java.io.IOException;
 
 /**
- * Receives notification of read events when using the non-blocking IO.
+ * Receives notification of read events when using non-blocking IO.
  *
  * @since Servlet 3.1
  */
@@ -28,7 +28,7 @@ public interface ReadListener extends ja
     /**
      * Invoked when data is available to read. The container will invoke this
      * method the first time for a request as soon as there is data to read.
-     * Subsequent invocations will only if a call to
+     * Subsequent invocations will only occur if a call to
      * {@link ServletInputStream#isReady()} has returned false and data has
      * subsequently become available to read.
      *

Modified: tomcat/trunk/java/javax/servlet/WriteListener.java
URL: http://svn.apache.org/viewvc/tomcat/trunk/java/javax/servlet/WriteListener.java?rev=1492579&r1=1492578&r2=1492579&view=diff
==============================================================================
--- tomcat/trunk/java/javax/servlet/WriteListener.java (original)
+++ tomcat/trunk/java/javax/servlet/WriteListener.java Thu Jun 13 09:04:00 2013
@@ -19,10 +19,27 @@ package javax.servlet;
 import java.io.IOException;
 
 /**
- * TODO SERVLET 3.1
+ * Receives notification of write events when using non-blocking IO.
  *
+ * @since Servlet 3.1
  */
 public interface WriteListener extends java.util.EventListener{
+
+    /**
+     * Invoked when it it possible to write data without blocking. The container
+     * will invoke this method the first time for a request as soon as data can
+     * be written. Subsequent invocations will only occur if a call to
+     * {@link ServletOutputStream#isReady()} has returned false and it has since
+     * become possible to write data.
+     *
+     * @throws IOException
+     */
     public void onWritePossible() throws IOException;
+
+    /**
+     * Invoked if an error occurs while writing the response.
+     *
+     * @param throwable
+     */
     public void onError(java.lang.Throwable throwable);
 }
\ No newline at end of file



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