springboot中定义拦截器的两种方式

本文介绍了在SpringBoot中定义拦截器的两种方法:配置文件方式和纯注解方式。针对配置文件方式,虽非SpringBoot推荐,但仍可参照SpringMVC的注入方式。对于纯注解方式,需通过@Configuration注解将拦截器注入到容器,并解决WebMvcConfigurerAdapter在新版本中的失效问题。同时,文章还提及了跨域问题及其解决方案,包括在拦截器中添加addCorsMappings和使用过滤器处理跨域以避免与拦截器冲突。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

SpringBoot定义拦截器

在springboot中定义一个拦截器的方式: 使自定义类实现HandlerInterceptor接口

public class MySelfInterceptor implements HandlerInterceptor {
	@Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    	System.out.println("在业务处理器处理请求之前被调用");
    	return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
		System.out.println("在业务处理器处理请求执行完成后,生成视图之前执行");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
		System.out.println("在DispatcherServlet完全处理完请求后被调用");
    }
} 
根据三种情况,可以在不同的方法针对请求进行额外的处理。
	在preHandle中,可以进行权限校验,安全控制。
	在postHandle中,可以对返回来的ModelAndView进行处理,这个时候还未渲染视图。
	在afterCompletion中,请求已经完成,页面已经渲染,数据已经返回。这个时候可以做一些资源清理,或者记录请求调用时间,做性能监控

在springboot中的IOC容器,所有定义的bean都应该注入到容器中,才可以被springboot调用。所以对于我们自定义的拦截器,要么通过配置文件的方式将其注入到容器中,要么通过注解的形式注入到容器中。下面来介绍这两种方式的写法。

配置文件方式

springboot推荐的是纯注解的形式,所以对于xml配置文件,仍然类似于SpringMVC的注入方式,只是springboot同样支持。

    <mvc:interceptors>
        <mvc:interceptor>
        	<!--path代表拦截哪些映射名-->
            <mvc:mapping path=" " />
            <!--class代表自定义拦截器类的位置-->
            <bean class=" "/>
        </mvc:interceptor>
    </mvc:interceptors>

纯注解方式

使用注解的方式,需要先将我们自定义的拦截器类,通过注解的方式注入到容器当中。

//一些类似的注解皆可以使该拦截器被注入到容器当中
@Component/@Slf4j/... 
public class MySelfInterceptor implements HandlerInterceptor {
	......
}

通过代码的配置方式 @Configuration,将自定义的拦截器,添加到springboot自带拦截器的路径中。

@Configuration
public class WebCofiguration extends WebMvcConfigurerAdapter {
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MySelfInterceptor ())
                .addPathPatterns("/**")
                .excludePathPatterns("/logout");
                //过滤器可以添加多个,这里的addPathPatterns的/**是对所有的请求都做拦截。
                //excludePathPatterns代表排除url的拦截路径,即不拦截
    }
}
WebMvcConfigurerAdapter 失效的问题

springBoot2.0以上 WebMvcConfigurerAdapter 方法过时,有两种替代方案:

	继承 WebMvcConfigurationSupport 类;(会让springmvc对静态资源的自动配置失效)
	实现 WebMvcConfigurer 接口;  (推荐用这个)
出现跨域问题

出现跨域问题,可以在这里继续添加addCorsMappings,以此来解决跨域问题

@Configuration
public class WebCofiguration extends WebMvcConfigurerAdapter {

    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MySelfInterceptor ())
                .addPathPatterns("/**");
    }

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedMethods("*")
                .allowedOrigins("*")
                .allowedHeaders("*");
    }

}

如果依然出现跨域问题,可能是拦截器和addCorsMappings冲突了,这个跟dispatch中对于跨域处理的执行顺序有关系,导致response头部未正确配置跨域信息。

所以可以在过滤器中添加跨域信息,因为过滤器先于拦截器执行,在进入dispatch前就可以完成配置。

### SpringMVC 拦截器SpringBoot 拦截器的实现方式与配置方法 #### 实现方式对比 在 **Spring MVC** 中,通常通过 XML 配置文件来设置拦截器。开发者可以在 `spring-mvc.xml` 文件中定义 `<mvc:interceptors>` 节点并指定要使用的拦截器类[^1]。 而在 **Spring Boot** 应用程序里,则更倾向于采用基于 Java 的配置方式。这不仅简化了项目的结构,还提高了代码的可读性和维护性。具体来说,在 Spring Boot 中创建自定义拦截器时,会编写一个实现了 `HandlerInterceptor` 或者继承 `WebMvcConfigurerAdapter`(对于较新版本推荐直接实现 `WebMvcConfigurer`)接口的组件,并在此基础上完成相应的逻辑编码[^2]。 #### 配置方法差异 为了使自定义拦截器能够被识别和调用,在传统的 **Spring MVC** 架构下,除了上述提到的 XML 方式外,还可以利用 `@Component` 注解配合 `@Order` 来控制执行顺序;而到了 **Spring Boot**, 则强调使用带有 `@Configuration` 注解的配置类来进行统一管理[^3]。这意味着所有的 Bean 定义以及额外的功能扩展都可以集中在一个地方处理,从而增强了模块间的耦合度控制能力。 下面是一个简单的例子展示如何在两种框架内分别添加全局级别的路径匹配规则: ##### Spring MVC (XML) ```xml <mvc:interceptors> <!-- 可选地应用到特定URL模式 --> <bean class="com.example.MyCustomInterceptor"/> </mvc:interceptors> ``` ##### Spring Boot (Java Config) ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new MyCustomInterceptor()) .addPathPatterns("/api/**"); // 对应于/api开头的所有请求路径 } } ``` 值得注意的是,尽管两者之间存在这些不同之处,但在实际开发过程中二者的核心概念保持一致——即都是围绕着 HTTP 请求生命周期中的预处理、后处理阶段展开工作的。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值