Spring统一功能处理：拦截器、响应与异常的统一管理

一.拦截器

二.统一数据返回格式

三.统一异常处理

一.拦截器

拦截器是Spring框架提供的核⼼功能之⼀，主要⽤来拦截⽤⼾的请求，在指定⽅法前后，根据业务需要执⾏预先设定的代码。

也就是说，允许开发⼈员提前预定义⼀些逻辑，在⽤⼾的请求响应前后执⾏，也可以在⽤⼾请求前阻⽌其执⾏。

在拦截器当中，开发⼈员可以在应⽤程序中做⼀些通⽤性的操作，⽐如通过拦截器来拦截前端发来的请求，判断Session中是否有登录⽤⼾的信息，如果有就可以放⾏，如果没有就进⾏拦截。

添加拦截器后，在原先逻辑之前会先判断是否拦截

使用拦截器需要分为俩步骤：

自定义拦截器
配置拦截器

⾃定义拦截器：需实现HandlerInterceptor接⼝，并重写其⽅法

public interface HandlerInterceptor {//⽬标⽅法执⾏前执⾏，返回值表示是否拦截default boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {return true;}//⽬标⽅法执⾏后执⾏default void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView) throws Exception {}//视图渲染完毕后执⾏default void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex) throws Exception {}
}

preHandle()⽅法：⽬标⽅法执⾏前执⾏，返回true：继续执⾏后续操作；返回false：中断后续操作.
postHandle()⽅法：⽬标⽅法执⾏后执⾏
afterCompletion()⽅法：视图渲染完毕后执⾏，最后执⾏(但是现在基于前后端分离的设计模式，一般不需要后端返回视图，故而很少用)

添加拦截器后，执⾏Controller的⽅法之前，请求会先被拦截器拦截住执⾏ preHandle() ⽅法，这个⽅法需要返回⼀个布尔类型的值：如果返回true，就表⽰放⾏本次操作并且继续访问controller中的⽅法；如果返回false，则不会放⾏(controller中的⽅法也不会执⾏)。controller当中的⽅法执⾏完毕后，再回过来执⾏ postHandle() 这个⽅法以及afterCompletion() ⽅法，执⾏完毕之后，最终给浏览器响应数据。

@Slf4j
@Component
public class LoginInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {log.info("LoginInterceptor ⽬标⽅法执⾏前执⾏..");return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {log.info("LoginInterceptor ⽬标⽅法执⾏后执⾏");}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {log.info("LoginInterceptor 视图渲染完毕后执⾏，最后执⾏");}
}

自定义完成拦截器后，我们还需要将其使用起来，也就是进行相关配置

首先是要实现WebMvcConfigurer接口，为了将我们刚才自定义的拦截器进行注册，我们需要一个拦截器对象，通过依赖注入的方式注入其中。InterceptorRegistry表示拦截器注册类，我们通过该类的addInterceptor方法将注入的拦截器对象提交并且注册，通过addPathPatterns方法配置我们需要拦截的路径

@Configuration
public class WebConfig implements WebMvcConfigurer {//⾃定义的拦截器对象@Autowiredprivate LoginInterceptor loginInterceptor;public void addInterceptors(InterceptorRegistry registry) {//注册⾃定义拦截器对象registry.addInterceptor(loginInterceptor).addPathPatterns("/**");//设置拦截器拦截的请求路径（ /** 表⽰拦截所有请求）}
}

我们在注册配置拦截器的时候，通过 addPathPatterns() ⽅法指定要拦截哪些请求，也可以通过excludePathPatterns() 指定不拦截哪些请求。

@Configuration
public class WebConfig implements WebMvcConfigurer {//⾃定义的拦截器对象@Autowiredprivate LoginInterceptor loginInterceptor;public void addInterceptors(InterceptorRegistry registry) {//注册自定义拦截器对象registry.addInterceptor(loginInterceptor).addPathPatterns("/**").excludePathPatterns("/user/login");}
}

