Servlet & JSP - Filter

2022-11-19 19:38:02

过滤器可以对用户的请求拦截，进行预处理操作，接着将请求交给 Servlet 处理并生成响应，最后再对响应拦截，进行后处理操作。过滤器应用的场景有：用户登录、加密解密、会话校验等。

Filter API

过滤器必须继承 javax.servlet.Filter 接口。Filter 接口暴露三个生命周期方法：init、doFilter 和 destroy。

init: 当容器将过滤器引入服务的时候（通常是应用启动的时候），init 方法会被调用。Servlet 容器调用 init 方法时会传入一个 javax.servlet.FilterConfig 参数。FilterConfig 包含了过滤器的配置信息，如过滤器的名称、初始化参数、上下文环境等。

doFilter: 当过滤器关联的资源被请求时，doFilter 方法会被调用。doFilter 方法接收三个参数：ServletRequest、ServletResponse 和 FilterChain。ServletRequest 和 ServletResponse 是被拦截的请求和响应对象，我们可以对其做一些处理，如对请求设置属性或者在响应添加 HTTP 首部，甚至是使用装饰器来改变请求和响应的行为。调用 FilterChain 的 doFilter 方法将请求和响应传递至过滤器链的下一个过滤器或目标资源。在 filterChain.doFilter(request, response) 方法调用之前的操作是预处理，在 filterChain.doFilter(request, response) 方法调用之后的操作是后处理。

destroy: 当容器将过滤器移出服务的时候（通常是应用停止的时候），destroy 方法会被调用。

配置过滤器

1. 使用部署描述符配置：

<filter>

    <filter-name>myFilter</filter-name>

    <filter-class>com.huey.hello.filters.MyFilter</filter-class>

</filter>

<filter-mapping>

    <filter-name>myFilter</filter-name>

    <url-pattern>/*</url-pattern>

</filter-mapping>

2. 在 Servlet3.0 可以使用 @WebFilter 注解配置：

@WebFilter(filterName = "myFilter", urlPatterns = {"/*"})

public class MyFilter implements Filter {

    // ...

}

过滤器的作用顺序

当多个过滤器作用在同一资源时，过滤器的作用顺序由其在部署描述符中的声明顺序决定，使用 @WebFilter 注解无法指定作用顺序。假设有 Filter1 和 Filter2 作用在同一个资源，且 Filter1 在 Filter2 之前声明，那么作用顺序为：Filter1 的预处理 ---> Filter2 的预处理 ---> 目标资源的处理 ---> Filter2 的后处理 ---> Filter1 的后处理。

应用示例

package com.huey.hello.filters;

import java.io.IOException;

import javax.servlet.Filter;

import javax.servlet.FilterChain;

import javax.servlet.FilterConfig;

import javax.servlet.ServletException;

import javax.servlet.ServletRequest;

import javax.servlet.ServletResponse;

import javax.servlet.annotation.WebFilter;

import javax.servlet.annotation.WebInitParam;

import javax.servlet.http.HttpServletRequest;

import com.huey.hello.wrapper.CharsetServletRequestWrapper;

/**

 * 使用注解配置 Filter

 * urlPatterns 配置关联的目标资源

 * initParams 配置初始参数

 */

@WebFilter(filterName="charsetFilter", urlPatterns = {"/*"},

        initParams = {

                @WebInitParam(name = "oldCharset", value = "ISO-8859-1"),

                @WebInitParam(name = "newCharset", value = "UTF-8"),

        })

public class CharsetFilter implements Filter {

    private String oldCharset;

    private String newCharset;

    @Override

    public void init(FilterConfig filterConfig) throws ServletException {

        oldCharset = filterConfig.getInitParameter("oldCharset");

        newCharset = filterConfig.getInitParameter("newCharset");

    }

    @Override

    public void destroy() {

    }

    @Override

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)

            throws IOException, ServletException {

        request.setCharacterEncoding(newCharset);

        response.setContentType("text/plain;charset=" + newCharset);

        HttpServletRequest httpRequest = (HttpServletRequest) request;

        CharsetServletRequestWrapper requestWrapper = new CharsetServletRequestWrapper(httpRequest, oldCharset, newCharset);

        chain.doFilter(requestWrapper, response);

    }

}

码农公寓

Filter API

配置过滤器

过滤器的作用顺序

应用示例

相关文章