JavaWeb Filter

 

Servlet用于处理用户请求，Filter（过滤器）用于拦截request、response，对request、response对象进行修改，在Servlet处理请求前后实现某些功能。

Filter接口

Filter是一个实现了javax.servlet.Filter接口的类。

Filter接口中的方法：

• init(FilterConfig  filterFonfig)    //初始化Filter
• doFilter(ServletRequest request, ServletResponse response, FilterChain  chain)     //拦截、过滤。chain对象表示Filter链。此方法是Filter的关键方法。
• destroy()   //在web服务器移除Filter对象之前调用，释放Filter对象占用的资源

public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException {
        //......    //去的时候拦截，做一些处理
        chain.doFilter(req, resp);  //放行
        //......    //回来的时候拦截，做一些处理
    }

Filter示例   统一全站编码

@WebFilter("/*")
public class HandlerFilter implements Filter {
    public void init(FilterConfig config){
    }

    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException {
        req.setCharacterEncoding("utf-8");
        resp.setContentType("text/html;charset=utf-8");
        chain.doFilter(req, resp);
    }

    public void destroy() {
    }

}

Filter的配置

Filter的配置方式和Servlet的配置方式差不多。

（1）xml配置

　　<filter>
        <filter-name>handlerFilter</filter-name>
        <filter-class>filter.HandlerFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>handlerFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

如果有多个Filter同时拦截某个请求，这些Filter会组成一个FilterChain，拦截时，在xml配置中位置靠前的Filter先拦截。

（2）注解配置

@WebFilter("/*")

@WebFilter(filterName = "handlerFilter",urlPatterns = "/*")

Filter初始参数

在xml中配置Filter的初始参数：

<filter>
        <filter-name>handlerFilter</filter-name>
        <filter-class>filter.HandlerFilter</filter-class>
        <init-param>
            <param-name>name</param-name>
            <param-value>张三</param-value>
        </init-param>
        <init-param>
            <param-name>age</param-name>
            <param-value>20</param-value>
        </init-param>
    </filter>

或者在注解中配置：

@WebFilter(
        filterName = "handlerFilter",
        urlPatterns = "/*",
        initParams = {@WebInitParam(name = "name", value = "张三"),@WebInitParam(name="age",value = "12")}
        )

我们注意到Filter的init(FilterConfig config)有参数FilterConfig，Web服务器创建此Filter的实例时，会自动把xml或注解中这个Filter的初始参数以FilterConfig对象的形式注入。

在Filter中获取初始参数：

public class HandlerFilter implements Filter {
    private FilterConfig filterConfig;   //需要创建一个成员变量
    public void init(FilterConfig config){
        this.filterConfig = config;  //需要我们手动初始化
    }

    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws ServletException, IOException {
        //获取单个初始参数的值
        String name = filterConfig.getInitParameter("name");  //返回值是String，不存在该参数时返回null
        String age = filterConfig.getInitParameter("age");
        System.out.println(name);
        System.out.println(age);

        //遍历
        Enumeration<String> initParameterNames = filterConfig.getInitParameterNames();
        while (initParameterNames.hasMoreElements()){
            String paramName = initParameterNames.nextElement();
            String paramValue = filterConfig.getInitParameter(paramName);
            System.out.println(paramValue);
        }

        chain.doFilter(req, resp);
    }

    public void destroy() {
    }

}

  

使用Filter检查用户权限

用户要访问、下载某些资源，我们常常要检查用户权限是否足够，有的是检查用户是否已登录。

我们可以在在session域中放入用户权限|状态，比如session.setAttrbute("group", "vip") ，使用Filter检查用户权限 | 是否已登录，如果权限够了，不做处理，放行。如果权限不够，使用request转发或response重定向转到提示页面，也可以response直接输出提示信息。

Filter做前后增强，Servlet负责处理核心业务，业务逻辑不杂糅在一起，类似于Spring AOP。

有时候需要获取所请求的URL，根据URL来判断，比如...../resource/vip/........，普通用户不能访问里面的资源。

String requestURI = request.getRequestURI();
     /*
     String类型，所请求资源的相对地址，/项目名/页面
     比如 /StudentManagerSystem/handlerServlet
      */


     StringBuffer requestURL = request.getRequestURL();
     /*
     StringBuffer类型，所请求资源的绝对地址
     比如 http://localhost:8080/StudentManagerSystem/handlerServlet
      */

这2种方式获取的地址均不带请求参数？......&.......。既然是统一资源定位符，是标识互联网上的资源的，资源本身自然不带请求参数。