Servlet 3.0 之 应用生命周期事件

一、介绍

应用事件设施给予Web应用开发者在ServletContext，HttpSession和ServletRequest 的生命周期上有更强的控制，允许更好的代码分解，以及增强管理Web应用使用的资源的效率。

二、事件监听者

应用事件监听器是实现了一个或者多个servlet事件监听者接口的类。它们在Web应用部署期间被实例化和注册到一个Web容器中。它们被开发者部署在WAR中。

Servlet事件监听者支持ServletContext，HttpSession和ServletRequest 对象状态改变时的事件通知。

• Servlet上下文监听者被用来为应用在JVM层管理资源或者保持状态。
• HTTP会话监听者被用来管理状态或者与一系列来自相同客户端或用户请求关联的资源。
• Servlet请求监听器被用来管理servlet请求的生命周期之间的状态。
• 异步监听器被用来管理异步事件，比如超时和异步处理的完成。

可以有多个监听每个事件类型的监听器类。以及开发者可以为每一个事件类型指定容器调用监听器beans的顺序。

1. 事件类型和监听器接口
   事件类型和用来监控它们的监听者接口被展示在下述表中：
   Table 2-1 Servlet上下文事件

Event Type	Description	listener Interface
LifeCycle	servlet上下文已经被创建并且可以服务它的第一个请求，或者servlet上下文正打算关闭。	javax.servlet.ServletContextListener
属性的改变	servlet上下文上的属性已经被添加、移除或者替换	javax.servlet.ServletContextAttributeListener

Table 2-2 HTTP会话事件

Event Type	Description	listener Interface
LifeCycle	一个HttpSession已经被创建、失效或者超时	javax.servlet.http.HttpSessionListener
属性的改变	属性在HttpSession上被添加、移除或者替换	javax.servlet.http.HttpSessionAttributeListener
会话迁移	HttpSession已经被激活或者钝化	javax.servlet.http.HttpSessionActivationListener
对象绑定	对象已经被绑定到或者从HttpSession上解绑	javax.servlet.http.HttpSessionBindingListener

Table 2-3 Servlet请求事件

Event Type	Description	listener Interface
LifeCycle	一个servlet已经开始被Web组件处理	javax.servlet.ServletRequestListener
属性改变	属性在ServletRequest上被添加、移除或者替代	javax.servlet.ServletRequestAttributeListener
异步事件	一个超时、连接终止或者异步处理完成	javax.servlet.AsyncListener

对于API的详情，请参考API文档。

1. 监听器使用的例子
   为了说明事件机制的使用，考虑一个包含利用数据库的一些servlets的简单的Web应用。开发者为了管理数据库连接，提供了一个servlet上下文监听器类。
2. 当应用启动，监听器类被通知。应用会记录数据库的日志，并且在servlet上下文中存储连接。
3. 应用中的Servlets按需在Web应用的活动期间访问连接。
4. 当Web服务器被关闭，或者应用从Web服务器中移除，监听器类被通知，并且数据库连接被关闭。

三、监听器类配置

1. 监听器类的规定
   Web应用的开发者提供实现了javax.servlet API中一个或者多个监听器接口的监听器类。每一个监听器必须有一个无参的public构造函数。监听器类被打包进WAR，或者放在WEB-INF/classes 归档入口，或者在JAR文件中的WEB-INF/lib 目录。
2. 部署声明
   监听器类在部署描述符中使用元素声明。它们依据类名字按照被调用的顺序列出来。不像其它监听器，AsyncListener类型的监听器仅能通过编程式地注册(用一个ServletRequest)。
3. 监听器注册
   Web容器为每个监听器类创建一个实例，并且在应用的第一个请求被处理之前为事件通知被注册。
4. 关闭时通知
   在应用关闭时，监听器按照它们的声明的顺序反序被通知，在通知上下文监听器之前通知会话监听器。会话监听器必须在上下文监听器被通知关闭之前被通知到会话失效。

四、部署描述符例子

下面例子是注册两个servlet上下文生命周期监听器和一个HttpSession监听器的部署语法。
假设com.acme.MyConnectionManager和com.acme.MyLoggingModule都实现了javax.servlet.ServletContextListener。
com.acme.MyLoggingModule额外还实现了javax.servlet.http.HttpSessionListener。而且开发者想com.acme.MyConnectionManager在com.acme.MyLoggingMudule之前被通知servlet上下文生命周期事件。这是这个应用的部署描述符：

  MyListenerApplication
  
    com.acme.MyConnectionManager
  
  
    com.acme.MyLogginModule
  
  
    RegistrationServlet
    ...etc
  

五、监听器实例和线程

容器被要求在应用中第一个请求开始执行之前，完成Web应用中监听器类的实例化。容器必须维护对每个监听器实例的引用，直到最后一个请求被服务。
ServletContext和HttpSession对象的属性改变可能同时出现。容器不要求同步通知属性监听器类。保持状态的监听器类负责数据的汇总，并且应该明确处理这种场景。

六、监听器异常

在监听器中的应用代码可能在操作期间抛出一个异常。一些监听器通知会出现在Web应用中其它组件的调用树下。这样的例子就如设置一个session属性，session监听器会抛出一个未处理异常。容器必须允许未处理异常被错误页面机制处理。如果没有对应那些异常的错误页面，容器必须确保发回一个状态码是500的response。这种情况下，那个事件下不会再有监听器被调用了。

一些异常并不会在应用中其它组件的调用栈下出现。这样的例子就是一个接收一个会话超时和抛出未处理异常通知的SessionListener，或者在servlet上下文初始化的通知期间抛出一个未处理异常的ServletContextListener，或者在初始化通知期间抛出未处理异常的ServletRequestListener或者请求对象的析构函数。这种场景中，开发者没有机会处理异常。容器可以用HTTP 500状态码响应Web应用的所有后续请求，表明一个应用错误。

在一个监听器产生一个异常后还期望正常处理出现的开发者必须处理在通知函数里处理他们自己的异常。

七、分布式容器

在分布式Web容器中，HttpSession实例范围被限制在某个服务会话请求的特殊JVM中，并且ServletContext对象范围被限制在Web容器的JVM中。分布式容器不要求传递servlet上下文事件或者HttpSession事件给其它JVMs。监听者类实例范围被限制在单个JVM中的单个部署描述符声明中。

八、会话事件

监听者类给开发者提供了一种追踪Web应用中会话的方式。因为容器使会话超时或者因为应用中一个Web组件调用invalidate方法，追踪会话来知道一个会话是否变非法非常有用。区别可以使用监听器和HttpSession API方法间接决定。

翻译自 Java Servlet Specification
Version 3.0 Rev a
Author:Rajiv Mordani
Date: December 2010