优雅处理HTTP请求：过滤器、拦截器、ControllerAdvice和自定义AOP |
您所在的位置：网站首页 › springboot拦截器 › 优雅处理HTTP请求：过滤器、拦截器、ControllerAdvice和自定义AOP |
优雅处理HTTP请求：过滤器、拦截器、ControllerAdvice和自定义AOP
|
我们在开发Spring Boot应用程序时，经常会遇到需要对HTTP请求进行一些处理的情况，例如鉴权、数据校验、请求日志记录等等。在处理HTTP请求时，我们可以使用四种不同的技术来实现这些功能：过滤器、拦截器、ControllerAdvice和自定义AOP。 在本文中，我们将分别介绍这四种技术的概念、用法和区别，并举例说明如何在Spring Boot应用程序中使用它们来实现对HTTP请求的统一处理。 基本概念及拦截执行顺序总的来说，四种拦截方式的执行顺序是过滤器->拦截器->ControllerAdvice->自定义AOP。 但是需要注意的是，这并不是绝对的顺序，具体的执行顺序还会受到过滤器链、拦截器链、AOP切入位置等因素的影响，例如 如果在过滤器或拦截器中调用了chain.doFilter(request, response)或handlerInterceptor.preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)方法，则会依次调用过滤器链和拦截器链的下一个过滤器或拦截器。 自定义AOP的执行顺序在ControllerAdvice之后，是因为一般情况下我们会将切入点选在Controller的方法上 四种拦截方法的使用case 过滤器在Spring Boot项目中，可以使用过滤器（Filter）来统一处理HTTP请求，并获取和解析请求头中的内容。过滤器可以在请求到达Servlet之前或之后进行一些处理操作。 以下例子展示如何在Spring Boot项目中实现一个过滤器来获取和解析请求头中的内容： 创建一个过滤器类，实现Filter接口。在该过滤器类中，可以重写doFilter方法，在该方法中获取并解析请求头信息。 public class MyFilter implements Filter { @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest httpRequest = (HttpServletRequest) request; // 获取请求头信息 String headerInfo = httpRequest.getHeader("Header-Info"); // 解析请求头信息 // ... chain.doFilter(request, response); // 继续执行请求处理 } // 可以重写init和destroy方法进行初始化和销毁操作 } 在Spring Boot应用程序中注册该过滤器类。可以通过创建一个配置类并继承WebMvcConfigurerAdapter类，然后重写addFilters方法来注册过滤器。 public class MyFilterConfig extends WebMvcConfigurerAdapter { @Bean public FilterRegistrationBean myFilter() { FilterRegistrationBean registrationBean = new FilterRegistrationBean(); registrationBean.setFilter(new MyFilter()); registrationBean.addUrlPatterns("/*"); // 指定过滤的URL return registrationBean; } }这样，当请求到达时，就会先进入过滤器的doFilter方法进行处理，并获取和解析请求头信息。过滤器可以处理任何类型的请求，而不仅仅是Web请求，因此需要在过滤器中进行类型判断。 拦截器在Spring Boot项目中，可以使用拦截器（Interceptor）来对HTTP请求进行统一转换和处理请求头信息。拦截器可以在请求处理前和处理后进行一些处理操作。 以下例子展示如何在Spring Boot项目中实现一个拦截器来获取和解析请求头中的信息： 创建一个拦截器类，实现HandlerInterceptor接口。在该拦截器类中，可以重写preHandle方法，在该方法中获取并解析请求头信息。 public class MyInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 获取请求头信息 String headerInfo = request.getHeader("Header-Info"); // 解析请求头信息 // ... return true; // 返回true继续执行请求处理，返回false则不执行请求处理 } // 可以重写 afterCompletion 和 postHandle 方法进行请求处理后的操作 }在Spring Boot应用程序中注册该拦截器类。可以通过创建一个配置类并继承WebMvcConfigurerAdapter类，然后重写addInterceptors方法来注册拦截器。 @Configuration public class MyInterceptorConfig extends WebMvcConfigurerAdapter { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new MyInterceptor()); } }这样，当请求到达时，就会先进入拦截器的preHandle方法进行处理，并获取和解析请求头信息。注意，拦截器只能处理@Controller注解或@RequestMapping注解的处理器方法，并且只对Web请求有效，对于非Web请求（如静态资源）不会进行拦截。 除preHandle（目标方法执行前执行）， HandlerInterceptor还有两外两个方法： postHandle 目标方法执行后执行 afterCompletion 请求完成时执行 ControllerAdvice @ControllerAdvice是Spring MVC提供的一个注解，用于定义一个全局的异常处理器、数据绑定器和模型处理器。它可以被用于处理所有的Controller中抛出的异常和响应，对于多个Controller中重复的异常处理可以进行统一管理。 @ControllerAdvice注解对于应用程序中所有的@Controller注解的类中的方法进行全局处理，可以捕获Controller中的异常并返回相应的响应信息，也可以在Controller中返回数据之前对数据进行统一处理。 @ControllerAdvice注解所标注的类中，可以定义多个方法，每个方法可以处理不同的异常或返回不同类型的数据。在方法上可以使用@ExceptionHandler、@InitBinder或@ModelAttribute注解来指定要处理的异常类型、数据绑定规则和模型处理规则。下面是一个@ControllerAdvice注解的示例： @ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(Exception.class) @ResponseBody public ResponseEntity handleException(Exception e) { return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage()); } }上面的代码定义了一个全局异常处理器，用于处理所有Controller中抛出的Exception异常，如果出现异常则返回一个HTTP 500错误响应，并将异常信息作为响应体返回。 另外，@ControllerAdvice注解中还可以添加basePackages属性或value属性来指定需要处理的Controller所在的包路径或类。例如： @ControllerAdvice(basePackages = "com.example.controller") public class GlobalExceptionHandler { // ... }这样就只会处理com.example.controller包下的Controller中抛出的异常。 总之，@ControllerAdvice是一个很有用的注解，可以让我们在应用程序中统一处理异常和响应，避免重复的代码，提高代码的可维护性和可读性。 自定义AOP在Spring Boot项目中，可以使用自定义AOP的方式来统一处理HTTP请求，并获取和解析请求头中的内容。通过自定义AOP切面，可以在请求处理前和处理后添加相应的切面逻辑。 以下例子展示如何在Spring Boot项目中实现自定义AOP切面来获取和解析请求头中的内容： 创建一个注解，用于标注需要进行切面处理的方法。在该注解中添加一个String类型的属性，用于指定需要获取的请求头信息。 @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public @interface MyAnnotation { String value(); }创建一个切面类，实现Aspect接口，并在该类中定义一个切点方法和一个通知方法。在切点方法中，使用@Pointcut注解来指定需要进行切面处理的方法；在通知方法中，通过JoinPoint参数获取请求对象，并从请求对象中获取并解析请求头信息。 @Aspect @Component public class MyAspect { @Pointcut("@annotation(com.example.demo.MyAnnotation)") public void myPointcut() {} @Around("myPointcut()") public Object myAdvice(ProceedingJoinPoint joinPoint) throws Throwable { // 获取请求对象 ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes(); HttpServletRequest request = attributes.getRequest(); // 获取注解中指定的请求头信息 MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature(); MyAnnotation annotation = methodSignature.getMethod().getAnnotation(MyAnnotation.class); String headerInfo = request.getHeader(annotation.value()); // 解析请求头信息 // ... // 继续执行请求处理 Object result = joinPoint.proceed(); // 处理请求处理结果 // ... return result; } }在需要进行切面处理的方法上添加自定义注解，并指定需要获取的请求头信息。 @RestController public class MyController { @MyAnnotation("Header-Info") @GetMapping("/hello") public String hello() { return "Hello World!"; } }这样，在请求到达需要进行切面处理的方法时，就会先进入自定义AOP切面的通知方法进行处理，并获取和解析请求头信息。注意，自定义AOP切面可以处理任何类型的方法，而不仅仅是@Controller注解或@RequestMapping注解的处理器方法，它也可以处理非Web请求（如异步方法或定时任务等）。 |
【本文地址】
今日新闻 |
推荐新闻 |