2. 시작하기¶

의존성¶

// build.gradle.kts
dependencies {
    implementation(project(":zlink-http-client"))
}

import systems.zlink.httpclient.ZLinkHttpClient;

첫 요청¶

try (ZLinkHttpClient client = ZLinkHttpClient.create("http://127.0.0.1:18080").build()) {
    HttpResponse<PlayerProfile> player =
        client.get("/players/7281").submit(PlayerProfile.class).toCompletableFuture().join();
    System.out.println(player.body().name());
}

create(baseUrl)로 builder를 시작하고 .build()로 client를 만든다.
client는 재사용 가능하고 thread-safe하다. AutoCloseable이므로 try-with-resources로 수명을 관리하면 내부 HttpClient/executor가 정리된다.

한 줄 요청¶

단발 요청은 build()를 생략하고 builder에서 바로 메서드를 호출할 수 있다.

HttpResponse<CreateGameRes> res = ZLinkHttpClient.create("https://game-api.example.internal")
    .post("/games")
    .body(new CreateGameReq("ranked-match-0611"))
    .submit(CreateGameRes.class)
    .toCompletableFuture().join();

blocking 한 줄(테스트/CLI)¶

Leaderboard board = ZLinkHttpClient.create("http://127.0.0.1:18080")
    .get("/leaderboard").fetch(Leaderboard.class);

fetch(Type)는 결과를 기다려 typed body를 돌려주고 실패를 예외로 던진다. handler 스레드에서는 쓰지 않는다(7장).

다음: Client 구성 →