过滤器(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>
相关推荐
ernesto_ji8 小时前
Jenkins下载安装、构建部署到linux远程启动运行
linux·servlet·jenkins
书埋不住我10 小时前
java第三章
java·开发语言·servlet
运维老司机2 天前
jenkins离线安装插件
运维·servlet·jenkins
运维老司机2 天前
Jenkins更换主题颜色+登录页面LOGO图片
运维·servlet·jenkins
java小吕布3 天前
Java Servlet详解:Servlet的生命周期、请求处理与响应发送
java·开发语言·servlet
namedlock4 天前
Failed to create a temp file - Jenkins 无法创建任务
java·servlet·jenkins
ling-454 天前
Javaweb-day12(登录认证)
服务器·前端·servlet
龙仔7255 天前
麒麟系统下docker搭建jenkins
servlet·docker·jenkins
cuisidong19977 天前
Springmvc配置文件application.xml 和 spring-servlet.xml
xml·spring·servlet
路在脚下@8 天前
Springboot 的Servlet Web 应用、响应式 Web 应用(Reactive)以及非 Web 应用(None)的特点和适用场景
java·spring boot·servlet