过滤器Filter 编码过滤器

### 编码过滤器 Filter 的实现与使用

#### 配置自定义编码过滤器

为了确保Web应用程序能够正确处理不同类型的字符集，在`web.xml`文件中可以配置一个名为 `encoding` 的过滤器。此过滤器用于设置请求和响应的字符编码方式，从而防止可能出现的中文乱码等问题。

<filter>
    <filter-name>encoding</filter-name>
    <filter-class>com.oyy.filter.GenericEncodingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>encoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

这段XML片段展示了如何创建并映射一个通用的编码过滤器到所有的URL模式上[^1]。

对于特定路径下的请求也可以单独指定过滤器：

<filter>
    <filter-name>CharactorEncodingFilter</filter-name>
    <filter-class>com.chen.filter.CharactorEncodingFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>CharactorEncodingFilter</filter-name>
    <url-pattern>/servlet/*</url-pattern>
</filter-mapping>

这里指定了只有当访问 `/servlet/` 下面的内容时才会触发该过滤器的工作[^2]。

#### Spring Boot 中的编码过滤器

在Spring Boot项目里，虽然仍然可以在传统的`web.xml`中声明过滤器，但是推荐采用更加简洁的方式——通过Java配置类来完成同样的功能。这种方式不仅减少了对外部资源文件的依赖，还使得整个项目的结构更为清晰明了。

如果希望在整个应用范围内统一设定字符编码，则可以直接利用内置的支持特性而无需手动编写额外代码；而对于某些特殊场景下需要定制化的逻辑，则可通过继承`OncePerRequestFilter`抽象类来自行扩展具体的业务行为[^3]。

import org.springframework.stereotype.Component;
import javax.servlet.FilterChain;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component
public class CustomCharacterEncodingFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
                                    FilterChain chain) throws ServletException, IOException {
        request.setCharacterEncoding("UTF-8");
        response.setContentType("text/html;charset=UTF-8");
        chain.doFilter(request,response);
    }
}

上述代码展示了一个简单的例子，它实现了对传入HTTP请求以及传出HTTP响应对象进行字符编码格式化的过程。