Java Web 基础 - 过滤器

  • 过滤器是一种服务端组件，可以截取客户端请求和响应信息，对信息进行过滤，包括过滤源 -> 过滤规则 -> 过滤结果；
  • 过滤器可以改变用户请求的 Web 资源（用户请求路径），但不能直接返回数据、处理用户请求（不是标准的 Servlet）；
  • 常见使用场景：对请求进行统一认证、编码转换、对发送的数据进行过滤替换、转换图形格式、对响应内容压缩等。

工作原理与生命周期

Web 容器启动使过滤器即启动，接收到用户请求后判断是否符合规则，过滤器把符合规则的请求发送至 Web 资源，处理完成后再经过滤器返回响应给用户。

生命周期：

  1. 实例化（Web 容器启动时加载 web.xml，只实例化一次 ）；
  2. 初始化（init() 方法）；
  3. 对每个请求过滤方法（doFilter() 方法）；
  4. 销毁（Web 容器关闭时执行 destroy() 方法销毁）

实现一个过滤器

web.xml

<filter>        
    <filter-name>FirstFilter</filter-name>          <!-- 过滤器类完整名字和包名 -->
    <filter-class>com.ywh.filter.FirstFilter</filter-class>
    <init-param>
        <param-name>name</param-name>               <!-- 初始化参数 -->
        <param-value>ywh</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>FirstFilter</filter-name>          <!-- 用户请求的 URL 匹配时触发过滤器工作 -->
    <url-pattern>/index.jsp</url-pattern>
    <dispatcher>FORWARD</dispatcher>                <!-- 执行操作，可以是 REQUEST、INCLUDE、FORWARD、ERROR，默认为 REQUEST -->
</filter-mapping>

FirstFilter.java

public class FirstFilter implements Filter {

    @Override
    public void destroy() {
        System.out.println("destroy---FirstFilter");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        System.out.println("start----doFilter--FirstFilter");
//      chain.doFilter(request, response);
        HttpServletRequest req =(HttpServletRequest) request;
        HttpServletResponse response2 =(HttpServletResponse) response;
        response2.sendRedirect(req.getContextPath() + "/main.jsp");
//      req.getRequestDispatcher("main.jsp").forward(request, response);
//      req.getRequestDispatcher("main.jsp").include(request, response);
        System.out.println("end------doFilter--FirstFilter");
    }

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        System.out.println("init----FirstFilter");
    }
}

过滤器链

对于同一个 URL 可以设置多个过滤器按指定顺序执行。


过滤器链的执行逻辑
<filter>
    <filter-name>FirstFilter</filter-name>          <!-- 过滤器类完整名字和包名 -->
    <filter-class>com.ywh.filter.FirstFilter</filter-class>
    <init-param>
        <param-name>name</param-name>               <!-- 初始化参数 -->
        <param-value>zhangsan</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>FirstFilter</filter-name>          <!-- 用户请求的 URL 匹配时触发过滤器工作 -->
    <url-pattern>/index.jsp</url-pattern>
</filter-mapping>
<filter>
    <filter-name>SecondFilter</filter-name>
    <filter-class>com.ywh.filter.SecondFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>SecondFilter</filter-name>
    <url-pattern>/index.jsp</url-pattern>
</filter-mapping>

过滤器分类

在 Servlet 2.5 中过滤器有四种：

  • REQUEST：用户直接访问页面时调用（重定向、转发）；
  • FORWARD：目标资源是通过 RequestDispatcher 的 forward 访问时调用；
  • INCLUDE：目标资源是通过 RequestDispatcher 的 incluer 方法调用时调用；
  • ERROR：目标资源是通过声明式异常处理机制调用时调用。

在 Servlet 3.0 中加入了 ASYNC 支持异步处理。

过滤器注解

使用 @WebFilter 注解将一个类生命为过滤器（在部署时被容器处理，容器将根据具体的属性配置将类部署为过滤器），代替 web.xml 配置过滤器类

@WebFilter(servletNames = {"SimpleServlet"}, filterName="SimpleFilter", value={"/index.jsp"}, dispatcherTypes={DispatcherType.Async})
public class TestFilter implements Filter {
    // ...
}
@WebFilter 常用属性

实例：测试异步过滤器

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
    <display-name></display-name>
    <servlet>
        <description>This is the description of my J2EE component</description>
        <display-name>This is the display name of my J2EE component</display-name>
        <servlet-name>AsynServlet</servlet-name>
        <servlet-class>com.ywh.servlet.AsynServlet</servlet-class>
        <async-supported>true</async-supported>
    </servlet>

    <servlet-mapping>
        <servlet-name>AsynServlet</servlet-name>
        <url-pattern>/servlet/AsynServlet</url-pattern>
    </servlet-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

AsynServlet.java

public class AsynServlet extends HttpServlet {

    public AsynServlet() {super(); }

