过滤器(Filter)

过滤器(Filter)

1. 基本概念

过滤器(Filter)是拦截 Request 请求的对象:在用户的请求访问资源前处理 ServletRequest 和 ServletResponse 。

Filter 相关的接口有:Filter、FilterConfig、FilterChain 。

Filter 的实现必须实现 Filter 接口。这个接口包含了 Filter 的3个生命周期方法:init()doFilter()destroy()

Servlet 容器(Tomcat)初始化Filter时,会触发 Filter 的 init() 方法,一般来说是在应用开始时(注意,不是第一次使用时)。这个方法只会被调用一次。

FilterConfig 对象由 Servlet 容器传入 init() 方法中。

当 Servlet 容器每次处理 Filter 相关的资源时,都会调用该 Filter 实例的 doFilter() 方法。就像容器调用 Serviet 的 service() 方法。

在 Filter 的 doFilter() 方法中,最后一行需要调用 FilterChain 中的 doChain() 方法。注意,FilterChain 是 doFilter() 方法的第三个参数。

一个 URL 资源可能被多个 Filter 关联(即一条 Filter 链),这时 Filter.doFilter() 的方法将触发 Filter 链中下一个 Filter。只有在 Filter 链中最后一个 Filter 里调用 doFilter() 方法,才会触发 Controller 中处理 URL 资源的方法。

如果在 Filter 的 doFilter() 方法中,因为故意(或无意)没有调用 FilterChain 的 doFilter() 方法,那么这个 Request 请求将终止,后面的处理就会中断。

注意,FilterChain 接口中,唯一的方法就是 doFilter() 方法,它和 Filter 接口中的 doFilter() 方法定义是不一样的。

Filter 接口中,最后一个方法是 destroy(),该方法在 Servlet 容器要销毁 Filter 时触发。

类似于 Servlet,Filter 也是单例。

2. Filter 的配置

和 Servlet 的配置非常相似,Filter 的配置主要有三方面:

  • 确认哪些资源需要本 Filter 进行拦截处理。
  • 配置 Filter 的初始化参数和值,这些参数在 Filter 的 init() 方法中可以读取到。
  • 给 Filter 取一个名称(一般来说这个配置是不需要的)。在一些特殊的情况下,系统通过这个名字来识别Filter。
java 复制代码
@WebFilter(filterName = "firstFilter",
            urlPatterns = {"/*"},
            initParams = {
                @WebInitParam(name="", value=""),
                @WebInitParam(name="", value="")
            })
public class FirstFilter implements Filter {
    ...
}
xml 复制代码
<filter>
    <filter-name>firstFilter</filter-name>
    <filter-class>com.hemiao.filter.FirstFilter</filter-class>
    <init-param>
        <param-name>author</param-name>
        <param-value>ben</param-value>
    </init-param>
    <init-param>
        <param-name>email</param-name>
        <param-value>hemiao3000@126.com</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>firstFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
相关推荐
誰能久伴不乏12 小时前
Linux 系统调用详解:操作文件的常用系统调用
服务器·网络·servlet
要站在顶端18 小时前
Jenkins构建间代码变更记录追踪方案
java·servlet·jenkins
Spliceㅤ1 天前
Spring框架
java·服务器·后端·spring·servlet·java-ee·tomcat
中东大鹅1 天前
SpringBoot配置外部Servlet
spring boot·后端·servlet
uppp»3 天前
springboot使用外置的Servlet容器
spring boot·后端·servlet
鱼鱼说测试5 天前
Jenkins接口自动化测试(构建)平台搭建
servlet
南洋十三郎5 天前
JavaWeb学习打卡07(Servlet原理详解、自定义404页面)
java·服务器·学习·http·servlet·打卡·坚持写博客
BD_Marathon6 天前
Servlet快速入门
hive·hadoop·servlet
hie988947 天前
springboot注册servlet
hive·spring boot·servlet
weixin_456904278 天前
javax.servlet.http.HttpServletResponse;API导入报错解决方案
网络协议·http·servlet