监听器概述    
   
1.Listener是Servlet的监听器     
2.可以监听客户端的请求、服务端的操作等。    
3.通过监听器,可以自动激发一些操作,如监听在线用户数量,当增加一个HttpSession时,给在线人数加1。    
4.编写监听器需要实现相应的接口    
5.编写完成后在web.xml文件中配置一下,就可以起作用了    
6.可以在不修改现有系统基础上,增加web应用程序生命周期事件的跟踪    
   Servlet监听器用于监听一些重要事件的发生,监听器对象可以在事情发生前、发生后可以做一些必要的处理。
接口:
目前Servlet2.4和JSP2.0总共有8个监听器接口和6个Event类,其中HttpSessionAttributeListener与
HttpSessionBindingListener皆使用HttpSessionBindingEvent;HttpSessionListener和HttpSessionActivationListener则都使用HttpSessionEvent;其余Listener对应的Event如下所示:

 

 

 

Listener接口

Event

ServletContextListener

ServletContextEvent

ServletContextAttributeListener

ServletContextAttributeEvent

HttpSessionListener

HttpSessionEvent

HttpSessionActivationListener

HttpSessionAttributeListener

HttpSessionBindingEvent

HttpSessionBindingListener

ServletRequestListener

ServletRequestEvent

ServletRequestAttributeListener

ServletRequestAttributeEvent

 

 

 


一 ServletContext相关监听接口

 补充知识:通过ServletContext 的实例可以存取应用程序的全局对象以及初始化阶段的变量。
 在JSP文件中,application 是 ServletContext 的实例,由JSP容器默认创建。Servlet 中调用 getServletContext()方法得到 ServletContext 的实例。
 
 注意:全局对象即Application范围对象,初始化阶段的变量指在web.xml中,经由<context-param>元素所设定的变量,它的范围也是Application范围,例如:

 <context-param> 
  <param-name>Name</param-name> 
  <param-value>browser</param-value>
 </context-param>
 
 当容器启动时,会建立一个Application范围的对象,若要在JSP网页中取得此变量时:
  String name = (String)application.getInitParameter("Name");
 或者使用EL时:
  ${initPara.name}
 若是在Servlet中,取得Name的值方法:
  String name = (String)ServletContext.getInitParameter("Name");

 1.ServletContextListener:
 用于监听WEB 应用启动和销毁的事件,监听器类需要实现javax.servlet.ServletContextListener 接口。
 ServletContextListener 是 ServletContext 的监听者,如果 ServletContext 发生变化,如服务器启动时 ServletContext 被创建,服务器关闭时 ServletContext 将要被销毁。

 ServletContextListener接口的方法:
  void contextInitialized(ServletContextEvent sce)  
 通知正在接受的对象,应用程序已经被加载及初始化。
  void contextDestroyed(ServletContextEvent sce)  
 通知正在接受的对象,应用程序已经被载出。
 ServletContextEvent中的方法:
 ServletContext getServletContext() 
 取得ServletContext对象

 2.ServletContextAttributeListener:用于监听WEB应用属性改变的事件,包括:增加属性、删除属性、修改属性,监听器类需要实现javax.servlet.ServletContextAttributeListener接口。

 ServletContextAttributeListener接口方法:
 void attributeAdded(ServletContextAttributeEvent scab)
 若有对象加入Application的范围,通知正在收听的对象
 void attributeRemoved(ServletContextAttributeEvent scab)
 若有对象从Application的范围移除,通知正在收听的对象
 void attributeReplaced(ServletContextAttributeEvent scab)
 若在Application的范围中,有对象取代另一个对象时,通知正在收听的对象


 ServletContextAttributeEvent中的方法:
 java.lang.String getName()
 回传属性的名称
 java.lang.Object getValue()
 回传属性的值

二、HttpSession相关监听接口
 1.HttpSessionBindingListener接口
 注意:HttpSessionBindingListener接口是唯一不需要再web.xml中设定的Listener

 当我们的类实现了HttpSessionBindingListener接口后,只要对象加入Session范围(即调用HttpSession对象的setAttribute方法的时候)或从Session范围中移出(即调用HttpSession对象的removeAttribute方法的时候或Session Time out的时候)时,容器分别会自动调用下列两个方法:
 void valueBound(HttpSessionBindingEvent event)
 void valueUnbound(HttpSessionBindingEvent event)

 思考:如何实现记录网站的客户登录日志, 统计在线人数?

 2.HttpSessionAttributeListener接口
 HttpSessionAttributeListener监听HttpSession中的属性的操作。
 当在Session增加一个属性时,激发attributeAdded(HttpSessionBindingEvent se) 方法;当在Session删除一个属性时,激发attributeRemoved(HttpSessionBindingEvent se)方法;当在Session属性被重新设置时,激发attributeReplaced(HttpSessionBindingEvent se) 方法。这和ServletContextAttributeListener比较类似。

 3.HttpSessionListener接口
 HttpSessionListener监听HttpSession的操作。当创建一个Session时,激发session Created(HttpSessionEvent se)方法;当销毁一个Session时,激发sessionDestroyed (HttpSessionEvent se)方法。

 4.HttpSessionActivationListener接口
  主要用于同一个Session转移至不同的JVM的情形。

四、ServletRequest监听接口
 1.ServletRequestListener接口和ServletContextListener接口类似的,这里由ServletContext改为ServletRequest
 2.ServletRequestAttributeListener接口和ServletContextListener接口类似的,这里由ServletContext改为ServletRequest 


   
常用的监听接口    
   
