Servlet中配置和使用过滤器
在Servlet中配置和使用过滤器主要包括创建过滤器类、配置过滤器以及在Web应用中使用过滤器等步骤,以下是具体内容:
创建过滤器类
- 过滤器类需要实现
javax.servlet.Filter
接口,并重写其中的init
、doFilter
和destroy
方法。init
方法用于过滤器的初始化,在服务器启动时被调用,通常用于加载配置文件、初始化资源等操作。doFilter
方法是过滤器的核心方法,用于实现具体的过滤逻辑,对每个进入过滤器链的请求和响应进行处理。destroy
方法在服务器关闭时被调用,用于释放过滤器占用的资源。
以下是一个简单的过滤器类示例,用于统一设置请求和响应的字符编码为UTF-8:
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 java.io.IOException;
public class CharacterEncodingFilter implements Filter {
private String encoding;
@Override
public void init(FilterConfig filterConfig) throws ServletException {
// 从web.xml中获取配置的字符编码,如果没有配置则使用默认的UTF-8
encoding = filterConfig.getInitParameter("encoding");
if (encoding == null) {
encoding = "UTF-8";
}
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain filterChain) throws IOException, ServletException {
// 设置请求的字符编码
request.setCharacterEncoding(encoding);
// 设置响应的字符编码
response.setContentType("text/html;charset=" + encoding);
// 将请求传递给下一个过滤器或Servlet
filterChain.doFilter(request, response);
}
@Override
public void destroy() {
// 释放资源,这里没有需要释放的资源,所以为空方法
}
}
配置过滤器
- 注解方式(Servlet 3.0及以上):在过滤器类上使用
@WebFilter
注解来配置过滤器。可以指定过滤的URL模式、过滤器名称等属性。
import javax.servlet.Filter;
import javax.servlet.annotation.WebFilter;
@WebFilter(filterName = "CharacterEncodingFilter", urlPatterns = "/*")
public class CharacterEncodingFilter implements Filter {
// 过滤器类的实现代码
}
上述代码中,@WebFilter
注解将CharacterEncodingFilter
过滤器映射到所有的URL路径(/*
)上,即对该Web应用中的所有请求都进行过滤。
- web.xml配置方式:在
web.xml
文件中使用<filter>
和<filter-mapping>
标签来配置过滤器。
<web-app>
<!-- 过滤器定义 -->
<filter>
<filter-name>CharacterEncodingFilter</filter-name>
<filter-class>com.example.CharacterEncodingFilter</filter-class>
<!-- 过滤器初始化参数 -->
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<!-- 过滤器映射 -->
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
在上述配置中,<filter>
标签定义了过滤器的名称、类名以及初始化参数。<filter-mapping>
标签将过滤器名称与URL模式进行映射,这里同样是对所有路径进行过滤。
使用过滤器
- 当客户端发送请求到服务器时,请求会先进入过滤器链。如果请求的URL匹配过滤器的映射路径,那么对应的过滤器就会被执行。过滤器可以对请求进行预处理,如验证用户登录状态、检查请求参数等。如果请求通过了过滤器的验证,就会被传递给下一个过滤器或目标Servlet进行处理。在Servlet处理完请求生成响应后,响应会沿着过滤器链反向传递,过滤器可以对响应进行后处理,如修改响应头、压缩响应数据等。
假设在一个Web应用中有多个Servlet,当配置了上述字符编码过滤器后,所有访问该Web应用的请求和响应的字符编码都会被设置为UTF-8,确保了数据在传输过程中的正确处理,避免了乱码问题。