Spring Boot项目中如何定制拦截器

本文首发于我的网站：Spring Boot项目中如何定制拦截器

Servlet 过滤器属于Servlet API，和Spring关系不大。除了使用过滤器包装web请求，Spring MVC还提供HandlerInterceptor（拦截器）工具。根据文档，HandlerInterceptor的功能跟过滤器相似，但拦截器提供更精细的控制能力：在request被响应以前、request被响应以后、视图渲染以前以及request所有结束以后。咱们不能经过拦截器修改request内容，可是能够经过抛出异常（或者返回false）来暂停request的执行。

Spring MVC中经常使用的拦截器有：LocaleChangeInterceptor（用于国际化配置）和ThemeChangeInterceptor。咱们也能够增长本身定义的拦截器，能够参考这篇文章中提供的demo

实战

添加拦截器不只是在WebConfiguration中定义bean，Spring Boot提供了基础类WebMvcConfigurerAdapter，咱们项目中的WebConfiguration类须要继承这个类。

1. 继承WebMvcConfigurerAdapter；
2. 为LocaleChangeInterceptor添加@Bean定义，这仅仅是定义了一个interceptor spring bean，可是Spring boot不会自动将它加入到调用链中。
3. 拦截器须要手动加入调用链。

修改后完整的WebConfiguration代码以下：

package com.test.bookpub;

import org.apache.catalina.filters.RemoteIpFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;

@Configuration
public class WebConfiguration extends WebMvcConfigurerAdapter {
    @Bean    public RemoteIpFilter remoteIpFilter() {
        return new RemoteIpFilter();
    }

    @Bean    public LocaleChangeInterceptor localeChangeInterceptor() {
        return new LocaleChangeInterceptor();
    }
    @Override    public void addInterceptors(InterceptorRegistry registry {
        registry.addInterceptor(localeChangeInterceptor());
    }
}

使用mvn spring-boot:run运行程序，而后经过httpie访问http://localhost:8080/books?locale=foo，在终端看到以下错误信息。

Servlet.service() for servlet [dispatcherServlet] in context with path [] 
threw exception [Request processing failed; nested exception is 
java.lang.UnsupportedOperationException: Cannot change HTTP accept 
header - use a different locale resolution strategy] with root cause

PS：这里发生错误并非由于咱们输入的locale是错误的，而是由于默认的locale修改策略不容许来自浏览器的请求修改。发生这样的错误说明咱们以前定义的拦截器起做用了。

分析

在咱们的示例项目中，覆盖并重写了addInterceptors(InterceptorRegistory registory)方法，这是典型的回调函数——利用该函数的参数registry来添加自定义的拦截器。

在Spring Boot的自动配置阶段，Spring Boot会扫描全部WebMvcConfigurer的实例，并顺序调用其中的回调函数，这表示：若是咱们想对配置信息作逻辑上的隔离，能够在Spring Boot项目中定义多个WebMvcConfigurer的实例。

Spring Boot 1.x系列

1. Spring Boot的自动配置、Command-line-Runner
2. 了解Spring Boot的自动配置
3. Spring Boot的@PropertySource注解在整合Redis中的使用
4. Spring Boot项目中如何定制HTTP消息转换器
5. Spring Boot整合Mongodb提供Restful接口
6. Spring中bean的scope
7. Spring Boot项目中使用事件派发器模式
8. Spring Boot提供RESTful接口时的错误处理实践
9. Spring Boot实战之定制本身的starter
10. Spring Boot项目如何同时支持HTTP和HTTPS协议
11. 自定义的Spring Boot starter如何设置自动配置注解
12. Spring Boot项目中使用Mockito
13. 在Spring Boot项目中使用Spock测试框架

本号专一于后端技术、JVM问题排查和优化、Java面试题、我的成长和自我管理等主题，为读者提供一线开发者的工做和成长经验，期待你能在这里有所收获。