8. Streaming¶

streaming 다운로드¶

DownloadAsync(sink)는 응답 본문을 버퍼링하지 않고 chunk 단위로 sink에 전달한다. 반환되는 응답은 status와 헤더를 담고 본문은 비어 있다. chunk는 받은 그대로 전달되며 content-encoding 해제를 적용하지 않는다(압축 옵션과 무관).

await using var file = File.Create("report.bin");
var response = await client.Get("/reports/large")
    .DownloadAsync(chunk => file.Write(chunk.Span));

Console.WriteLine(response.Status); // 본문은 비어 있음

sink는 응답을 읽는 비동기 컨텍스트에서 호출된다. 무거운 동기 작업으로 스레드를 막지 않는다(7장).
누적 크기는 MaxResponseBodySize로 제한된다.

streaming 업로드¶

BodyStream(provider, contentType)는 요청 본문을 chunk 단위로 chunked transfer-encoding으로 전송한다. provider가 null을 돌려주면 본문이 끝난다.

await client.Post("/upload-stream")
    .BodyStream(() => NextChunk(), "application/octet-stream")
    .AsyncRaw();

streaming 업로드는 provider를 rewind할 수 없으므로 자동 retry에서 제외된다 (10장).

다음: 인증과 TLS →