From dev-return-79969-apmail-tomcat-dev-archive=tomcat.apache.org@tomcat.apache.org Mon Apr 02 23:54:34 2007 Return-Path: Delivered-To: apmail-tomcat-dev-archive@www.apache.org Received: (qmail 95005 invoked from network); 2 Apr 2007 23:54:32 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 2 Apr 2007 23:54:32 -0000 Received: (qmail 91475 invoked by uid 500); 2 Apr 2007 23:54:36 -0000 Delivered-To: apmail-tomcat-dev-archive@tomcat.apache.org Received: (qmail 91200 invoked by uid 500); 2 Apr 2007 23:54:35 -0000 Mailing-List: contact dev-help@tomcat.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Tomcat Developers List" Delivered-To: mailing list dev@tomcat.apache.org Received: (qmail 91189 invoked by uid 500); 2 Apr 2007 23:54:35 -0000 Delivered-To: apmail-jakarta-tomcat-dev@jakarta.apache.org Received: (qmail 91186 invoked by uid 99); 2 Apr 2007 23:54:35 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Apr 2007 16:54:35 -0700 X-ASF-Spam-Status: No, hits=-99.5 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 02 Apr 2007 16:54:27 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id 07E751A9838; Mon, 2 Apr 2007 16:54:07 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r524974 - /tomcat/tc6.0.x/trunk/java/org/apache/catalina/CometEvent.java Date: Mon, 02 Apr 2007 23:54:06 -0000 To: tomcat-dev@jakarta.apache.org From: remm@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20070402235407.07E751A9838@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org 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