From 984547a15480a58b5ebd513301804c681e6355fc Mon Sep 17 00:00:00 2001 From: remm Date: Tue, 3 Apr 2007 14:14:30 +0000 Subject: [PATCH] - Merge from javadoc. git-svn-id: https://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk@525161 13f79535-47bb-0310-9956-ffa450edef68 --- webapps/docs/aio.xml | 42 +++++++++++++++++++++++++++++++++--------- 1 file changed, 33 insertions(+), 9 deletions(-) diff --git a/webapps/docs/aio.xml b/webapps/docs/aio.xml index d3e039df4..019c3db93 100644 --- a/webapps/docs/aio.xml +++ b/webapps/docs/aio.xml @@ -63,14 +63,16 @@ synchronization is mandatory. After processing the initial event, the request is considered to be committed.
  • EventType.READ: This indicates that input data is available, and that one read can be made - 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. 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, 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.
  • EventType.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 @@ -79,7 +81,29 @@ or a similar unrecoverable error occurs on the connection. 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 - objects will be recycled and used to process other requests.
    • + objects will be recycled and used to process other requests. + + +

    + There are some event subtypes which allow finer processing of events (note: some of these + events require usage of the org.apache.catalina.valves.CometConnectionManagerValve valve): +

    + +

    -- 2.11.0