tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From r...@apache.org
Subject svn commit: r524974 - /tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java
Date Mon, 02 Apr 2007 23:54:06 GMT
Author: remm
Date: Mon Apr  2 16:54:06 2007
New Revision: 524974

URL: http://svn.apache.org/viewvc?view=rev&rev=524974
Log:
- Fix javadocs (no return false anymore).

Modified:
    tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java

Modified: tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java
URL: http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java?view=diff&rev=524974&r1=524973&r2=524974
==============================================================================
--- tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java (original)
+++ tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java Mon Apr  2 16:54:06 2007
@@ -48,11 +48,13 @@
      *  without blocking. The available and ready methods of the InputStream or
      *  Reader may be used to determine if there is a risk of blocking: the servlet
      *  should read while data is reported available, and can make one additional read
-     *  without blocking. When encountering a read error or an EOF, the servlet MUST
-     *  report it by either returning false or throwing an exception such as an 
-     *  IOException. This will cause the error event to be invoked, and the connection
-     *  will be closed. It is not allowed to attempt reading data from the request object
-     *  outside of the execution of this method.
+     *  without blocking. When encountering a read error, the servlet should
+     *  report it by propagating the exception properly. Throwing an exception will 
+     *  cause the error event to be invoked, and the connection will be closed. 
+     *  Alternately, it is also possible to catch any exception, perform clean up
+     *  on any data structure the servlet may be using, and using the close method
+     *  of the event. It is not allowed to attempt reading data from the request 
+     *  object outside of the execution of this method.
      * END - End may be called to end the processing of the request. Fields that have
      *  been initialized in the begin method should be reset. After this event has
      *  been processed, the request and response objects, as well as all their dependent



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


Mime
View raw message