// 1. 聲明接口：像定義Controller一樣定義要調(diào)用的遠(yuǎn)程服務(wù)
@HttpExchange(url = "/api/v1", accept = "application/json", contentType = "application/json")
public interface UserServiceClient {
    @GetExchange("/users/{id}")
    User getUserById(@PathVariable Long id);
    
    @PostExchange("/users")
    User createUser(@RequestBody User user);
}

// 2. 配置Bean：通過工廠創(chuàng)建代理實(shí)例
@Configuration
class ClientConfig {
    @Bean
    UserServiceClient userServiceClient(WebClient.Builder builder) {
        WebClient webClient = builder.baseUrl("http://user-service-host").build();
        return HttpServiceProxyFactory.builder(WebClientAdapter.forClient(webClient))
                                      .build()
                                      .createClient(UserServiceClient.class);
    }
}

// 3. 直接使用：像注入普通Bean一樣注入并使用
@Service
public class OrderService {
    @Autowired
    private UserServiceClient userServiceClient; // 注入聲明的客戶端
    
    public Order getOrderWithUser(Long orderId, Long userId) {
        User user = userServiceClient.getUserById(userId); // 直接調(diào)用，如同本地方法
        // ... 處理訂單邏輯
        return order;
    }
}

// 當(dāng)拋出異常時，Spring Boot 3.0 默認(rèn)可以生成如下結(jié)構(gòu)的JSON響應(yīng)
// 傳統(tǒng)的自定義錯誤格式：{"message": "用戶不存在", "error": "Not Found"}
// 新的標(biāo)準(zhǔn)Problem Detail格式：
{
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "detail": "用戶ID為123的用戶不存在",
    "instance": "/users/123"
}

// 使用記錄類 (Records) 作為DTO或值對象：自動生成構(gòu)造器、getter、equals、hashCode和toString
public record UserDTO(Long id, String name, String email) {} // 一行頂過去幾十行

// 使用密封類 (Sealed Classes) 精確控制繼承層次，增強(qiáng)領(lǐng)域模型安全性
public sealed interface PaymentResult permits PaymentSuccess, PaymentFailed {
    // 只允許這兩個類實(shí)現(xiàn)此接口
}
public record PaymentSuccess(String transactionId) implements PaymentResult {}
public record PaymentFailed(String errorCode) implements PaymentResult {}

<!-- 在pom.xml中，使用Spring Boot插件即可輕松構(gòu)建原生鏡像 -->
<plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
</plugin>

# 使用Maven命令編譯成本地可執(zhí)行文件
mvn -Pnative native:compile
# 編譯后生成一個獨(dú)立的二進(jìn)制文件（如`myapp`），可以直接運(yùn)行
./target/myapp

@RestController
@RequestMapping("/api/user")
public class UserController {
    @GetMapping(version = "1")
    public UserV1 getUserV1() {
        // 返回舊版數(shù)據(jù)模型
        return new UserV1("張三");
    }
    @GetMapping(version = "2")
    public UserV2 getUserV2() {
        // 返回新版數(shù)據(jù)模型，包含更多字段
        return new UserV2("張三", "zhangsan@example.com");
    }
}

# application.yml
spring:
  threads:
    virtual:
      enabled: true  # 全局啟用虛擬線程支持

import org.springframework.beans.factory.BeanRegistrar;
import org.springframework.beans.factory.BeanRegistry;
import org.springframework.core.env.Environment;

public class MyModuleRegistrar implements BeanRegistrar {
    @Override
    public void register(BeanRegistry registry, Environment environment) {
        // 批量注冊一批相關(guān)的Bean
        registry.registerBean("serviceA", MyServiceA.class);
        registry.registerBean("serviceB", MyServiceB.class);
        // 根據(jù)環(huán)境屬性動態(tài)注冊Bean
        if (environment.matchesProfiles("cluster")) {
            registry.registerBean("clusterService", ClusterService.class);
        }
    }
}

// 1. 聲明接口
public interface UserServiceClient {
    @GetExchange("/users/{id}")
    User getUserById(@PathVariable Long id);
}
// 2. 創(chuàng)建代理并注入
@Service
public class OrderService {
    private final UserServiceClient userServiceClient;
    public OrderService(UserServiceClient userServiceClient) {
        this.userServiceClient = userServiceClient; // 像使用本地Bean一樣調(diào)用
    }
}

import org.jspecify.annotations.NonNull;
import org.jspecify.annotations.Nullable;

public class UserService {
    // 參數(shù)name明確標(biāo)記為可空，返回值明確標(biāo)記為非空
    public @NonNull User createUser(@Nullable String name) {
        return new User(name != null ? name : "Guest");
    }
}