Filter(过滤器)入门

第1章 什么是Filter

1.1 Filter简介

• Filter中文意思为过滤器。顾名思义，过滤器可在浏览器以及目标资源之间起到一个过滤的作用。例如：水净化器，可以看成是生活中的一个过滤器，他可以将污水中的杂质过滤，从而使进入的污水变成净水。

• 对于WEB应用来说，过滤器是一个驻留在服务器中的WEB组件，他可以截取客户端和WEB资源之间的请求和响应信息。

  • WEB资源可能包括Servlet、JSP、HTML页面等。
    

• 当服务器收到特定的请求后，会先将请求交给过滤器，程序员可以在过滤器中对请求信息进行读取修改等操作，然后将请求信息再发送给目标资源。目标资源作出响应后，服务器会再次将响应转交给过滤器，在过滤器中同样可以对响应信息做一些操作，然后再将响应发送给服务器。

- 也就是说过滤器可以在WEB资源收到请求之前，浏览器收到响应之前，对请求和响应信息做一些相应的操作。

• 在一个WEB应用中可以部署多个过滤器，多个过滤器就组成了一个过滤器链，请求和响应必须在经过多个过滤器后才能到达目标；

• 过滤器不是必须将请求传送到下一个过滤器（或WEB资源），也可以自己来处理请求，发送响应。
• 当配置多个Filter以后就有一个执行顺序的问题，实际执行顺序是按照在web.xml文件中servlet-mapping的顺序决定的，如果顺序越靠前越先被调用。

1.2 总结

• Filter是一个接口。
• Filter是Java Web三大组件之一。（JavaWeb三大组件分别是：Servlet小程序、Filter过滤器、Listener监听器）
• Filter是服务器专门用来过滤请求，拦截响应的。
• Filter的常见作用：
  - 检查用户访问权限
  ** - 设置请求响应编码，解决乱码问题**

1.3 主要API

• 编写Filter和编写Servlet类似，都需要实现接口。

1.3.1 Filter接口

• 编写Filter需要实现Filter接口，我们来看一下Filter接口的主要方法：
  
• init()方法用于初始化Filter
• doFilter()作用和service()方法类似，是过滤请求和响应的主要方法。
• destroy()用于在Filter对象被销毁前做一些收尾工作。如：释放资源等。

1.3.2 FilterConfig接口

FilterConfig对象在服务器调用init()方法时传递进来。

• getFilterName() 获取Filter的名字
• getServletContext() 获取ServletContext对象（即application）
• getInitParameter() 获取Filter的初始化参数
• getInitParameterNames() 获取所有初始化参数的名字

1.3.3 FilterChain接口

FilterChain对象是在doFilter()方法被调用时作为参数传递进来的。

• doFilter()方法用于调用Filter链上的下一个过滤器，如果当前过滤器为最后一个过滤器则将请求发送到目标资源。

第2章 Filter初体验

需求：

现在在WebContent目录下有一个目录admin。这个目录是管理员操作的目录。这个目录里有jsp文件，有html文件，还有图片资源文件。现在我们要让这些资源都在用户登录才能被访问。那么我们要怎么实现这样的需求。

思路：

前面我们讲过Session。有同学可能会想，我们可以在用户登录之后把用户的信息保存在Session域对象中。然后在jsp页面里通过Session域对象获取用户的信息。如果用户信息存在，说明用户已登录。否则就重定向到登录页面。这个方案可行。可是html页面呢? html页面是没有Session域对象的。

解决方案：

这就需要我们使用Filter过滤器来进行请求的拦截。然后判断Session域对象中是否包含用户的信息。

现在我们以admin目录下user.jsp为例进行讲解。

1、首先，我们需要创建一个类来实现Filter接口，用来检查Session中是否包含用户信息。

2、实现Filter中的doFilter方法

3、然后到web.xml文件中去配置Filter的过滤信息。

4、然后重启服务器访问测试

操作步骤1：Filter1的类代码

package com.atguigu.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;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class Filter1 implements Filter {
   

	/**
	 * Filter初始化方法
	 */
	public void init(FilterConfig filterConfig) throws ServletException {
   

	}

	/**
	 * Filter的过滤方法
	 */
	public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
			throws IOException, ServletException {
   
		// 强转
		HttpServletRequest httpRequest = (HttpServletRequest) request;
		HttpServletResponse httpResponse = (HttpServletResponse) response;
		// 获取用户登录信息
		String username = (String) httpRequest.getSession().getAttribute("username");
		if (username != null) {
   
			// 过滤器中，只要允许用户访问资源，一定要调用chain.doFilter方法，否则用户永远访问不到资源
			chain.doFilter(request, response);
		} else {
   
			// 如果用户未登录。返回登录页面
			httpResponse.sendRedirect(httpRequest.getContextPath() + "/login.jsp");
		}
	}

	/**
	 * Filter销毁的方法
	 */
	public void destroy() {
   
	}

}

操作步骤2：web.xml文件中的Filter配置

<!-- 配置Filter1 -->
<filter>
	<!-- 给Filter1起一个名字 -->
	<filter-name>Filter1</filter-name>
	<!-- 是哪一个Filter类，即全类名 -->
	<filter-class>com.atguigu.filter.Filter1</filter-class>
</filter>

<filter-mapping>
	<!-- Filter的名字 -->
	<filter-name>Filter1</filter-name>
	<!-- Filter1的过滤地址
		表示过滤http://127.0.0.1:8080/day17/admin/user.jsp
	-->
	<url-pattern>/admin/user.jsp</url-pattern>
</filter-mapping>

除此之外在filter-mapping还有一个子标签dispatcher，该标签用来指定需要Filter处理的请求类型，该标签可以配置四个值：

<!-- 用户直接访问资源时，会调用Filter -->
<dispatcher>REQUEST</dispatcher