java怎么创建过滤器

3 程序化动态注册（Programmatic Registration）

适用于需要在运行时调整过滤策略的场景。

实现步骤：

1. 创建ServletContextListener监听器
2. 在contextInitialized事件中注册过滤器

   public class DynamicFilterRegistrar implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent event) {
        ServletContext ctx = event.getServletContext();
        DynamicFilter dynamicFilter = new DynamicFilter();
        ctx.addFilter("dynamicPath", dynamicFilter)
           .addMappingForUrlPatterns(true, true, "/api/v1/");
    }
   }

   💡 适用场景：插件系统、A/B测试环境切换、灰度发布控制。

实战案例解析

1 字符编码统一处理器

解决中文乱码问题的通用方案：

public class CharsetFilter implements Filter {
    private static final String ENCODING = "UTF-8";
    @Override
    public void doFilter(HttpServletRequest req, HttpServletResponse resp, FilterChain chain) 
            throws IOException, ServletException {
        // 强制设置请求/响应编码
        req.setCharacterEncoding(ENCODING);
        resp.setCharacterEncoding(ENCODING);
        resp.setContentType("text/html;charset=" + ENCODING);
        chain.doFilter(req, resp);
    }
}

📌 关键点：必须在其他过滤器之前执行，且优先于业务逻辑处理。

2 JWT鉴权过滤器

集成Spring Security的典型应用：

@Component
public class JwtAuthenticationFilter extends OncePerRequestFilter {
    @Autowired
    private JwtTokenProvider tokenProvider;
    @Override
    protected void doFilterInternal(HttpServletRequest request, 
                                  HttpServletResponse response, 
                                  FilterChain filterChain) throws ServletException, IOException {
        String token = resolveToken(request);
        try {
            if (token != null && tokenProvider.validateToken(token)) {
                UserDetails userDetails = tokenProvider.getUserDetails(token);
                UsernamePasswordAuthenticationToken authentication = 
                    new UsernamePasswordAuthenticationToken(userDetails, null, userDetails.getAuthorities());
                SecurityContextHolder.getContext().setAuthentication(authentication);
            }
        } catch (ExpiredJwtException ex) {
            throw new UnauthorizedAccessException("Token expired");
        }
        filterChain.doFilter(request, response);
    }
    private String resolveToken(HttpServletRequest request) {
        // 从Header/Cookie/Param中提取Token的逻辑
    }
}

🔗 关联技术：OAuth2.0、RBAC权限模型、微服务网关。

性能优化策略

常见误区与解决方案

1 误区："我的过滤器不生效"

🔍 根本原因：

• 未正确配置<url-pattern>导致路径不匹配
• 过滤器顺序错误（安全相关过滤器应放在最前面）
• 忘记调用chain.doFilter()

✅ 排查步骤：

1. 检查web.xml中的<filter-mapping>顺序
2. 确认URL模式是否覆盖目标路径
3. 添加调试日志验证执行流程

2 误区："修改后的响应头丢失"

🔍 深层原因：

• 某些容器（如Tomcat）默认启用Cache-Control头压缩
• 响应已被提交到客户端后才尝试修改

✅ 解决方案：

• 在doFilter开头立即设置所需头信息
• 禁用响应缓存：response.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
• 使用HttpServletResponseWrapper包装响应对象

相关问答FAQs

Q1: 为什么我的过滤器修改了响应内容但没有效果？

A: 可能存在以下原因：① 修改发生在响应已提交之后（应在chain.doFilter()之前完成修改）；② 缺少contentType设置导致浏览器未按预期解析；③ 使用了压缩过滤器（Gzip/Deflate），此时需要特殊处理压缩流，建议使用HttpServletResponseWrapper封装响应对象，并在doFilter方法最开始就进行必要修改。

Q2: 如何让过滤器只作用于特定Dispatcher Type？

A: 在web.xml的<filter-mapping>中添加<dispatcher-types>元素，可选值包括：

• REQUEST: 直接请求（默认）
• FORWARD: forward请求
• INCLUDE: include请求
• ERROR: 错误跳转请求
• ASYNC: 异步请求

示例配置：

<filter-mapping>
    <filter-name>MyFilter</filter-name>
    <url-pattern>/secure/</url-pattern>
    <dispatcher-types>REQUEST,FORWARD,INCLUDE</dispatcher-types>
</filter-mapping