Filter 过滤器的使用
导读{
}
【1】什么是Filter（过滤器）？
Filter 被称为过滤器，用于在Servlet 之外就对 request 或者 response 进行修改。
基本功能就是对
Servlet
容器调用
Servlet
的过程进行拦截，从而在
Servlet
进行响应处理前后实现一些特殊功能。
Filter 提出了滤镜链（FilterChain），一个FilterChain 中包含了许多的Filter 。完成的工作就是 客户端发送的请求（request）会在进入Servlet 之前先经过FilterChain 中的Filter，服务器响应（response）会在到达客户端之前先进入 FilterChain中的Filter 中，进行处理。
当浏览器访问服务器中的目标资源时，会被
Filter
拦截，在
Filter
中进行预处理操作，然后再将请求转发给目标资源。当服务器接收到这个请求后会对其进行响应，在服务器处理响应的过程中，也需要先将响应结果发送给拦截器，在拦截器中对响应结果进行处理后，才会发送给客户端。
[2]怎么使用Filter ?
(1)实现Filter 的接口（javax.servlet.Filter;）重写其中的 doFilter() 方法。
注意：（doFilter() 中必须实现 chain.doFilter() 这个方法，chain.doFilter()将request 提交给下一个Filter ，当所有的Filter执行完后，就交给Servlet 进行处理。如果不执行这个方法 request 不会交给后面的Filter 或者 Servlet 进行处理）
(2)在web.xml配置Filter 的参数。
主要配置 <filter> 和 <filter-mapping> (跟servlet 的配置差不多)
<!-- 配置过滤器 --><filter><filter-name>MyFilter</filter-name><filter-class>filter.MyFilter</filter-class></filter><filter-mapping><filter-name>MyFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping>
参数注意： name 一致，class 是 包名.类名
url-pattern 可以配置多个，可以是通配符（*） /*
使用通配符“*”来实现让过滤器拦截所有的请求访问
/jsp/* 适用于以 /jsp/ 的Servlet 路径
<filter-mapping>
元素中有一个特殊的子元素
<dispatcher>
，该元素用于指定过滤器所拦截的资源被
Servlet
容器调用的方式
<dispatcher>（调度者） 配置到达Servlet 的四种方式：
FORWOED： 表示仅当某Servlet 通过FORWARD 到该Servlet 时才有效。
INCLUDE: JSP中可以通过<jsp;include /> 请求某 Servlet 。 仅这种情况下有效。
ERROR： JSP中可以通过<%@ page errorPage="error.jsp"> 指定错误处理页面，
仅这种情况下有效。
而且拦截的request 必须同时满足
url-pattern 和
<dispatcher> 的条件，才拦截
如果不写
<dispatcher> ，默认是
REQUEST
【3】Filter 的生命周期
package filter;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;public class MyFilter implements Filter {//创建过滤器对象后，立即执行本方法（当web 程序加载的时候调用，只执行一次）public void init(FilterConfig arg0) throws ServletException {System.out.println("init()....");}//拦截用户的请求，如果请求资源路径和当前过滤器的拦截路径匹配时，就执行本方法public void doFilter(ServletRequest req, ServletResponse res,FilterChain chain) throws IOException, ServletException {System.out.println("request 被处理之前...");//放行（将请求交给下一个过滤器或者交给目标资源）chain.doFilter(req, res);System.out.println("request 被处理之后，response 抵达客户端浏览器之前...");}//过滤器对象销毁前执行，（当web 程序卸载的时候调用，只执行一次）public void destroy() {System.out.println("destory....");}- }
运行结果：
加载web程序
可以看见
（当web 程序加载的时候调用，只执行一次）
访问我们的MyServlet
可以看出，先进入doFilter 方法中，当调用
chain
.
doFilter
(
req
,
res
);
后进入 Myservlet.java 中 ，在处理完 request 后，返回到 doFilter () 方法中。
(doFilter() 中必须实现 chain.doFilter() 这个方法，chain.doFilter()将request 提交给下一个Filter ，当所有的Filter执行完后，就交给Servlet 进行处理。如果不执行这个方法 request 不会交给后面的Filter 或者 Servlet 进行处理）
Myservlet.java
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { System.out.println("myServlet...."); }
当我们关掉服务器，执行
destroy() 方法
演示
<dispatcher>
为 FORWORD 时。
Servlet ： 我们将转发到 index.jsp 页面
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //通过请求转发得到目标资源 request.getRequestDispatcher("/index.jsp").forward(request, response); }
Filter 执行输出语句到页面
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { res.getWriter().print("myFilter..."); }
web.xml 配置信息
<filter> <filter-name>MyFilter</filter-name> <filter-class>filter.MyFilter</filter-class> </filter> <filter-mapping> <filter-name>MyFilter</filter-name> <url-pattern>/index.jsp</url-pattern> <dispatcher>FORWARD</dispatcher> </filter-mapping>
结果：
注意：转发的页面必须是在 url-pattern 中满足的
源码：
https://github.com/gengzi/javaweb--Filter-.git day30_01
【4】处理多个Filter ，执行的先后次序
我们在配置文件配置出来 两个 Filter ， 创建两个 Filter 类出来
<!-- 配置MyFilter01 --> <filter> <filter-name>MyFilter01</filter-name> <filter-class>filter.MyFilter01</filter-class> </filter> <filter-mapping> <filter-name>MyFilter01</filter-name> <url-pattern>/MyServlet</url-pattern> </filter-mapping> <!-- 配置MyFilter02 --> <filter> <filter-name>MyFilter02</filter-name> <filter-class>filter.MyFilter02</filter-class> </filter> <filter-mapping> <filter-name>MyFilter02</filter-name> <url-pattern>/MyServlet</url-pattern> </filter-mapping>
执行其中的 doFilter 方法
MyFilter01.java
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { PrintWriter out = res.getWriter(); out.print("myFilter01..."); //放行 chain.doFilter(req, res); out.print("myFilter01 back..."); }
MyFilter02.java
public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { PrintWriter out = res.getWriter(); out.print("myFilter02..."); //放行 chain.doFilter(req, res); out.print("myFilter02 back..."); }
运行结果：
可以看出，在配置文件中配置Filter 目录
哪一个在前面，就先经过那一个Filter。
我们在配置文件中 先配置的是
MyFilter01 ，则先走这个过滤器。然后再走
MyFilter02 过滤器，
然后将request（请求）进入到servlet 中处理，然后再返回到过滤器中
【5】拿取Filter 中配置文件的初始化参数信息
为了拿到在web.xml 中的配置信息，我们需要用到 FilterConfig 接口的内容
FilterConfig接口
为了获取Filter程序在web.xml文件中的配置信息，Servlet API提供了一个FilterConfig接口，该接口封装了Filter程序在web.xml中的所有注册信息，并且提供了一系列获取这些配置信息的方法。
下面我们在配置文件配置两个Filter
<filter> <filter-name>MyFilter</filter-name> <filter-class>filter.MyFilter</filter-class> <!-- 初始化参数配置 --> <init-param> <param-name>school</param-name> <param-value>rjxy</param-value> </init-param> </filter> <filter-mapping> <filter-name>MyFilter</filter-name> <url-pattern>/MyServlet</url-pattern> </filter-mapping> <filter> <filter-name>myFilter01</filter-name> <filter-class>filter.Filter01</filter-class> <init-param> <param-name>name</param-name> <param-value>耿帅佳</param-value> </init-param> </filter>
在我们的Filter 类中获取
package filter;import java.io.IOException;import javax.servlet.Filter;import javax.servlet.FilterChain;import javax.servlet.FilterConfig;import javax.servlet.ServletContext;import javax.servlet.ServletException;import javax.servlet.ServletRequest;import javax.servlet.ServletResponse;public class MyFilter implements Filter { public void destroy() { // TODO Auto-generated method stub } public void doFilter(ServletRequest arg0, ServletResponse arg1, FilterChain arg2) throws IOException, ServletException { // TODO Auto-generated method stub } public void init(FilterConfig config) throws ServletException { // 获取过滤器名字 String name = config.getFilterName(); System.out.println(name); //获取SerletContext对象 ServletContext sc = config.getServletContext(); System.out.println(sc); //获取初始化参数根据参数名 String value = config.getInitParameter("school"); System.out.println(value); }}
在init() 方法中，有我们的
FilterConfig
接口
结果：
这就是 我们拿到的 两个初始化信息
源码：https://github.com/gengzi/javaweb--Filter-.git day30_04
【6】常见的Filter - 字符编码
在Web开发中，经常会遇到中文乱码问题，现在，我们可以在Filter中对获取到的请求和响应消息进行编码，从而统一全站的编码方式。
那么我们处理的就是 get 或者 post 请求发生的中文乱码情况。
那我们的思路应该是：
（1）用户请求 （get 或者 post 方式）
（2）先走Filter 中，判断是 get 还是 post 请求方式，获取用户的请求的数据，并根据不同的请求方式来处理中文乱码。
（3）然后走 Servlet 方法就完成了。
************************************************
Filter过滤器可以获取到代表用户请求和响应的request、response对象。可是如果想对request和response对象中的任何信息进行修改，则需要通过包装类来实现。
在Servlet API中，提供了HttpServletRequestWrapper和HttpServletResponseWrapper两个类，它们分别是request和response对象的包装类。
***************************************************
代码实现：
package filter;import java.io.IOException;import java.io.UnsupportedEncodingException;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.http.HttpServletRequest;import javax.servlet.http.HttpServletRequestWrapper;import javax.servlet.http.HttpServletResponse;/** * 字符过滤器处理中文乱码 * @author Administrator * */public class CharacterFilter implements Filter { public void destroy() { // TODO Auto-generated method stub } public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest)req; HttpServletResponse response = (HttpServletResponse)res; //拦截请求处理乱码 //post请求 request.setCharacterEncoding("UTF-8"); response.setContentType("text/html;charset=UTF-8"); /* * 对request进行包装 * characterRequest功能增强了，获取中文参数直接处理乱码 */ CharacterRequest characterRequest = new CharacterRequest(request); //放行 chain.doFilter(characterRequest, response); } public void init(FilterConfig arg0) throws ServletException { // TODO Auto-generated method stub }}//对request对象重新包装（增强的功能：处理get请求的中文乱码）class CharacterRequest extends HttpServletRequestWrapper{ public CharacterRequest(HttpServletRequest request) { super(request); // TODO Auto-generated constructor stub } /* * 重写getParameter(),增强的功能：处理get请求的中文乱码 */ public String getParameter(String name){ //调用被包装对象已有的方法，获取请求参数 String value = super.getParameter(name); if(value == null){ return null; } //判断请求方式 String method = super.getMethod(); //如果是get请求 if("get".equalsIgnoreCase(method)){ try { value = new String(value.getBytes("ISO-8859-1"),"UTF-8"); } catch (UnsupportedEncodingException e) { // TODO Auto-generated catch block e.printStackTrace(); } } return value; } }
配置文件
<?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"> <!-- 配置字符过滤器 --> <filter> <filter-name>CharacterFilter</filter-name> <filter-class>filter.CharacterFilter</filter-class> </filter> <filter-mapping> <filter-name>CharacterFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <servlet> <servlet-name>CharacterServlet</servlet-name> <servlet-class>servlet.CharacterServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>CharacterServlet</servlet-name> <url-pattern>/CharacterServlet</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list></web-app>
演示结果：
点击 “get方式” 得到结果
输入“耿帅佳” post 提交
结果：
![]()
![]()
特别注意：
【1】页面编码方式与 Filter 的编码方式必须一致 。
【2】如果表单是GET 方式提交的，还需要修改Tomcat 的conf/server.xml 配置文件，指定 URIEncoding（默认为ISO-8859-1）；
否则，依然会乱码。
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="ISO-8859-1" />
处理中文乱码-Filter 源码： day30_06
扫一扫
8291
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
