SpringBoot 4.0 新特性整合项目实战应用详解

3.2.2 配置文件信息

在 application.yml 中配置基础服务信息：

server:
  port: 8080
spring:
  application:
    name: demo-service
management:
  endpoints:
    web:
      exposure:
        include: health,info

四、springboot 4.0 新特性项目实战

4.1 版本控制

4.1.1 基于请求 header 的版本号控制介绍

通过在请求 Header 中携带 X-API-Version 字段，控制器可根据版本号返回不同响应格式。

4.1.2 springboot4 版本控制案例演示

@RestController
@RequestMapping("/api")
public class VersionController {

    @GetMapping("/data")
    public String getData(@RequestHeader(value = "X-API-Version", required = false) String version) {
        if ("v2".equals(version)) {
            return "{\"status\": \"success\", \"data\": {}}";
        }
        return "{\"code\": 200, \"msg\": \"ok\"}";
    }
}

4.1.3 基于请求 url 路径参数的版本号控制介绍

利用 URL 路径中的版本标识，如 /api/v1/data 与 /api/v2/data。

4.1.4 基于请求参数的版本号控制介绍

支持通过查询参数 ?version=v1 进行版本区分。

4.2 容错和重试

4.2.1 @Retryable 说明

使用 @Retryable 注解自动处理调用失败的场景，支持指定异常类型和重试次数。

4.2.2 @Retryable 代码实现

@Service
public class OrderService {

    @Retryable(maxAttempts = 3, value = {Exception.class})
    public void createOrder() {
        // 业务逻辑
    }
}

4.2.3 @Retryable 其他注解补充

配合 @Recover 实现降级处理，当重试耗尽后执行兜底逻辑。

4.2.4 @ConcurrencyLimit 并发控制

限制特定方法的并发执行数量，防止系统过载。

4.3 bean 的动态注册

4.3.1 增加两个自定义的类

定义需要动态注册的 Service 接口及其实现类。

4.3.2 增加自定义 bean 的注册管理配置类

使用 BeanDefinitionRegistryPostProcessor 或 ImportSelector 实现动态扫描与注册。

4.3.3 通过@Import 配置类导入

在启动类中使用 @Import 引入配置类。

4.3.4 效果验证

启动应用后，检查上下文是否包含新增 Bean。

4.4 JsonView 使用

4.4.1 JsonView 介绍

用于控制 JSON 序列化时字段的可见性，避免敏感数据泄露。

4.4.2 JsonView 代码整合

@JsonView(UserView.class)
public class User {
    private String id;
    private String password; // 不在 View 中显示
}

4.5 SpringBoot Admin 使用

4.5.1 SpringBoot Admin 介绍

一款基于 Spring Boot 的监控和管理工具，提供可视化界面。

4.5.2 创建一个监控应用（服务端）

新建一个独立项目，添加 spring-boot-admin-server 依赖。

4.5.3 启动类添加注解（服务端）

@SpringBootApplication
@EnableAdminServer
public class AdminApplication {
    public static void main(String[] args) {
        SpringApplication.run(AdminApplication.class, args);
    }
}

4.5.4 启动服务（服务端）

运行服务端程序，默认端口通常为 8080。

4.5.5 增加核心的依赖（客户端）

被监控服务需添加 spring-boot-admin-starter-client 依赖。

4.5.6 调整配置文件（客户端）

配置 spring.admin.url 指向服务端地址。

4.5.7 效果验证

在服务端页面查看客户端状态及指标。

五、写在文末

本文详细介绍了 Spring Boot 4.0 的核心新特性及其在项目中的实战应用。通过版本控制、容错机制、动态 Bean 注册及可观测性增强等功能，开发者可以更高效地构建稳定、可扩展的微服务架构。建议在实际项目中根据需求逐步引入相关特性，并进行充分测试。