Spring mvc 内置编码过滤器原理解析

在Spring mvc框架中是如何解决从页面传来的字符串的编码问题的呢？

下面我们来看看Spring框架给我们提供过滤器CharacterEncodingFilter。

web.xml 中添加如下配置：

<filter>  
    <filter-name>characterEncodingFilter</filter-name>  
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>  
    <!-- 字符编码 -->
    <init-param>  
        <param-name>encoding</param-name>  
        <param-value>UTF-8</param-value>  
    </init-param>  
    <!-- 是否强制所有请求都使用该字符编码 -->
    <init-param>  
        <param-name>forceEncoding</param-name>  
        <param-value>true</param-value>  
    </init-param>  
</filter>  
<filter-mapping>  
    <filter-name>characterEncodingFilter</filter-name>  
    <url-pattern>/*</url-pattern>  
</filter-mapping>

spring mvc 内部提供了CharacterEncodingFilter过滤器，该过滤器有两个参数encoding和forceEncoding。

encoding
设置请求响应的字符编码。（请求的数据使用encoding编码解析，使用encoding编码进行响应的数据）
forceEncoding
forceEncoding=true 强制所有的请求响应都使用encoding编码。
forceEncoding=false 如果请求头中包含charset，则使用chartset编码，否则使用encoding编码。

CharacterEncodingFilter 源码分析

public class CharacterEncodingFilter extends OncePerRequestFilter {

    private String encoding;
    private boolean forceRequestEncoding = false;
    private boolean forceResponseEncoding = false;

    public void setEncoding(String encoding) {
        this.encoding = encoding;
    }

    public void setForceEncoding(boolean forceEncoding) {
        this.forceRequestEncoding = forceEncoding;
        this.forceResponseEncoding = forceEncoding;
    }

    @Override
    protected void doFilterInternal(
            HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
            throws ServletException, IOException {

        String encoding = getEncoding();
        if (encoding != null) {
            if (isForceRequestEncoding() || request.getCharacterEncoding() == null) {
                request.setCharacterEncoding(encoding);
            }
            if (isForceResponseEncoding()) {
                response.setCharacterEncoding(encoding);
            }
        }
        filterChain.doFilter(request, response);
    }
    ......
}

CharacterEncodingFilter 中包含三个属性 encoding、forceRequestEncoding、forceResponseEncoding。

encoding：字符编码类型
forceRequestEncoding：request 是否强制使用encoding编码
forceResponseEncoding：response 是否强制使用encoding编码

只要过滤器中配置了forceEncoding 属性，则forceRequestEncoding和forceResponseEncoding 则保持一致，都使用forceEncoding的值。

doFilterInternal() 方法

该方法是过滤器的核心方法。

如果forceRequestEncoding=true，和forceResponseEncoding=true，则request和response都是用配置的encoding。
如果forceRequestEncoding=false，则判断request.getCharacterEncoding()是否有值，如果有值则使用客户端传过来的编码（例如：charset=utf-8）