SpringBoot2.x - 基于注解实现拦截器

### Spring Boot 2.x 和 Spring Boot 3.x 中 HttpServletResponse 的主要区别及变化 Spring Boot 3.x 是基于 Jakarta EE 平台构建的，而之前的 Spring Boot 2.x 则依赖于 Java EE。这一迁移带来了许多重要的变更，其中包括 `HttpServletResponse` 接口的变化。 #### 1. **包命名空间的更改** 在 Spring Boot 3.x 中，由于迁移到了 Jakarta EE，`javax.servlet.http.HttpServletResponse` 被替换为 `jakarta.servlet.http.HttpServletResponse`。这意味着开发者需要更新所有的导入语句以及相关的类定义[^3]。 ```java // Spring Boot 2.x import javax.servlet.http.HttpServletResponse; // Spring Boot 3.x import jakarta.servlet.http.HttpServletResponse; ``` #### 2. **Bean 注入方式的变化** 在 Spring Boot 2.x 中，可以通过 `@Autowired` 自动装配的方式将 `HttpServletResponse` 注入到控制器或其他组件中。然而，在 Spring Boot 3.x 中，推荐的做法是通过构造函数显式注入来增强可测试性和明确性。 ```java // Spring Boot 2.x 使用 @Autowired 注解 @RestController public class MyController { private final HttpServletResponse response; public MyController(@Autowired HttpServletResponse response) { this.response = response; } } // Spring Boot 3.x 构造器注入 @RestController public class MyController { private final HttpServletResponse response; public MyController(HttpServletResponse response) { this.response = response; } } ``` #### 3. **路径匹配机制的变化** 虽然这主要是针对请求路径的解析逻辑，但它也间接影响了如何设置响应头或状态码的行为。在 Spring Boot 3.x 中，默认情况下使用的是 `PathPatternParser` 来替代旧版中的 `AntPathMatcher`。这种改变可能会影响某些自定义拦截器或过滤器的功能实现。 #### 4. **流操作行为的一致性问题** 当涉及到 HTTP 请求体 (`HttpServletRequest`) 或者响应体的操作时，需要注意输入/输出流不可重复读取的问题。如果尝试多次访问同一个流，则可能会引发异常。此现象同样适用于 `HttpServletResponse` 输出流的情况[^4]。 例如： ```java response.getOutputStream().write("Hello".getBytes()); // 如果后续再调用 getOutputStream() 可能会出现 IllegalStateException ``` 为了避免此类错误发生，建议合理规划数据写入流程并确保每次只打开一次流连接即可完成全部任务需求。 --- ### 总结 综上所述，从 Spring Boot 2.x 升级至 3.x 版本过程中关于 `HttpServletResponse` 主要存在以下几个方面的调整： - 需要更换为新的Jakarta Servlet API； - 改进了依赖注入模式以提高灵活性与清晰度； - 更新默认路径匹配算法从而优化性能表现； 最后提醒大家注意处理好各种类型的IO资源管理以免造成不必要的麻烦！