Servlet过滤器是 Servlet 程序的一种特殊用法,主要用来完成一些通用的操作,如编码的过滤、判断用户的登录状态。过滤器使得Servlet开发者能够在客户端请求到达 Servlet资源之前被截获,在处理之后再发送给被请求的Servlet资源,并且还可以截获响应,修改之后再发送给用户。而Servlet监听器可以 监听客户端发出的请求、服务器端的操作,通过监听器,可以自动激发一些操作,如监听在线人数。
Servlet过滤器简介绍
Servlet过滤器是在Java Servlet 2.3 规范中定义的,它是一种可以插入的Web组件,它能够对Servlet 容器的接收到的客户端请求和向客户端发出的响应对象进行截获,过滤器支持对Servlet程序和JSP页面的基本请求处理功能,如日志、性能、安全、会话 处理、XSLT转换等。
Servlet过滤器本身不产生请求和响应,它只提供过滤作用,Servlet过滤器能够在Servlet程序(JSP页面)被调用之前检查 request对象,修改请求头和请求内容,在Servlet程序(JSP页面)被调用之后,检查response对象,修改响应头和响应内容。
Servlet过滤器的特点
1.Servlet过滤器可以检查和修改request和response对象。
2.Servlet过滤器可以被指定与特定的URL关联,只有当客户请求访问该特定的URL时,才会触发过滤器。
3.Servlet过滤器可以被串联成串,形成过滤链,协同修改请求和响应。
Servlet过滤器的作用如下:
1.查询请求并作出相应的行动。
2.阻塞请求--响应对,使其不能进一步传递。
3.修改请求头和内容,用户可以提供自定义的请求。
4.修改响应头和内容,用户可以通过提供定制的响应版本实现。
5.与外部资源进行交互。
2 Servlet过滤器的体系结构
Servlet过滤器用于拦截传入的请求和传出的响应,并监视、修改或以某种方式处理 正在通过的数据流。Servlet过滤器是自包含、模块化的组件,可以将它们添加到请求/响应过滤链中,或者在不影响应用程序中其它Web组件的情况下删 除它们。Servlet过滤器只在改动请求和响应的运行时处理,因而不应该将它们之间嵌入到Web应用程序框架,除非是通过Servlet API中良好定义的标准接口来实现。
Web资源可以配置成为没有过滤器与之关联(默认情况)、与单个过滤器关联(典型情况),甚至是与一个过滤器链关联。其功能与Servlet一 样,主要是接收请求和响应对象,然后过滤器会检查请求对象,并决定是将该请求转发给链中的下一个过滤器,还是终止该请求并直接向客户端发会一个响应,如果 请求被转发了,它将被传递给过滤链中的下一个过滤器,或者Servlet程序(JSP页面),在这个请求通过过滤器链并被服务器处理后,一个响应将以相反 的顺序通过该过滤链发送回去,这样就给每个Servlet过滤器提供了根据需要处理响应对象的机会。
当过滤器在Servlet 2.3规范中首次引入时,只能过滤客户端和客户端所访问的指定Web资源之间的内容(请求/响应),如果该Web资源将请求转发给其它Web资源时,那就 不能向幕后委托的任何请求应用过滤器。Servlet 2.4 规范消除了这个限制,Servlet过滤器现在可以应用于J2EE Web环境中存在请求和响应的任何地方。可见,Servlet过滤器可以应用在客户端和Servlet程序之间、Servlet程序和Servlet程序 之间、Servlet程序和JSP页面之间、JSP页面和JSP页面之间,具有强大的能力和灵活性。
2.1 Servlet过滤器对请求的过滤
Servlet过滤器对请求的过滤过程如下:
1.Servlet容器创建一个Servlet过滤器实例。
2.Servlet过滤器实例调用init()方法得到初始化参数。
3.Servlet过滤器实例调用doFilter()方法,根据初始化参数的值判断该请求是否合法,如果该请求不合法,则阻塞该请求,如果是合法请求,则调用chain.doFilter(request,response)方法将该请求向后转发。
13.2.2 Servlet过滤器对响应的过滤
Servlet过滤器对响应的过滤过程如下:
1.过滤器截获客户端的请求。
2.重新封装ServletResponse,在封装后的ServletResponse中提供客户端自定义的输出流。
3.将请求向后转发。
4.Web组件产生响应。
5.过滤器从被封装的ServletResponse中获取客户自定义的输出流。
6.将响应内容通过客户自定义的输出流写入缓冲流。
7.在缓冲流中修改响应内容后清空缓冲流,输出响应内容。
2.3 Servlet过滤器的发布
Seevlet过滤器设计完毕之后,必须对该过滤器进行发布(配置), 发布一个Servlet过滤器时,必须在项目的web.xml文件中加入<filter>元素和<filter- mapping>元素,<filter>元素用来定义一个过滤器,该元素的属性有:
属性 |
描述 |
filter-name |
指定过滤器的名字 |
filter-class |
指定过滤器类 |
init-param |
指定过滤器的初始化参数 |
<filter-mapping>元素用于将过滤器与URL关联,其属性有:
属性 |
描述 |
filter-name |
指定过滤器的名字 |
url-pattern |
指定与过滤器关联的URL |
3 实现一个Servlet过滤器
3.1 Servlet过滤器接口的构成
所有的Servlet过滤器都必须实现javax.servlet.filter接口,该接口中定义了3个过滤器必须实现的方法:
1.void init(FilterConfig):过滤器的初始化方法,Servlet容器在创建过滤器实例时调用这个方法,在这个方法中可以读出在web.xml文件中为该过滤器配置的初始化参数。
2.voiddoFilter(ServletRequest,ServletResponse,FilterChain):用于完成实际的过滤操作,当客户请求访问与过滤器相关联的URL时,Servlet容器将先调用过滤器的这个方法,FilterChain参数用于访问后续过滤器。
3.voiddestroy():过滤器在被取消前执行这个方法,释放过滤器申请的资源。
3.2 Servlet过滤器的创建步骤
创建一个Servlet过滤器需要下面的步骤:
1.创建一个实现了javax.servlet.Filter接口的类。
2.重写init(FilterConfig)方法,读入为过滤器配置的初始化参数,申请过滤器需要的资源。
3.重写方法doFilter(ServletRequest,ServletResponse,FilterChain),完成过滤操作,可以 从ServletRequest参数中得到全部的请求信息,从ServletResponse参数中得到全部的响应信息。
4.在doFilter()方法的最后,使用FilterChain参数的doFilter()方法将请求和响应后传。
5.对响应的Servlet程序和JSP页面注册过滤器,在部署描述文件(web.xml)中使用<filter-apping>和<filter>元素对过滤器进行配置。
3.3 编写过滤器类
在过滤器中,需要使用3个简单的接口,它们是:分别是Filter、FilterChain、FilterConfig,全部包含在javax.servlet包中。从编程的角度看,过滤器类要实现Filter接口,然后使用实现了FilterChain和FilterConfig接口的对象来工作,FilterChain对象负责将请求和响应后传,FilterConfig对象负责为过滤器读初始化参数。
为了与过滤器的三步模式(创建、工作、撤消)保持一致,过滤器必须重写Filter接口中的三个方法:
init():在容器实例化过滤器市时被调用,主要为过滤器做初始化,该方法有一个FilterConfig类型的形参。
doFilter():这个方法用来完成真正的过滤操作,它有3个形式参数:ServletRequest参数包含请求信息,ServletResponse参数包含响应信息,FilterChain参数用来将请求和响应向后传递。
destroy():过滤器被撤消时调用这个方法,释放过滤器所 占有的资源。
在下面的例子中实现了一个简单的Servlet过滤器(SessionFilter.Java),它实现的功能是判断客户是否成功登录,如果成功登录,转向正确页面,否则返回一个错误页面,提示客户应该进行登录。该过滤器代码如下:
//includeList:数组,受保护的资源。
//logonList:数组,登录页面。
package ch13;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class SessionFilter implements Filter{
String logonStrings,includeStrings,redirectPath,disabletestfilter;
String[] logonList,includeList;
private boolean isContains(String containers,String[] regx) {
boolean result=false;
for(int i=0;i<regx.length;i++) {
if (containers.indexOf(regx[i])!=-1)
return true;
}
return result;
}
public FilterConfig config;
private void setFilterConfig(FilterConfig config) {
this.config=config;
}
private FilterConfig getFilterConfig(){
return config;
}
//必须重写
public void init(FilterConfig filterConfig) throws ServletException{
this.config=filterConfig;
logonStrings=config.getInitParameter("logonStrings");
includeStrings=config.getInitParameter("includeStrings");
redirectPath=config.getInitParameter("redirectPath");
disabletestfilter=config.getInitParameter("disabletestfilter");
logonList=logonStrings.split(";");//分割为数组
includeList=includeStrings.split(";");//分割为数组
}
//必须重写
public void doFilter(ServletRequest request,ServletResponse response,FilterChain
chain) throws ServletException, IOException {
HttpServletRequest httpreq=(HttpServletRequest)request;
HttpServletResponse httpres=(HttpServletResponse)response;
HttpServletResponseWrapper wrapper=new HttpServletResponseWrapper(
(HttpServletResponse)response);
if (disabletestfilter.toUpperCase().equals("Y")){
chain.doFilter(request,response);//如果不过滤
return;
}
Object user=httpreq.getSession().getAttribute("userinfo");
if (user==null){//该用户没有登录
if (!isContains(httpreq.getRequestURI(),includeList)){
chain.doFilter(request,response);
return;//访问的是不受保护的页面,可以
}
if (isContains(httpreq.getRequestURI(),logonList)){
chain.doFilter(request,response);
return; //访问的是登录页面,可以
}
wrapper.sendRedirect(redirectPath); //转向登页面
}else {//该用户已经登录
chain.doFilter(request,response);
}
}
//必须重写
public void destroy() {
config=null;
}
}
在上面的这个Servlet过滤器程序中,根据用户session对象中有无userinfo这个属性来确定该用户是否已经登录。
3.4 配置部署过滤器
在WEB-INF/web.xml文件中用以下代码配置过滤器:
<filter>
<filter-name>SessionFilter</filter-name>
<filter-class>ch13.SessionFilter</filter-class>
<init-param>
<param-name>logonStrings</param-name>
<param-value>Login.jsp</param-value>
</init-param>
<init-param>
<param-name>includeStrings</param-name>
<param-value>.jsp;.html;.htm</param-value>
</init-param>
<init-param>
<param-name>redirectPath</param-name>
<param-value>./Login.jsp</param-value>
</init-param>
<init-param>
<param-name>disabletestfilter</param-name>
<param-value>n</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>SessionFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
在上面的配置中,参数logonStrings指定可以访问的登录页面,参数includeStrings指定受保护的资源的后缀,参数redirectPath表示没有登录时转向的登录页面,参数disabletestfilter表示过滤器是否有效。而 /* 表示过滤器与所有的URL都关联(对所有的访问请求都进行过滤)。在浏览器中访问任意的资源时,都要通过这个过滤器的过滤。
4 过滤器的应用案例.4.1 版权过滤器的应用案例
在一个Web应用中的所有页面的下面添加上版权信息,通常的做法是采用<%@ include>指令或<c:import> 标签,使用过滤器也是一个好办法。
1.编写过滤器类CopyrightFilter.java
package ch13;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class CopyrightFilter implements Filter{
private String date;
public FilterConfig config;
//必须重写
public void init(FilterConfig filterConfig) throws ServletException{
this.config=filterConfig;
date=config.getInitParameter("date");
}
//必须重写
public void doFilter(ServletRequest request,ServletResponse response,FilterChain
chain) throws ServletException, IOException {
chain.doFilter(request,response);
PrintWriter out=response.getWriter();
out.print("<br><center><font size='3' color='red'>版权所有:北京工业大学
</center></font>");
if (date!=null)
out.print("<br><center><font color='blue'>"+date+"</center></font>");
out.flush();
}
//必须重写
public void destroy() {
config=null;
}
}
在这个过滤器中,在doFilter()方法的最后,通过response对象得到一个输出流out,然后通过输出流向客户端输出版权信息,这样,每个页面的最后都会出现过滤器添加的版权信息。
2.修改web.xml,配置该过滤器
<filter>
<filter-name>CopyrightFilter</filter-name>
<filter-class>ch13.CopyrightFilter</filter-class>
<init-param>
<param-name>date</param-name>
<param-value>2010-9</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CopyrightFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
3.测试
在浏览器中任意访问一个页面,都可以在看到在页面的下部出现过滤器添加的版权信息。
4.2 禁止未授权的IP访问站点过滤器的应用案例
使用过滤器禁止未授权的IP访问站点是过滤器常见的应用,本例演示了如何利用过滤器实现禁止未授权的IP访问站点。
1.编写过滤器类FilterIP.java
package ch13;
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
public class FilterIP implements Filter{
private String filterIP,error;
public FilterConfig config;
//必须重写
public void init(FilterConfig filterConfig) throws ServletException{
this.config=filterConfig;
filterIP=config.getInitParameter("FilterIP");
if (filterIP==null) filterIP="";
error=config.getInitParameter("ERROR");
if (error==null) error="error.jsp";
}
//必须重写
public void doFilter(ServletRequest request,ServletResponse response,FilterChain
chain) throws ServletException, IOException {
RequestDispatcher dispatcher=request.getRequestDispatcher("ErrorInfo.jsp");
String remoteIP=request.getRemoteAddr();//得到客户的IP地址
if (remoteIP.equals(filterIP)) {
dispatcher.forward(request,response);
return;
} else
chain.doFilter(request,response);
}
//必须重写
public void destroy() {
config=null;
}
}
在这个过滤器中,在doFilter()方法内,通过request对象得到客户端的IP地址,如果客户端的IP是被禁止的IP,则使用request对象将请求转发给一个出错页面。
2.修改web.xml,配置过滤器
<filter>
<filter-name>FilterIP</filter-name>
<filter-class>ch13.FilterIP</filter-class>
<init-param>
<param-name>FilterIP</param-name>
<param-value>192.168.1.1</param-value>
</init-param>
<init-param>
<param-name>ERROR</param-name>
<param-value>error.jsp</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>FilterIP</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
对来自192.168.1.1的客户的所有请求(/*)都进行过滤,转移到error.jsp页面。
3.编写出错页面error.jsp
<%@ page contentType="text/html;charset=gb2312" %>
网站不允许IP地址为192.168.1.1的计算机访问。
在IP地址为 192.168.1.1 的计算机上访问网站的任何一个资源,都会转移到error.jsp页面。
4.3 过滤页面内容(响应内容)
本过滤器使用HttpServletResponseWrapper类 来实现页面内容的过滤,它的原理是让Web资源先将页面内容(响应内容)写入到HttpServletResponseWrapper对象中,然后再在过 滤器中处理HttpServletResponseWrapper对象中的页面内容(响应内容),最后再将处理好的页面内容(响应内容)发送给客户。
1.编写HttpServletResponseWrapper类的子类.java
package ch13;
import java.io.ByteArrayOutputStream;
import java.io.OutputStreamWriter;
import java.io.IOException;
import java.io.PrintWriter;
import java.io.UnsupportedEncodingException;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpServletResponseWrapper;
import javax.servlet.ServletOutputStream;
public class WrapperResponse extends HttpServletResponseWrapper {
public static final int OT_NONE = 0, OT_WRITER = 1, OT_STREAM = 2;
private int outputType = OT_NONE;
private ServletOutputStream output = null;
private PrintWriter writer = null;
private ByteArrayOutputStream buffer = null;
//构造函数
public WrapperResponse(HttpServletResponse resp) throws IOException {
super(resp);
buffer = new ByteArrayOutputStream();
}
//得到字符输出流
public PrintWriter getWriter() throws IOException {
if (outputType == OT_STREAM)
throw new IllegalStateException(); //已经用了OutputStream流
else if (outputType == OT_WRITER)
return writer;
else {
outputType = OT_WRITER;
writer = new PrintWriter(new OutputStreamWriter(buffer, getCharacterEncoding()));
return writer;
}
}
//得到字节输出流
public ServletOutputStream getOutputStream() throws IOException {
if (outputType == OT_WRITER)
throw new IllegalStateException(); //已经用了Writer流
else if (outputType == OT_STREAM)
return output;
else {
outputType = OT_STREAM;
output = new WrappedOutputStream(buffer);
return output;
}
}
//刷新输出内容
public void flushBuffer() throws IOException {
if (outputType == OT_WRITER)
writer.flush();
if (outputType == OT_STREAM)
output.flush();
}
//输出缓冲区复位
public void reset() {
outputType = OT_NONE;
buffer.reset();
}
public String getResponseData() throws IOException {
flushBuffer();
return new String(buffer.toByteArray());
}
//内部类,将数据写入自己的定义的缓冲区
class WrappedOutputStream extends ServletOutputStream {
private ByteArrayOutputStream buffer;
public WrappedOutputStream(ByteArrayOutputStream buffer) {
this.buffer = buffer;
}
public void write(int b) throws IOException {
buffer.write(b);
}
public byte[] toByteArray() {
return buffer.toByteArray();
}
}
}
在这个类中,一定要重写response对象的关于输出流(outputStream、writer)操作的方法:getOutputStream()、getWriter()、flushBuffer()、reset()。
2.编写过滤器GavinFilter.java
package ch13;
import java.io.IOException;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class GavinFilter implements Filter {
private String oldword="%" , newword="百分号";
public void destroy(){}
public void doFilter(ServletRequest request, ServletResponse response, FilterChain
chain) throws IOException, ServletException {
HttpServletResponse oldresponse = (HttpServletResponse)response;
WrapperResponse wrapperResponse = new WrapperResponse(oldresponse);
chain.doFilter(request, wrapperResponse); //让服务器将响应内容写到Wrapper中
String html = wrapperResponse.getResponseData(); //取出响应内容
oldresponse.getWriter().print(html.replaceAll(oldword, newword)); //替换页面中的文字,然后发送给客户
}
public void init(FilterConfig config) throws ServletException {
oldword=config.getInitParameter("oldword");
newword=config.getInitParameter("newword");
}
}
该过滤器将页面内容(响应内容)中的字符 % 替换为百分号三个汉字,由此可见,实现了对响应内容的过滤。
3.对该过滤器的配置
<filter>
<filter-name>gavinFilter</filter-name>
<filter-class>ch13.GavinFilter</filter-class>
<init-param>
<param-name>oldword</param-name>
<param-value>%</param-value>
</init-param>
<init-param>
<param-name>newword</param-name>
<param-value>百分号</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>gavinFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
5 Servlet监听器
Servlet监听器也叫做 listener,通过它可以监听Web应用的上下文(环境)信息、Servlet请求信息、Servlet会话信息,并自动根据不同情况,在后台调用相 应的处理程序。通过监听器,可以自动激发一些操作,比如监听在线人数,当增加一个HttpSession时就激发 sessionCreated(HttpSessionEvent)方法,这样就可以给在线人数加1。
13.5.1 监听器的原理
Servlet监听器是Web应用开发的一个重要组成部 分,Servlet监听器是在Servlet2.3规范中和Servlet过滤器一起引入的。在 Servlet2.4 规范中对其进行了比较大的改进。主要就是用来对Web应用进行监督和控制,极大地增强了Web应用的事件处理能力。
Servlet监听器的功能比较类似于Java中的GUI程序的监听器,可以监听由于Web应用中的状态改变而引起的Servlet容器产生的相应事件,然后接收并处理这些事件。
5.2 监听器的类型
在 Servlet 2.4 规范中,根据监听对象的类型和范围,将监听器分为3类:ServletRequest监听器(请求监听器)、HttpSession监听器(会话监听器)、ServletContext监听器(上下文监听器),其中请求监听器(ServletRequest监听器)是 Servlet 2.4 规范中新增加的监听器,可以用来监听客户的端请求,在Servlet 2.4 规范中包含了8个监听器接口和6个监听器事件类,具体的监听器接口和事件如下表:
监听对象 |
监听接口 |
监听事件 |
ServletRequest |
ServletRequestListener (2个方法) |
ServletRequestEvent |
ServletRequestAttributeListener (3个方法) |
ServletRequestAttributeEvent |
|
HttpSession |
HttpSessionListener (2个方法) |
HttpSessionEvent |
HttpSessionActivationListener (2个方法) |
||
HttpSessionAttributeListener (3个方法) |
HttpSessionBindingEvent |
|
HttpSessionBindingListener (2个方法) |
||
ServletContext |
ServletContextListener (2个方法) |
ServletContextEvent |
ServletContextAttributeListener (3个方法) |
ServletContextAttributeEvent |
1.被监听对象ServletContext
对ServletContext对象(JSP页面中称为application对象)实现监听涉及2个接口:
(1)ServletContextListener接口:用于监听ServletContext对象的创建和删除:接口中定义的回调方法有:
当创建一个ServletContext对象时,激发 contextInitialzed(ServletContextEvent)方法。
当撤消一个ServletContext对象时,激发 contextDestroyed(ServletContextEvent)方法。
(2)ServletContextAttributeListener接口:用于监听ServletContext对象的属性操作。接口中定义的回调方法有:
增加属性时,激发 attributeAdded(ServletContextAttributeEvent)
删除属性时,激发 attributeRemoved(ServletContextAttributeEvent)
修改属性时,激发 attributeReplaced(ServletContextAttributeEvent)
2.被监听对象HttpSession
对HttpSession对象(session)实现监听涉及4个接口:
(1)HttpSessionListener接口:这个接口监听Http会话的创建和撤消,并在某个session对象建立和销毁之前调用某个方法。接口中定义的回调方法有:
创建一个session对象时,激发 sessionCreated(HttpSessionEvent)
删除一个session对象时,激发 sessionDestroyed(HttpSessionEvent)
(2)HttpSessionActivationListener接口:监听Http会话的active和passivate状态。接口中定义的回调方法有:
session对象被保存到磁盘时,激发 sessionWillPassivate(HttpSessionEvent)
session对象被调入内存时,激发 sessionDidActivate(HttpSessionEvent)
Activate与Passivate是用于置换session对象的动作,当Web服务器因为资源利用或负载平衡等原因要将内存中的 session对象暂时储存至硬盘或其它储存器时(通过对象序列化),所作的动作称之为Passivate,而硬盘或储存器上的session对象重新加 载到JVM中时所采的动作称之为Activate。sessionDidActivate()方法与 sessionWillPassivate()方法分别于Activeate后与Passivate前被调用。
(3)HttpSessionAttributeListener接口:监听Http会话中属性的设置信息。接口中定义的回调方法有:
向某个session对象中增加新属性时,激发 attributeAdded(HttpSessionBindingEvent)
删除某个session对象中的属性时,激发 attributeRemoved(HttpSessionBindingEvent)
修改某个session对象中的属性时,激发 attributeReplaced(HttpSessionBindingEvent)
使用HttpSessionBindingEvent事件类对象的getSession()方法可以得到这个session对象,使用 HttpSessionBindingEvent对象的getName()方法得到属性的名字,使用getValue()方法得到属性的值。
若有属性加入到某个会话(HttpSession)对象,则会调用attributeAdded(),同理在替换属性与移除属性时,会分别调用attributeReplaced()、attributeRemoved()。
(4)HttpSessionBindingListener接口:这是唯一一个不需要在web.xml中进行配置的监听器接口,监听Http会话中属性的变化情况。接口中定义的回调方法有:
属性被加入到session中时,激发属性的 valueBound(HttpSessionBindingEvent)
属性被从session中删除时,激发属性的 valueUnbound(HttpSessionBindingEvent)
使用HttpSessionBindingEvent事件类对象的getSession()方法可以得到这个session对象,使用 HttpSessionBindingEvent对象的getName()方法得到属性的名字,使用getValue()方法得到属性的值。
如果一个对象object实现了HttpSessionBindingListener接口时,当把object对象保存到session中时, 就会自动调用object对象的valueBound()方法,如果对象object被从session(HttpSession)移除时,则会调用 object对象的valueUnbound()方法。使用这个接口,可以让一个对象自己知道它自己是被保存到了session中,还是从session 中被删除了。
3.被监听对象ServletRequest
对ServletRequest对象(request)实现监听涉及2个接口:
(1)ServletRequestListener接口:监听请求的创建和撤消,该接口用来监听请求到达和结束,因此可以在请求达到前和请求结束前执行一些用户行为。 接口中定义的回调方法有:
请求对象初始化时,激发 requestInitialized(ServletRequestEvent)
请求对象被撤消时,激发 requestDestroyed(ServletRequestEvent)
在request(HttpServletRequest)对象建立或被消灭时,会分别调用requestInitialized()和requestDestroyed()方法。
(2)ServletRequestAttributeListener接口:监听请求中(request对象中)的属性变化。接口中定义的回调方法有:
向某个request对象中增加属性时被调用attributeAdded(ServletRequestAttributeEvent)方法。
从某个request对象中删除属性时被调用attributeRemoved(ServletRequestAttributeEvent)方法。
修改某个request中的属性时被调用attributeReplaced(ServletRequestAttributeEvent)方法。
使用ServletRequestEvent类的getServletRequest()方法可以得到这个被监听的请求对象,使用 ServletRequestAttributeEvent类的getName()方法可以得到属性名,getValue()方法可以得到属性的值。
若有属性加入到某个request对象中时则会调用attributeAdded(),同理在替换属性与删除属性时,会分别调用attributeReplaced()、 attributeRemoved()。
当Web应用程序启动后,在处理任何请求之前,调用contextInitialzed()方法和getInitParamter()方法,返回 在配置文件中为定义的环境初始化信息。不同的组件,如Servlet、JSP、监听器和过滤器等,通过ServletRequest、 HttpSession 和 ServletContext达到数据共享,这些类都提供了下面的一组方法,可以使用这组方法来设置、获取、删除属性:
public void setAttribute("属性名",属性值);
public Object getAttribute("属性名");
public void removeAttribute("属性名");
5.3 监听器管理共享数据库连接
在web.xml中,使用<listener>来配置监听器,语法是:
<listener>
<listener-class>包名.类名</listener-class>
</listener>
比如:创建一个ServletContext对象监听器,在一个Web项目一启动就创建一个与数据库的连接,保存在application对象中,这个连接一直保存到Web项目关闭时为止。程序代码如下:
package ch13;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import java.sql.*;
//import ch7.db.*;
public final class MyConnectionManager implements ServletContextListener {
Connection con=null;
public void contextInitialized(ServletContextEvent e) {//重写接口定义的方法,项目启动是调用该方法
ConnectDB db=new ConnectDB();
con=db.getConnection(); //使用对象db创建数据库连接
e.getServletContext().setAttribute("con",con);//与数据库的连接保存入application对象中
}
public void contextDestroyed(ServletContextEvent e) {//重写接口定义的方法,项目关闭时调用该方法
try {
con.close();
}
catch(Exception e1){}
}
}
在web.xml文件对这个ServletContext类型的监听器进行配置:
<listener>
<listener-class>ch13.MyConnectionManager</listener-class>
</listener>
这个监听器能保证每新创建一个ServletContext对象时(一个Web项目只有一个 ServletContext对象),该Web项目都会有一个可以使用的数据库连接,并且这个数据库连接会在该ServletContext对象关闭(结 束)的时候随之关闭。
测试页面testcon.jsp:
<%@ page contentType="text/html" pageEncoding="GB18030"%>
<br><%= "得到的数据库连接:"+application.getAttribute("con") %>
<br><h1>请注意安装数据库的驱动程序</h1>
5.4 监听器的应用案例
下面是一个在线用户数量监听器,这个监听器可以实时统计在线人数,在 ServletContext初始化和撤消时,在服务器控制台打印出对应信息,当ServletContext对象里的属性增加、修改、删除时,在服务器 控制台打印相应的信息。要完成上面的监听功能,需要使用3个接口:
HttpSessionListener:监督HttpSession对象的创建和撤消,统计人数。
ServletContextListener:监督ServletContext对象的创建和撤消。
ServletContextAttributeListener:监督ServletContext的属性变化。
1.监听器程序代码OnLineCountListener.java
package ch13;
import javax.servlet.*;
import javax.servlet.http.*;
public final class OnLineCountListener implements HttpSessionListener,
ServletContextAttributeListener, ServletContextListener {
private int count;
private ServletContext context=null;
//构造函数
public OnLineCountListener() {
count=0;//人数
}
//重写HttpSessionListener接口中的2个方法,完成对session对象创建和撤消的监视
public void sessionCreated(HttpSessionEvent se) {//创建了一个session对象
count++;//人数加1
setContext(se);
}
public void sessionDestroyed(HttpSessionEvent se){//撤消了一个session对象
count--;//人数减1
setContext(se);
}
private void setContext(HttpSessionEvent se){
se.getSession().getServletContext().setAttribute("onLine",new Integer(count));
}
//重写ServletContextAttributeListener接口中的3个方法
public void attributeAdded(ServletContextAttributeEvent event) {//添加了属性
log("attributeAdded("+event.getName()+","+event.getValue()+")");
}
public void attributeRemoved(ServletContextAttributeEvent event) {//删除了属性
log("attributeRemove("+event.getName()+","+event.getValue()+")");
}
public void attributeReplaced(ServletContextAttributeEvent event) {//替换了原有的属性
log("attributeReplaced("+event.getName()+","+event.getValue()+")");
}
//重写ServletContextListener接口中的2个方法
public void contextDestroyed(ServletContextEvent event) {//Web项目关闭
log("contextDestroyed()");
context=null;
}
public void contextInitialized(ServletContextEvent event) {//Web项目启动
this.context=event.getServletContext();
log("contextInitialized()");
}
//显示信息
private void log(String message){
System.out.println("ContextListener:"+message);
}
}
在OnLineCountListener类中,用count保存目前在线人数,每增加一个session对象,人数加1,每撤消一个session对象,人数减1。人数保存在ServletContext对象中,使得任何页面都可以使用。
2.在web.xml文件中配置监听器
<listener>
<listener-class>ch13.OnLineCountListener</listener-class>
</listener>
3.编写测试页面(2个)
listener.jsp------>exit.jsp
listener.jsp页面内容
<%@ page contentType="text/html;charset=gb2312" %>
目前在线人数:<font color="red"><%=application.getAttribute("onLine")%></font><br>
退出会话:
<form action="exit.jsp" method="post">
<input type="submit" value="exit">
</form>
exit.jsp页面内容
<%@ page contentType="text/html;charset=gb2312" %>
你已经退出会话<% session.invalidate(); %>
可以单独启动5个浏览器窗口,每个窗口代表一个客户,因此在线人数是5。
5.5 HttpSessionBindingListener 接口的使用
设计一个学生对象Student,当将该学生对象存入 session中时,他的年龄增加10岁,当将这个学生对象从session中删除时,他的年龄减少5岁。
学生类Student.java
package ch13;
import javax.servlet.*;
import javax.servlet.http.*;
public class Student implements HttpSessionBindingListener {
private int age=30;
public void valueBound(HttpSessionBindingEvent arg0) {//存入session时自动调用
age+=10;
}
public void valueUnbound(HttpSessionBindingEvent arg0) {//从session中删除时自动调用
age-=5;
}
public int getAge() {return age;}
}
测试页面bind.jsp
<%@ page contentType="text/html;charset=gb2312" import="ch13.Student"%>
<%
Student student=new Student();
out.println("学生年龄:"+student.getAge()+"<br>");
session.setAttribute("st",student);
out.println("存入session后,该学生年龄:"+student.getAge()+"<br>");
session.removeAttribute("st");
out.println("从session删除,该学生年龄:"+student.getAge()+"<br>");
%>