spring-cloud-commons 5.0.0¶

为什么要使用spring-cloud-commons¶

想象一下，你正带领一支探险队深入微服务的蛮荒之地。最初，自由令人兴奋——每个服务都可以选择自己的地图和指南针（技术栈）。但很快，混乱降临：服务之间迷失了方向，沟通时各说各话，整个系统变得脆弱而难以预测。你面临着一个根本性的矛盾：我们渴望微服务带来的自由与敏捷，却又无法承受因缺乏统一规则而陷入的混乱与运维地狱。

这就是 spring-cloud-commons 登场的时刻。它并非要剥夺你的自由，而是为你提供一套公认的“探险公约”和基础工具。它解决了那个核心痛点：如何在异构的微服务世界中，建立共通的抽象层，让服务发现、负载均衡、熔断降级等复杂模式变得像调用本地方法一样简单而一致。使用它，意味着你选择了在自由之上建立秩序，用一套优雅的抽象来对抗分布式系统固有的复杂性，从而让团队能将创造力聚焦于业务价值本身，而非重复编写和调试底层通信的轮子。简而言之，它让你在享受微服务架构红利的同时，不至于被其阴影所吞噬。

spring-cloud-commons是什么¶

spring-cloud-commons 是 Spring Cloud 生态系统的基石。它定义了一组公共抽象接口、约定和基础类，为所有 Spring Cloud 微服务模块（如服务发现、负载均衡、熔断器）提供了统一的编程模型。你可以把它理解为 Spring Cloud 世界的“宪法”和“标准库”，确保了不同具体实现（如 Netflix OSS, Consul, Nacos）在使用体验上的一致性。

入门示例¶

真实场景：假设你正在开发一个简单的电商应用，包含“用户服务”和“订单服务”。订单服务需要调用用户服务来获取用户信息。

开发示例：

1. 引入依赖：在两个服务的 pom.xml 中，引入 Spring Cloud 基础依赖，它会自动包含 spring-cloud-commons。

   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-dependencies</artifactId>
               <version>2023.0.0</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   
   <dependencies>
       <dependency>
           <groupId>org.springframework.cloud</groupId>
           <artifactId>spring-cloud-starter</artifactId>
       </dependency>
       <!-- 例如，使用 Spring Cloud LoadBalancer -->
       <dependency>
           <groupId>org.springframework.cloud</groupId>
           <artifactId>spring-cloud-starter-loadbalancer</artifactId>
       </dependency>
   </dependencies>
   

2. 启用服务间调用：在订单服务中，利用 spring-cloud-commons 提供的 @LoadBalanced 注解赋予 RestTemplate 负载均衡能力。

   @Configuration
   public class AppConfig {
       @Bean
       @LoadBalanced // 这是 spring-cloud-commons 核心注解之一
       public RestTemplate restTemplate() {
           return new RestTemplate();
       }
   }
   

3. 进行服务调用：在订单服务的业务代码中，你无需关心用户服务的具体地址和端口，直接使用其服务名称进行调用。负载均衡和服务发现的细节由 Spring Cloud 底层实现（基于 spring-cloud-commons 的抽象）自动处理。

   @Service
   public class OrderService {
       @Autowired
       private RestTemplate restTemplate;
   
       public Order getOrderWithUser(Long orderId, Long userId) {
           // 直接使用“用户服务”的应用名进行调用，而非具体的IP:PORT
           User user = restTemplate.getForObject(
               "http://user-service/users/{id}", // user-service 是服务名
               User.class,
               userId
           );
           // ... 处理订单和用户逻辑
           return order;
       }
   }
   

   通过这个例子，你看到 spring-cloud-commons 定义的抽象（如 @LoadBalanced）如何让复杂的分布式调用变得清晰简单。

spring-cloud-commons 5.0.0版本更新了什么¶

参考发布日志，Spring Cloud Commons 5.0.0 主要更新包括：1. 新增了 InstanceProperties 类，用于更结构化地定义服务实例属性。2. 启用了 JSpecify 注解支持，以增强代码的静态空安全（Null Safety）分析。3. 作为主要版本更新，它可能包含对先前版本不兼容的 API 调整和依赖库升级（如Spring Framework 6.x）。4. 进行了多项缺陷修复和内部依赖更新。

更新日志¶

⭐ 新特性¶

• 新增 InstanceProperties 类 (#1604)
• 启用 jspecify 支持 (#1603)

❤️ 贡献者¶

感谢所有为此版本做出贡献的贡献者。

总结¶

本次更新主要引入了用于管理服务实例配置的新属性类，并加强了对代码空安全性的静态检查支持。