springboot中过滤器配置使用

文章目录

前置介绍

你使用

  • java
  • springboot

过滤器 filter 用在请求到达 controller 之前或者响应返回给用户之前

往往可以用 filter 来做请求的修改,日志、权限、跨域等场景,例如:设置编码和字符集,请求头,状态码等

过滤器是在请求进入容器后,但请求进入 servlet 之前进行预处理的,请求结束返回也是,是在 servlet 处理完后,返回给前端之前

拦截器可以获取 IOC 容器中的各个 bean,而过滤器就不行,在拦截器里注入一个 service,可以调用业务逻辑。而过滤器是 JavaEE 标准,只需依赖 servlet api ,不需要依赖 spring

Filter 是依赖于 Servlet 容器,属于 Servlet 规范的一部分,Filter 的生命周期由 Servlet 容器管理

filter 代码

doFilter 方法中做过滤的逻辑

java 复制代码
public class FirstFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化时执行的代码
        System.out.println("FirstFilter initialized");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 在请求到达 Controller 之前执行的
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        System.out.println("Request URL: " + httpRequest.getRequestURL());

        // 执行后续的过滤器或 Controller
        chain.doFilter(request, response);

        // 在响应返回客户端之前执行的代码
        System.out.println("Response processed");
    }

    @Override
    public void destroy() {
        // 销毁时执行的代码
        System.out.println("FirstFilter destroyed");
    }
}

注册 filter

下面两个方法都可以

方法一:@WebFilter注解(Servlet 3.0+)

如果你的项目支持 Servlet 3.0 及以上版本,可以直接在 Filter 类上使用 @WebFilter 注解

java 复制代码
@WebFilter(urlPatterns = "/api/*")
public class FirstFilter implements Filter {
	// ...
}

在 Spring Boot 启动类上添加 @ServletComponentScan,使 @WebFilter 生效

java 复制代码
@SpringBootApplication
@ServletComponentScan // 扫描@WebFilter注解

那怎么知道自己是不是 servlet 3.0 以及以上版本?

Spring Boot 的版本和嵌入的 Tomcat 版本决定了默认使用的 Servlet API 版本

  • Spring Boot 2.x 对应 Tomcat 9.x,支持 Servlet 4.0。
  • Spring Boot 3.x 对应 Tomcat 10.x,支持 Servlet 5.0(Jakarta EE)
    你还可以查找使用的 javax.servlet-api 依赖是哪个版本的

方法二:通过配置 configuration 和 bean 注册

java 复制代码
@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<FirstFilter> FirstFilter() {
        FilterRegistrationBean<FirstFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new FirstFilter());
        registrationBean.addUrlPatterns("/api/*"); // 指定过滤器的URL模式
        return registrationBean;
    }
}

疑问

过滤器的执行顺序?

如果你只使用 FilterRegistrationBean 显示注册 filter,则使用如下方法指定优先级

java 复制代码
registrationBean.setOrder(1);

如果你是多个 filter 使用 @WebFilter 注解,它们的执行顺序由类名的字母顺序决定(在 @WebFilter 注解中添加 @Order 注解(如 @Order(1))不会生效。因为 @Order 是 Spring 的注解,而 @WebFilter 是 Servlet 原生注解,Spring 不会自动将其顺序应用到 Servlet 容器中)

你可以结合 @WebFilter 和 FilterRegistrationBean 使用,即 FilterRegistrationBean 再覆盖顺序,需要使用其 setOrder

如果需要精确控制顺序,推荐完全使用 FilterRegistrationBean 注册过滤器(无需 @WebFilter)

相关推荐
wstcl3 分钟前
让你的asp.net网站在调试模式下也能在局域网通过ip访问
后端·tcp/ip·asp.net
倔强的小石头_2 小时前
【C语言指南】函数指针深度解析
java·c语言·算法
kangkang-6 小时前
PC端基于SpringBoot架构控制无人机(三):系统架构设计
java·架构·无人机
界面开发小八哥7 小时前
「Java EE开发指南」如何用MyEclipse创建一个WEB项目?(三)
java·ide·java-ee·myeclipse
ai小鬼头8 小时前
Ollama+OpenWeb最新版0.42+0.3.35一键安装教程,轻松搞定AI模型部署
后端·架构·github
idolyXyz8 小时前
[java: Cleaner]-一文述之
java
一碗谦谦粉8 小时前
Maven 依赖调解的两大原则
java·maven
萧曵 丶8 小时前
Rust 所有权系统:深入浅出指南
开发语言·后端·rust
netyeaxi8 小时前
Java:使用spring-boot + mybatis如何打印SQL日志?
java·spring·mybatis
收破烂的小熊猫~9 小时前
《Java修仙传:从凡胎到码帝》第四章:设计模式破万法
java·开发语言·设计模式