Spring Boot 4 中的 RestClient：同步通信现代化

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestClient;

@Configuration
public class RestClientConfiguration {

    @Bean
    public RestClient githubRestClient(RestClient.Builder builder) {
        // 为所有请求配置基础 URL 和默认头部
        return builder
            .baseUrl("https://api.github.com")
            .defaultHeader("Accept", "application/json")
            .build();
    }
}

// 假设 'githubRestClient' 已注入

public String getRepositoryInfo(String owner, String repo, boolean verbose) {
    String uriTemplate = "/repos/{owner}/{repo}";

    return githubRestClient.get()
        .uri(uriTemplate, owner, repo) // 映射 {owner} 和 {repo}
        .queryParam("verbose", verbose) // 添加 ?verbose=true 或 false
        .retrieve()
        .body(String.class);
}

import org.springframework.http.MediaType;

public User createNewUser(NewUserDTO userData) {
    return githubRestClient.post()
        .uri("/users")
        .contentType(MediaType.APPLICATION_JSON) // 设置 Content-Type
        .body(userData) // 将被序列化为 JSON 的对象
        .retrieve()
        .body(User.class); // 将响应反序列化为 User 对象
}

import org.springframework.http.HttpStatus;

public User safeGetUser(long id) {
    return githubRestClient.get()
        .uri("/users/{id}", id)
        .retrieve()
        .onStatus(HttpStatus.NOT_FOUND, (request, response) -> {
            // 404 的特定处理
            System.out.println("用户未找到，返回默认值");
            // 可以抛出异常或在这种情况下返回默认值
            throw new CustomResourceNotFoundException("用户 ID " + id + " 未找到");
        })
        .onStatus(HttpStatus::is5xxServerError, (request, response) -> {
            // 5xx（服务器错误）的处理
            throw new RuntimeException("内部服务错误。");
        })
        .body(User.class);
}

// 1. 客户端接口（契约定义）
import org.springframework.web.service.annotation.GetExchange;
import org.springframework.web.service.annotation.HttpExchange;

@HttpExchange(url = "https://api.external.com/api/v1") // 基础 URL
public interface ExternalApi {
    @GetExchange("/items/{itemId}") // 映射到 GET https://api.external.com/api/v1/items/{itemId}
    Item getItem(@PathVariable String itemId);
}

// 2. 在服务中的使用（Spring Boot 4.0 在配置 @ImportHttpServices 后自动注入代理）
@Service
public class ItemService {
    private final ExternalApi externalApi;

    // 生成的代理实现被注入
    public ItemService(ExternalApi externalApi) {
        this.externalApi = externalApi;
    }

    public Item findItem(String id) {
        // 感觉像调用本地方法
        return externalApi.getItem(id);
    }
}