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);
    }
}