javaee listener 介绍

Servlet介绍-listener

一、 listener

在Web项目中，我们可以使用Listener接口来监听Container的中一些对象状态的变化，并且根据这些对象的状态的变化做出相应的响应。

在Servlet 2.4和JSP 2.0 规范中一共有八个listener接口和六个event事件类。

当一个事件发生的时候我们可以使用listener中的某个方法去对事件做出相应的响应，这些方法的参数都是java.util.EventObject的子类。

这些Listener与其方法对应的Event参数类型如下图：

上图详细描述了八个listener接口和与其对应的event类

我们大致可以把八个listener分成三类，分别为与ServletContext、HttpSession、ServletRuquest相关的listener，在上图中已经使用不同的底色进行标注。

 

由于listener在实际的应用中好像不如预计的广泛，所以底下只简单介绍接口、方法、参数和注意点(统计在线人数和在线人员名单也许是用的最多的使用listener的实现了)。

 

好了，让我们从与ServletContext相关的两个接口开始吧

 

首先ServletContext是整个Web应用的上下文，所以这个对象里存放的应该是和整个Web应用相关的东西(在线人数明显很符合这个特点)

 

ServletContextListener

 

void contextInitialized(ServletContextEvent sce)

这个方法在Container初始化整个Web应用时调用，运行在该Web应用中servlet和filter初始化之前

 

void contextDestroyed(ServletContextEvent sce)

这个方法在Container卸载整个Web应用时调用，运行在该Web应用中servlet和filter的destroy()方法之后

 

ServletContextAttributeListener

 

void attributeAdded(ServletContextAttributeEvent scab)

这个方法在通过ServletContext的void setAttribute(String name, Object object)向ServletContext新添加一个name为名，object为值得对象之后被调用

void attributeReplaced(ServletContextAttributeEvent scab)

这个方法在通过ServletContext的void setAttribute(String name, Object object)替换ServletContext中name对应的值之后被调用

void attributeRemoved(ServletContextAttributeEvent scab)

这个方法在通过ServletContext的void removeAttribute(String name)删除ServletContext中以name为名的键值对之后或者ServletContext被销毁之前被调用。

 

ServletContextAttributeEvent提供两个方法：

String getName()返回键值对的名也就是name。

Object getValue()这个方法，在attributeAdded中返回新添的键值对的值；在attributeReplaced和中attributeRemoved返回原键值对的值。

 

 

HttpSessionListener

 

void sessionCreated(HttpSessionEvent se)

当一个session被创建之后，容器调用此方法。

void sessionDestroyed(HttpSessionEvent se)

当一个session将要被销毁时，容器调用此方法。

 

HttpSessionEvent只有一个方法HttpSession getSession()，该方法返回对应的session。

 

 

HttpSessionActivationListener

这个接口一般和Servlet容器的集群有关系，它监听的是同一个session转移至不同的JVM的事件。

void sessionDidActivate(HttpSessionEvent se)

当一个session对象已经变成有效的状态的时候，容器调用此方法

void sessionWillPassivate(HttpSessionEvent se)

当一个session对象将要变成无效状态的时候，容器调用此方法

 

 

HttpSessionAttributeListener

这个接口和ServletContextAttributeListener方法一样，唯一的差别即是：

ServletContextAttributeListener针对的是ServletContext，而HttpSessionAttributeListener针对的Session。

 

void attributeAdded(HttpSessionBindingEvent se)

这个方法在通过HttpSession的void setAttribute(String name, Object object)向HttpSession新添加一个name为名，object为值得对象之后被调用

void attributeReplaced(HttpSessionBindingEvent se)

这个方法在通过HttpSession的void setAttribute(String name, Object object)替换HttpSession中name对应的值之后被调用

void attributeRemoved(HttpSessionBindingEvent se)

这个方法在通过HttpSession的void removeAttribute(String name)删除HttpSession中以name为名的键值对或者HttpSession失效时被调用之后被调用。

 

HttpSessionBindingEvent提供三个方法：

String getName()返回键值对的名也就是name。

Object getValue()这个方法，在attributeAdded中返回新添的键值对的值；在attributeReplaced和中attributeRemoved返回原键值对的值。

HttpSession getSession() 返回发生此事件的HttpSession对象。

 

 

HttpSessionBindingListener

注意：这个listener是一个比较特殊的listener，它不需要在web.xml中进行配置。

此listener需要存放于session中的对象实现此接口，才能被响应。

 

void valueBound(HttpSessionBindingEvent event)

此方法通过HttpSession的void setAttribute(String name, Object object)被调用。其中object需要实现HttpSessionBindingListener接口。

 

void valueUnbound(HttpSessionBindingEvent event)

此方法通过HttpSession的void removeAttribute(String name)或者HttpSession失效时被调用。其中nam对应的object需要实现HttpSessionBindingListener接口。

 

这个接口和HttpSessionAttributeListener差别为，此接口不需要在web.xml中配置并且可以监听单个类的对象被放入session或者从session中去掉的动作。而HttpSessionAttributeListener需要在web.xml中配置，并且是监听所有类的对象。

 

 

ServletRequestListener

void requestInitialized(ServletRequestEvent sre)

request初始化之后，容器调用此方法。

void requestDestroyed(ServletRequestEvent sre)

request消亡之前，容器调用此方法。

 

ServletRequestEvent提供二个方法：

ServletContext getServletContext()

返回此事件request对象对应的ServletContext

ServletRequest getServletRequest()

返回此事件的request对象

 

ServletRequestAttributeListener

这个listener作用和ServletContextAttributeListener和HttpSessionAttributeListener类似，不过它监听的是ServletRequest对象。

 

void attributeAdded(ServletRequestAttributeEvent srae)

这个方法在通过ServletRequest的void setAttribute(String name, Object object)向ServletRequest新添加一个name为名，object为值得对象之后被调用

void attributeReplaced(ServletRequestAttributeEvent srae)

这个方法在通过ServletRequest的void setAttribute(String name, Object object)替换ServletRequest中name对应的值之后被调用

void attributeRemoved(ServletRequestAttributeEvent srae)

这个方法在通过ServletRequest的void removeAttribute(String name)删除ServletRequest中以name为名的键值对或者ServletRequest失效时被调用之后被调用。

 

 

ServletRequestAttributeEvent除了继承了ServletRequestEvent的ServletContext getServletContext()和ServletRequest getServletRequest()还提供了：

String getName()返回键值对的名也就是name

Object getValue()这个方法，在attributeAdded中返回新添的键值对的值；在attributeReplaced和中attributeRemoved返回原键值对的值。

 

 

除了HttpSessionBindingListener以外，其他的listener都必须在web.xml中进行配置。

配置的方法很简单就是在web.xml中最后一个</filter-mapping>后，添加一个

 

 

 

 

<listener>

<listener-class>squall.servlet.listener.Listener</listener-class>

</listener>

 

其中squall.servlet.listener.Listener为某一个listener的实现类。