实现Servlet过滤器关键有两点,实现Filter接口,在web.xml中配置过滤器。
要实现Filter接口,首先了解Filter接口声明了哪些方法:
web 应用程序启动时,web 服务器将创建Filter 的实例对象,并调用其init方法,读取web.xml配置,完成对象的初始化功能,从而为后续的用户请求作好拦截的准备工作。
init()方法中提供了一个FilterConfig对象,这是一个配置对象,在web.xml中可以进行如下配置:
<filter>
<filter-name>FilterTest</filter-name>
<filter-class>com.hellotomcat.test.FilterTest</filter-class>
<init-param>
<param-name>name</param-name>
<param-value>value</param-value>
</init-param>
</filter>
一般情况下只需要配置<filter-name>和<filter-class>即可,配置的参数可以在init()方法中获取:
public void init(FilterConfig config) throws ServletException {
// 获取初始化参数
String value = config.getInitParameter("name");
// 输出初始化参数
System.out.println("name: " + value);
}
该方法完成实际的过滤操作,当客户端请求方法与过滤器设置匹配的URL时,Servlet容器将先调用过滤器的doFilter方法。该方法参数列表中最后一个参数FilterChain是过滤链,用于返回响应。
一个示例:
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws java.io.IOException, ServletException {
// 控制台输出访问信息
System.out.println("正在访问***站点");
// 把请求传回过滤链
chain.doFilter(request,response);
}
用于在过滤器被回收时释放资源。
<filter>
<filter-name>FilterTest</filter-name>
<filter-class>com.hellotomcat.test.FilterTest</filter-class>
<init-param>
<param-name>name</param-name>
<param-value>value</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>FilterTest</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
如果需要配置多个过滤器,只需要在配置文件中依次配置每个过滤器即可。web.xml 中的 filter-mapping 元素的顺序决定了 Web 容器应用过滤器到 Servlet 的顺序。