Tomcat Comet

sqtsqt

　　Comet支持允许一个servlet异步处理IO，当数据在连接上可读的时候（而不是使用阻塞读）和连接异步（最有可能的是来自一些其它原引发的事件）写回数据的时候接收事件。
CometEvent
　　　实现了org.apache.catalina.CometProcessor接口的Sevlets有他们的事件激活方法而不是使用平常的服务方法，依照谁发生的事件。事件对象引发存取通常的request和respose对象，它可能使用平常的方式。重要的区别是这些对象在任何时候保持有效和全功能，在事件BEGIN开始到END或者ERROR事件结束。下面是这些事件类型:
◆ EventType.BEGIN: 在连接处理开始将被调用。它能被用来初始化任何在request和response对象中使用的相关字段。在这个事件处理之后和结束处理开始或者错误事件之间，是可以使用response对象来在连接上进行异步写。注意，reponse对象和依靠的 OutputStream和Writer仍然不是同步的,因此当多个线程存取的时候，同步是强制的。在初始事件处理之后，request才会提交。
◆ EventType.READ: 这个指示输入数据可以用了，可以无阻塞的读了。可用的和InputStream或者Read的读方法可以用来决定是否有阻塞风险: servlet会读报告可用的数据，还进一步读取可用的数据。当遇到读错误的时候，servlet通过抛出异常来报告它。抛出异常会导致一个错误事件被激活，连接会被关闭。另外，可以捕捉异常，清理sevlet用到的数据结构，然后调用事件的close方法。尝试读取这个方法执行的request对象的数据是不允许的。
　　在一些平台上，例如Windows，一个客户端断开会有一个READ事件。从流读数据可能返回-1, IOException 或者 EOFException。确认你处理了所有这三种情况。如果你没有处理，Tomcat会立刻抛出你改捕捉事件，这个时候你会被通知错误。
◆ EventType.END:request结束时调用。在开始方法中初始化的德字段会被重置。在这个事件处理之后，request和response对象， 还有哪些依赖的对象，会被重新使用，用来处理其它的请求。 End在 数据可用和读文件结束的时候也会被调用。
◆ EventType.ERROR: 当容器在连接上遇到IO错误或者类似不可恢复的错误时，这个错误出现。在begin方法初始化的数据会被重置。这个事件处理之后，request和response对象，还有一些依赖的对象，会被重新被其它请求使用。
这些事事件子类型，允许更详细的事件处理 (注意: 一些事件需要使用org.apache.catalina.valves.CometConnectionManagerValve 值):
◆ EventSubType.TIMEOUT: 连接超时 (ERROR子类型);注意这个错误类型不是致命的，连接不会被关闭除非servlet使用了事件的close方法.
◆ EventSubType.CLIENT_DISCONNECT:客户端连接被关闭(ERROR子类型).事件的方法.
◆ EventSubType.IOEXCEPTION: 一个IO异常发生, 例如无效内容,一个无效的大块 (ERROR子类型).
◆ EventSubType.WEBAPP_RELOAD: web程序正在被重新加载T(END子类型).
◆ EventSubType.SESSION_END: sevlet结束会话 (END子类型).
　　　就像上面描述的，典型的Comet请求生命周期将会包含一系列的事件：BEGIN -> READ -> READ -> READ -> ERROR/TIMEOUT. 在任何时候，servlet可以使用事件对象的close方法关闭请求的处理。
CometFilter
类似普通的过滤器，一个过滤器链会被激活当comet事件处理的时候。这些过滤器要应用CometFilter接口(他和平常的过滤器接口一样)，要被声明和影射在部署描述符中，和常规过滤器相同的方式。当处理一个事件的时候，过滤器链仅仅包括哪些匹配所使用影射规则的过滤器，也要实现 CometFiler接口.