1.ServletContextAttributeListener    
监听对ServletContext属性的操作,比如增加/删除/修改    
2.ServletContextListener    
监听ServletContext,当创建ServletContext时,激发contextInitialized(ServletContextEvent sce)方法;当销毁ServletContext时,激发contextDestroyed(ServletContextEvent sce)方法。    
3.HttpSessionListener    
监听HttpSession的操作。当创建一个Session时,激发session Created(SessionEvent se)方法;当销毁一个Session时,激发sessionDestroyed (HttpSessionEvent se)方法。    
4.HttpSessionAttributeListener    
监听HttpSession中的属性的操作。当在Session增加一个属性时,激发attributeAdded(HttpSessionBindingEvent se) 方法;当在Session删除一个属性时,激发attributeRemoved(HttpSessionBindingEvent se)方法;当在Session属性被重新设置时,激发attributeReplaced(HttpSessionBindingEvent se) 方法。    
   
使用范例:    
由监听器管理共享数据库连接    
   
生命周期事件的一个实际应用由context监听器管理共享数据库连接。在web.xml中如下定义监听器:    
<listener>    
    <listener-class>XXX.MyConnectionManager</listener-class>    
</listener> ?server创建监听器的实例,接受事件并自动判断实现监听器接口的类型。要记住的是由于监听器是配置在部署描述符web.xml中,所以不需要改变任何代码就可以添加新的监听器。    
   
public class MyConnectionManager implements ServletContextListener{      
public void contextInitialized(ServletContextEvent e) {     
        Connection con = // create connection     
        e.getServletContext().setAttribute("con", con);     
    }      
   public void contextDestroyed(ServletContextEvent e) {     
        Connection con = (Connection) e.getServletContext().getAttribute("con");     
        try {    
          con.close();     
        }     
       catch (SQLException ignored) { } // close connection     
    }     
}      
监听器保证每新生成一个servlet context都会有一个可用的数据库连接,并且所有的连接对会在context关闭的时候随之关闭。     
   
在web.xml中加入:    
<listener><listener-class>servletlistener111111.SecondListener</listener-class> </listener>

==================================================

关于用户超时的例子:

public class OnlineUserListener implements HttpSessionListener {
    public void sessionCreated(HttpSessionEvent event) {
    }
    public void sessionDestroyed(HttpSessionEvent event) {
        HttpSession session = event.getSession();
        ServletContext application = session.getServletContext();
        // 取得登录的用户名
        String username = (String) session.getAttribute("username");
        // 从在线列表中删除用户名
        List onlineUserList = (List) application.getAttribute("onlineUserList");
        onlineUserList.remove(username);
        System.out.println(username + "超时退出。");
    }
}

以下两种情况下就会发生sessionDestoryed(会话销毁)事件:

1.执行session.invalidate()方法时。例如:request.getSession().invalidate();

2.如果用户长时间没有访问服务器,超过了会话最大超时时间,服务器就会自动销毁超时的session。会话超时时间可以在web.xml中进行设置。

========================================

使用HttpSessionBindingListener

HttpSessionBindingListener虽然叫做监听器,但使用方法与HttpSessionListener完全不同。我们实际看一下它是如何使用的。

我们的OnlineUserBindingListener实现了HttpSessionBindingListener接口,接口中共定义了两个方法:valueBound()和valueUnbound(),分别对应数据绑定,和取消绑定两个事件。

所谓对session进行数据绑定,就是调用session.setAttribute()把HttpSessionBindingListener保存进session中。我们在LoginServlet.java中进行这一步。

// 把用户名放入在线列表
session.setAttribute("onlineUserBindingListener", new OnlineUserBindingListener(username));
        
这就是HttpSessionBindingListener和HttpSessionListener之间的最大区别:HttpSessionListener只需要设置到web.xml中就可以监听整个应用中的所有session。HttpSessionBindingListener必须实例化后放入某一个session中,才可以进行监听。

从监听范围上比较,HttpSessionListener设置一次就可以监听所有session,HttpSessionBindingListener通常都是一对一的。

正是这种区别成就了HttpSessionBindingListener的优势,我们可以让每个listener对应一个username,这样就不需要每次再去session中读取username,进一步可以将所有操作在线列表的代码都移入listener,更容易维护。

valueBound()方法的代码如下:

public void valueBound(HttpSessionBindingEvent event) {
    HttpSession session = event.getSession();
    ServletContext application = session.getServletContext();

    // 把用户名放入在线列表
    List onlineUserList = (List) application.getAttribute("onlineUserList");
    // 第一次使用前,需要初始化
    if (onlineUserList == null) {
        onlineUserList = new ArrayList();
        application.setAttribute("onlineUserList", onlineUserList);
    }
    onlineUserList.add(this.username);
}
        
username已经通过构造方法传递给listener,在数据绑定时,可以直接把它放入用户列表。

与之对应的valueUnbound()方法,代码如下:

public void valueUnbound(HttpSessionBindingEvent event) {
    HttpSession session = event.getSession();
    ServletContext application = session.getServletContext();

    // 从在线列表中删除用户名
    List onlineUserList = (List) application.getAttribute("onlineUserList");
    onlineUserList.remove(this.username);

    System.out.println(this.username + "退出。");
}
        
这里可以直接使用listener的username操作在线列表,不必再去担心session中是否存在username。

valueUnbound的触发条件是以下三种情况:

1.执行session.invalidate()时。

2.session超时,自动销毁时。

3.执行session.setAttribute("onlineUserListener", "其他对象");或session.removeAttribute("onlineUserListener");将listener从session中删除时。

因此,只要不将listener从session中删除,就可以监听到session的销毁。