SpringMVC中提供的一些Filter

FormContentFilter

默认情况下，在提交那些具有请求体，并且ContentType=application/x-www-form-urlencoded的HTTP请求时，request.getParameter系列方法只能在请求方法为POST时正确获得请求体中的参数，也就是说对于PUT这类请求，它压根不解析请求体中的参数。

下面的Controller获取请求体中的param参数，并连同请求方法一同打印出来：

@RequestMapping(method = {RequestMethod.POST, RequestMethod.PUT}, path = "/hello")
public String hello(HttpServletRequest request) {
    System.out.println("method: " + request.getMethod() 
            + ", param: " + request.getParameter("param"));
    return "helloPage";
}

下面我们分别用POST和PUT请求它：

可以看到POST的接收到了参数，PUT的没接收到。

FormContentFilter返回请求对象的一个代理，让在非POST请求的情况下，getParameter系列方法也能正确的返回：

下面添加FormContentFilter：

public class AppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    // ... 

    @Override
    protected Filter[] getServletFilters() {
        return new Filter[] {new FormContentFilter()};
    }
}

现在，两个请求方法都能接收到参数：

ForwardedHeaderFilter

当你使用反向代理服务器时，你的后端代码可能需要获取到请求的原始URL。

比如，客户端通过反向代理服务器172.25.3.164来访问后端服务器：

你希望获取到客户端请求的原始URL，也就是http://172.25.3.164/hello，而后端服务器获取到的却是：

这是因为我们的服务端收到的实际是反向代理发过来的请求，已经不是客户端的原始请求了。

这可以用HTTP头中的X-Forwarded-Host和X-Forwarded-Port来识别。

ForwardedHeaderFilter的作用就是找出头中所有这些和反向代理服务器相关的Forward头，然后将对应的值设置到一个代理request对象中，并且把这些Forward头清除掉。下面我们配置ForwardedHeaderFilter：

@Override
protected Filter[] getServletFilters() {
    return new Filter[] {new ForwardedHeaderFilter()};
}

重新运行，服务端已经拿到了客户端的原始请求：

ForwardedHeaderFilter侦测的头列表：

FORWARDED_HEADER_NAMES.add("Forwarded");
FORWARDED_HEADER_NAMES.add("X-Forwarded-Host");
FORWARDED_HEADER_NAMES.add("X-Forwarded-Port");
FORWARDED_HEADER_NAMES.add("X-Forwarded-Proto");
FORWARDED_HEADER_NAMES.add("X-Forwarded-Prefix");
FORWARDED_HEADER_NAMES.add("X-Forwarded-Ssl");

ShallowEtagHeaderFilter

先说ETag的作用。

ETag是HTTP1.1中提供的头字段，服务器端针对一些不经常变动的并且较大的资源计算一个ETag值，并返回给前端。前端接收到内容后缓存内容和ETag。下次请求时，客户端在请求头中添加If-Match或If-None-Match字段，并将Etag作为字段的值。服务器端检测这个ETag并通过它计算用户请求的文件是否修改过，若没修改过直接返回304，客户端接到了就知道使用本地缓存就行，这免去了整个文件的传输。

配置ShallowEtagHeaderFilter：

@Override
protected Filter[] getServletFilters() {
    return new Filter[] {new ShallowEtagHeaderFilter()};
}

第一次访问，服务端返回200，并在头中返回etag：

第二次访问，客户端携带了If-None-Match头，并在头中添加了上次的Etag，同时服务端返回304：

CorsFilter

提供Cors支持，略