Servlet
API提供了基本的應用程式事件監聽器接口。程式設計者可以通過實作這些接口來使用管理事件的功能。Servlet2.4以後提供了對以下對象的事件監聽:ServletContext,HttpSession,ServletRequest。監聽ServletContext可以使Web程式得知整個應用程式載入和解除安裝等運作情況。監聽HttpSession可以Web程式了解應用程式會期間的狀況并作出響應。監聽ServletRequest可以使
Web程式控制Web請求的生命周期。
下面結合JavaServetAPI官方文檔對各個事件監聽器接中進行說明。
一、 ServletContextListener
所在包:javax.servlet
接口聲明:public interface
ServletContextListener extends java.util.EventListener
方法:
1.void
contextDestroyed(ServletContextEvent sce)
當應用被解除安裝後觸發執行該方法中的代碼。
2.void
contextInitialized(ServletContextEvent sce)
當應用在初始化時觸發執行該方法中的代碼。
這裡需要對 ServletContentEvent說明一下,它是一個ServletContext對象的事件,其類的聲明如下:
public
class ServletContentEvent extends java.util.EventObject
包含方法:ServletContext
getServletContext(),傳回事件的Servlet上下文,即産生事件的目前應用程式。
二、 ServletContextAttributeListener
ServletContextAttributeListener
extends java.util.EventListener
1. void attributeAdded(ServletContextAttributeEvent scab)
當一個新的屬性加入到Servlet的上下文中後觸發該方法中的代碼。
attributeRemoved(ServletContextAttributeEvent scab)
當一個屬性被從servlet的上下文中移走後觸發該方法中的代碼。
3.void
attributeReplaced(ServletContextAttributeEvent scab)
當servlet上下文中的一個屬性的值被替換後觸發該方法中的代碼。
ServletContextAttributeEvent是servlet上下文裡的屬性的事件,其類聲明如下:
public class
ServletContextAttributeEvent
extends ServletContextEvent
包含方法:String
GetName(),傳回産生事件的屬性名稱;Object GetValue(),傳回産生事件的屬性的值。
三、HttpSessionListener
HttpSessionListener
sessionCreated(HttpSessionEvent se)
當一個會話被建立後觸發執行該方法中的代碼。
sessionDestroyed(HttpSessionEvent se)
當一個會話被釋放後觸發執行該方法中的代碼。
HttpSessionEvent 是會話事件類,其聲明如下:
public class HttpSessionEvent
extends
java.util.EventObject
包含方法:HttpSession getSession(),傳回産生事件的session對象。
四、 HttpSessionActivationListener
HttpSessionActivationListener
1.void SessionDidActivate(HttpSessionEvent se)
SessionWillPassivate(HttpSessionEvent se)
Activate與Passivate是用于置換對象的動作,當session對象為了資源利用或負載平衡等原因而必須暫時儲存至硬碟或其它儲存器時(透過對象序列化),所作的動作稱之為Passivate,而硬碟或儲存器上的session對象重新加載JVM時所采的動作稱之為Activate。
五、HttpSessionAttributeListener
所在包:javax.servlet
接口聲明:public interface HttpSessionAttributeListener
attributeAdded(HttpSessionBindingEvent se)
attributeReplaced(HttpSessionBindingEvent se)
attributeRemoved(HttpSessionBindingEvent se)
以上三個方法分别在會話屬性被加入、會話屬性值被修改和會話屬性被移除時觸發執行。
HttpSessionBindingEvent 是一個會話事件對象類,其聲明如下:
public interface
HttpSessionBindingListener
getName(),傳回産生目前事件的會話的屬性名。Object getValue(),傳回産生目前事件的會話的屬性值。HttpSession
getSession(),傳回産生目前事件的會話對象。
六、 HttpSessionBindingListener
1.void valueBound(HttpSessionBindingEvent event)
當實作
HttpSessionBindingListener接口的對象被綁定到Session Attribute中,該對象的此方法被執行。
valueUnbound(HttpSessionBindingEvent event)
HttpSessionBindingListener接口的對象被從Session Attribute解除綁定,該對象的此方法被執行。
請注意 HttpSessionAttributeListener與HttpSessionBindingListener的差別:
1.前者是需要在web.xml中進行描述的,後者不需要。
2.前者是在任何session的屬生變化時都會觸發執行其方法中的代碼,而後者隻是在實作它的對象被綁定到會話屬性或被從會話屬生中解除綁定時,才會觸發執行那個對象的valueBound和valueUnboundy這兩個方法的代碼。比如說有兩個對象A和B都實作了HttpSessionBindingListener接口,當A被綁定到會話屬性中時,隻是A的valueBound()
方法被觸發執行。
七、 ServletRequestListener
ServletRequestListener
RequestDestroyed(ServletRequestEvent evt)
RequestInitialized(ServletRequestEvent evt)
以上兩個方法分别在ServetRequest對象初始化和清除時觸發執行。
ServletRequestEvent 表示ServletReuest事件類,其聲明如下:
ServletRequestEvent
extends java.util.EventObject
getServletContext(),獲得目前Web應用程式的上下文對象。ServletRequest
getServletRequest(),獲得目前事件的主體,ServletRequest對象。
八、 ServletRequestAttributeListener
ServletRequestAttributeListener
1.void attributeAdded(ServletRequestAttributeEvent e)
當向ServlvetRequest對象屬性中添加屬性後觸發執行該方法。
attributeRemoved(ServletRequestAttributeEvent e)
當向ServlvetRequest對象屬性中移除屬性後觸發執行該方法。
attributeReplaced(ServletRequestAttributeEvent e)
當修改ServlvetRequest對象屬性的屬生值後觸發執行該方法。
ServletRequestAttributeEvent 是ServletRequest屬性事件類,其聲明如下:
ServletRequestAttributeEvent
extends ServletRequestEvent
getName(),獲得觸發事件的屬性的名稱。Object getValue(),獲得觸發事件的屬生的值。
下面說明如何在web.xml中布署事件監聽器以實作對事件的處理,格式如下:
<listener>
<listener-class>
fey.servlet.listener.CustomServletContextListener
</listener-class >
</listener>
其中fey.servlet.listener.CustomServletContextListener是實作上述各事件監聽器接口的類名。當然需要将這些類放入Web容器的Web應用的classes或lib目錄下以讓Web容器可以找到。外說明一點,一個類可以一個或多個監聽器接口。
九、執行個體:session的2個監聽器接口監聽目前線上人數清單
1、javax.servlet.http.HttpSessionBindingListener;
實作這個接口的類,每當被存放到session或從session中移除都會出發接口中相應的方法,進而實作監聽的效果。
2、javax.servlet.http.HttpSessionListener;
實作這個接口的類,本身就是1個監聽器,每當有session生成或消亡時,都觸發接口中相應的方法,進而實作監聽器的效果;
HttpSessionListener的實作類本身就是一個監聽器,要使用它需要在web.xml中啟動這個監聽器,例如
<listener>
<listener-class>packname.classname</listener-class>
</listener>
3、這2個監聽器是有差別的
前者的觸發取決于session中加入的屬性。
後者的觸發取決于session本身的産生和消亡。
4、與和上述之類似的還有對ServletContext的監聽和對Request監聽。
線上人數清單是對所有人起作用,資料應放到application中即ServletContext對象。
OnLineDemo.java
import java.util.ArrayList;
import java.util.List;
import
javax.servlet.ServletContext;
javax.servlet.ServletContextEvent;
javax.servlet.ServletContextListener;
javax.servlet.http.HttpSessionAttributeListener;
javax.servlet.http.HttpSessionBindingEvent;
javax.servlet.http.HttpSessionEvent;
javax.servlet.http.HttpSessionListener;