对于拦截路径，有以下需要注意

拦截路径	含义	举例
/*	一级路径	能匹配/user，/book，/login，不能匹配 /user/login
/**	任意级路径	能匹配/user，/book，/login，/user/login

对于一些比较复杂比较多的路径，可以将其封装到一个集合中再统一导入，即下面俩者的效果是一样的。

@Configuration
public class WebConfig implements WebMvcConfigurer {//⾃定义的拦截器对象@Autowiredprivate LoginInterceptor loginInterceptor;@Overridepublic void addInterceptors(InterceptorRegistry registry) {//注册⾃定义拦截器对象registry.addInterceptor(loginInterceptor).addPathPatterns("/**").excludePathPatterns("/user/login").excludePathPatterns("/**/*.js") .excludePathPatterns("/**/*.css").excludePathPatterns("/**/*.png").excludePathPatterns("/**/*.html");}
}

@Configuration
public class WebConfig implements WebMvcConfigurer {//⾃定义的拦截器对象@Autowiredprivate LoginInterceptor loginInterceptor;private List<String> excludePaths = Arrays.asList("/user/login","/**/*.js","/**/*.css","/**/*.png","/**/*.html");@Overridepublic void addInterceptors(InterceptorRegistry registry) {//注册⾃定义拦截器对象registry.addInterceptor(loginInterceptor).addPathPatterns("/**").excludePathPatterns(excludePaths);}
}

二.统一数据返回格式

统⼀的数据返回格式使⽤ @ControllerAdvice 和 ResponseBodyAdvice 的⽅式实现，@ControllerAdvice 表⽰控制器通知类

添加类 ResponseAdvice，实现 ResponseBodyAdvice 接⼝，并在类上添加@ControllerAdvice 注解，示例如下：

@ControllerAdvice
public class ResponseAdvice implements ResponseBodyAdvice {@Overridepublic boolean supports(MethodParameter returnType, Class converterType) {return false;}@Overridepublic Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {return null;}
}

supports⽅法：判断是否要执⾏beforeBodyWrite⽅法，true为执⾏，false不执⾏。通过该⽅法可以选择哪些类或哪些⽅法的response要进⾏处理，其他的不进⾏处理。

beforeBodyWrite⽅法：对response⽅法进⾏具体操作处理。

三.统一异常处理

统⼀异常处理使⽤的是 @ControllerAdvice + @ExceptionHandler 来实现的，@ControllerAdvice 表⽰控制器通知类，@ExceptionHandler 是异常处理器，两个结合表⽰当出现异常的时候执⾏某个通知，也就是执⾏某个⽅法事件。

示例代码如下：

@ControllerAdvice
public class ErrorAdvice {@ExceptionHandlerpublic Object handler(Exception e) {return Result.fail(e.getMessage());}
}

以上代码表⽰，如果代码出现Exception异常(包括Exception的⼦类)，就返回⼀个 Result的对象。

我们可以针对不同的异常，返回不同的结果。

@ControllerAdvice
public class ErrorAdvice {@ExceptionHandlerpublic Object handler(Exception e) {return Result.fail(e.getMessage());}@ExceptionHandlerpublic Object handler(NullPointerException e) {return Result.fail("发⽣NullPointerException:"+e.getMessage());}@ExceptionHandlerpublic Object handler(ArithmeticException e) {return Result.fail("发⽣ArithmeticException:"+e.getMessage());}
}

当有多个异常通知时，匹配顺序为当前类及其⼦类向上依次匹配。

本次的分享就到此为止了，希望我的分享能给您带来帮助，创作不易也欢迎大家三连支持，你们的点赞就是博主更新最大的动力！如有不同意见，欢迎评论区积极讨论交流，让我们一起学习进步！有相关问题也可以私信博主，评论区和私信都会认真查看的，我们下次再见