    public void destroy() { super.destroy(); }

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("Servletִ 执行开始时间：" + new Date());
        AsyncContext context = request.startAsync();
        new Thread(new Executor(context)).start();
        System.out.println("Servletִ 执行结束时间：" + new Date());
    }

    public class Executor implements Runnable {
        private AsyncContext context;

        public Executor(AsyncContext context) { this.context = context; }

        @Override
        public void run() {
            try {
                Thread.sleep(1000 * 10);
                System.out.println("业务执行完成时间：" + new Date());
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }

    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.println("<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\">");
        out.println("<HTML>");
        out.println("  <HEAD><TITLE>A Servlet</TITLE></HEAD>");
        out.println("  <BODY>");
        out.print("    This is ");
        out.print(this.getClass());
        out.println(", using the POST method");
        out.println("  </BODY>");
        out.println("</HTML>");
        out.flush();
        out.close();
    }

    public void init() throws ServletException { }
}

AsynFilter.java

@WebFilter(
    filterName = "AsynFilter", 
    asyncSupported = true, 
    value = {"/servlet/AsynServlet"}, 
    dispatcherTypes = {DispatcherType.REQUEST, DispatcherType.ASYNC}
    )
public class AsynFilter implements Filter {

    @Override
    public void destroy() {}

    @Override
    public void doFilter(ServletRequest arg0, ServletResponse arg1, FilterChain arg2) throws IOException, ServletException {
        System.out.println("start.....AsynFilter");
        arg2.doFilter(arg0, arg1);
        System.out.println("end.....AsynFilter");
    }

    @Override
    public void init(FilterConfig arg0) throws ServletException {}
}

实例：对用户请求进行统一认证

login.jsp

<body>
    <form action="<%=request.getContextPath() %>/servlet/LoginServlet" method="post">
        用户名:<input type="text" name="username">
        密码:<input type="password" name="password">
        <input type="submit" value="提交">
    </form>
</body>

LoginServlet.java

public class LoginServlet extends HttpServlet {

    public LoginServlet() { super(); }

    public void destroy() { super.destroy(); }

    public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        String username = request.getParameter("username");
        String password = request.getParameter("password");

        System.out.println(username);

        if ("admin".equals(username) && "admin".equals(password)) {
            // 校验通过
            HttpSession session = request.getSession();
            session.setAttribute("username", username);
            response.sendRedirect(request.getContextPath() + "/sucess.jsp");
        } else {
            // 校验失败
            response.sendRedirect(request.getContextPath() + "/fail.jsp");
        }
    }

    public void init() throws ServletException { }
}

LoginFilter.java

public class LoginFilter implements Filter {

    private FilterConfig config;

    @Override
    public void destroy() { }

    @Override
    public void doFilter(ServletRequest arg0, ServletResponse arg1, FilterChain arg2) throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) arg0;
        HttpServletResponse response = (HttpServletResponse) arg1;
        HttpSession session = request.getSession();

        String noLoginPaths = config.getInitParameter("noLoginPaths");

        String charset = config.getInitParameter("charset");
        if (charset == null) {
            charset = "UTF-8";
        }
        request.setCharacterEncoding(charset);

        if (noLoginPaths != null) {
            String[] strArray = noLoginPaths.split(";");
            // 获取不需要重定向的页面，符合条件则放行（如对于 login.jsp 不再执行重定向）
            for (int i = 0; i < strArray.length; i++) {
                if (strArray[i] == null || "".equals(strArray[i])) 
                    continue;
                if (request.getRequestURI().indexOf(strArray[i]) != -1) {
                    arg2.doFilter(arg0, arg1);
                    return;
                }
            }
        }
        if (session.getAttribute("username") != null) {
            arg2.doFilter(arg0, arg1);
        } else {
            response.sendRedirect("login.jsp");
        }
    }

    @Override
    public void init(FilterConfig arg0) throws ServletException { config = arg0; }

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <display-name></display-name>
    <servlet>
        <description>This is the description of my J2EE component</description>
        <display-name>This is the display name of my J2EE component</display-name>
        <servlet-name>LoginServlet</servlet-name>
        <servlet-class>com.ywh.serlvet.LoginServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>LoginServlet</servlet-name>
        <url-pattern>/servlet/LoginServlet</url-pattern>
    </servlet-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
    <filter>
        <filter-name>LoginFilter</filter-name>
        <filter-class>com.ywh.filter.LoginFilter</filter-class>
        <init-param>
            <param-name>noLoginPaths</param-name>    <!-- 不需要重定向的页面 -->
            <param-value>login.jsp;fail.jsp;LoginServlet</param-value>
        </init-param>
        <init-param>
            <param-name>charset</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>LoginFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 212,686评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,668评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 158,160评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,736评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,847评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 50,043评论 1赞 291
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,129评论 3赞 410
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,872评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,318评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,645评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,777评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,470评论 4赞 333
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 40,126评论 3赞 317
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,861评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1赞 267
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,589评论 2赞 362
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,687评论 2赞 351

推荐阅读更多精彩内容

  • 我的心理医生（四）
    自杀 在《自杀论》中，将人们产生于过分个人主义的特殊类型自杀称为利己主义的自杀。其实，从自杀人的这方面来说，我们...
    里带阅读 406评论 0赞 2
  • 超级记忆-D9-数字编码-1
    数字编码法 第一天 9.26 周二 1.【1-20编码学习】 (我将给出大家1-20的数字编码图像，大家调动自己的...
    PP龙青阅读 1,025评论 0赞 1
  • 故事的结局
    她从小在哥哥的爱护下长大。 二八年华，在读高中的她非常欣赏一个男生，一开始时她只关注他的文字，渐渐地，她努力去了解...
    凌梓木阅读 339评论 0赞 4