5. Request Body¶

body 소스는 상호 배타다. body, bodyStream, form, multipart 중 하나만 쓸 수 있고 둘 이상 지정하면 예외로 실패한다.

typed JSON¶

client.post("/games").body(new CreateGameReq("ranked-match-0611")).submit(CreateGameRes.class);

body(Object)는 값을 Jackson으로 직렬화하고 content-type: application/json을 설정한다.

raw body¶

client.post("/raw").body("plain text payload", "text/plain").submitRaw();

body(String content, String contentType)(2 인자)는 raw 본문과 명시적 content-type을 설정한다.

form-urlencoded¶

client.post("/login").form("user", "aria").form("password", "secret value").submitRaw();
// content-type: application/x-www-form-urlencoded, percent-encoding 적용

multipart/form-data¶

client.post("/upload")
    .multipart("title", "patch notes")
    .multipartFile("file", "notes.txt", fileContent, "text/plain")
    .submitRaw();

streaming 업로드¶

bodyStream(provider, contentType)는 body를 chunk 단위로 chunked transfer-encoding으로 전송한다. provider는 Supplier<byte[]> 타입이며 끝나면 null을 돌려준다. streaming 요청은 rewind할 수 없으므로 자동 retry에서 제외된다.

Deque<byte[]> chunks = /* ... */;
client.post("/upload-stream")
    .bodyStream(() -> chunks.isEmpty() ? null : chunks.poll(), "application/octet-stream")
    .submitRaw();

다음: Response 다루기 →