过滤器在Web开发过程中至关重要,可以减少我们的代码量,在访问某些路径之前做一些处理,如果使用了过滤器,那么过滤器会在Servlet之前执行,我们可以控制其是否继续向下执行。
要想创建过滤器,我们需要实现javax.servlet.Filter
接口,该接口提供了三个方法:
返回值 | 方法名 | 说明 |
---|---|---|
public abstract void | init(javax.servlet.FilterConfig arg0) | 初始化时执行 |
public abstract void | doFilter(javax.servlet.ServletRequest arg0, javax.servlet.ServletResponse arg1, javax.servlet.FilterChain arg2) | 执行过滤 |
public abstract void | destroy() | 销毁时执行 |
我们在之前的博客中有写过这样一句代码request.setCharacterEncoding("UTF-8");
,作用是设置请求的字符编码为UTF-8,用于处理中文乱码,如果我们在每一个Servlet里面都写这样一段话就会造成代码冗余,所以我们就可以在使用过滤器来处理。
package com.gujin.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 CharsetFilter implements Filter
{
@Override
public void destroy()
{
}
@Override
public void doFilter(ServletRequest req, ServletResponse res,
FilterChain chain) throws IOException, ServletException
{
// 设置字符编码
req.setCharacterEncoding("UTF-8");
// 过滤器继续向下执行
chain.doFilter(req, res);
}
@Override
public void init(FilterConfig arg0) throws ServletException
{
}
}
AI 代码解读
这样我们就编写好了一个基本的字符过滤器,我们需要特别注意chain.doFilter(req, res);
,这句代码用于让过滤器继续向下执行,如果配置了多个过滤器,将控制权传递给下一个过滤器,直至Servlet,如果不写该代码,则请求不再继续向下执行。最后,要想让过滤器生效,我们还需要在web.xml
中进行配置
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>Servlet</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<servlet>
<description></description>
<display-name>Test</display-name>
<servlet-name>Test</servlet-name>
<servlet-class>com.gujin.servlet.Test</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Test</servlet-name>
<url-pattern>/Test</url-pattern>
</servlet-mapping>
<!-- 过滤器 -->
<filter>
<filter-name>charset</filter-name>
<filter-class>com.gujin.filter.CharsetFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>charset</filter-name>
<!-- 拦截所有地址 -->
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
AI 代码解读
至此,我们的过滤器就生效了。设置字符编码是过滤器常用的功能,我们利用过滤器还可以做身份验证、拦截等功能,各位可以自己尝试一下。