java web之Filter

Filter

filter使用户可以改变一个request和修改一个response. Filter 不是一个servlet，它不能产生一个response，它能够在一个request到达servlet之前预处理request，也可以在response离开servlet时处理response.换种说法，filter其实是一个“servlet chaining“（servlet 链）.

通俗来说，在用户发送请求访问服务器的资源时，过滤器可以将请求拦截下来，完成一些特殊的功能。

为了创建自己的拦截器，需要实现Filter接口，并重写以下几个方法。

public class FilterDemo1 implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        System.out.println("demo1被访问!");
        // 增强request
        filterChain.doFilter(servletRequest, servletResponse);
        // 增强response
    }

    @Override
    public void destroy() {
    }
}

doFilter方法会在请求被拦截时执行，在doFilter 方法中调用 FilterChain.doFilter 方法将激活下一个 Filter的doFilter方法，最后一个 Filter.doFilter 方法中调用的 FilterChain.doFilter 方法将激活目标 Servlet的service 方法。

如果Filter 链中有任意一个 Filter 没调用 FilterChain.doFilter 方法，则目标 Servlet 的 service 方法都不会被执行，即该资源无法被访问。

那么在创建了filter类后，该如何使其生效呢？可以通过注解配置或直接在web.xml中配置。

在web.xml中配置

<filter>
  <filter-name>filter1</filter-name>
  <filter-class>com.jundeng.filter.FilterDemo1</filter-class>
</filter>

<filter-mapping>
  <filter-name>filter1</filter-name>
  <!-- 拦截路径 -->
  <url-pattern>/index.jsp</url-pattern>
</filter-mapping>

通过注解配置只需在类上加上注解@WebFilter("/*")， 其中传入的参数是拦截资源的路径，我们下面会进一步说明。

这样，当浏览器访问对应的资源时，doFilter将会被执行并打印出demo1被访问!， 另外init方法在服务器启动时创建filter对象时执行，destroy方法在服务器正常关闭时销毁filter对象时执行。

 

filter拦截路径配置

在filter中，拦截路径的书写方式大致有以下4种：

@WebFilter("/*") // 拦截所有资源
@WebFilter("/user/*") // 拦截目录下所有资源
@WebFilter("index.jsp") // 拦截具体资源
@WebFilter("*.jsp") // 拦截以jsp为后缀的路径

在web.xml 中同理

 

触发filter的访问方式

我们可以设置在说明情况下该filter才会拦截请求，如直接访问，转发访问等

访问方式有以下几种：

1. REQUEST：默认值。浏览器直接请求资源
2. FORWARD：转发访问资源
3. INCLUDE：包含访问资源
4. ERROR：错误跳转资源
5. ASYNC：异步访问资源

@WebFilter(value = "/index.jsp", dispatcherTypes = DispatcherType.FORWARD) // 直接访问
@WebFilter(value = "/index.jsp", dispatcherTypes = {DispatcherType.FORWARD, DispatcherType.REQUEST}) // 直接访问和转发访问

在web.xml中同理，只需设置<dispatcher></dispatcher>标签