콘텐츠로 이동

← 목차

12. 압축

compression()을 켜면 요청에 Accept-Encoding: gzip, deflate를 붙이고 응답이 gzip 또는 deflate로 인코딩됐으면 투명하게 해제한다.

val report = zlinkHttpClient("https://api.internal") {
    compression()
}.use { client ->
    client.get("/large-report").fetch<Report>()
}

해제 규칙

  • gzip + deflate 모두 처리한다(deflate는 zlib-wrap/raw 둘 다 감지).
  • 해제 후 content-encoding 헤더를 제거한다.
  • decoded 크기maxResponseBodySize로 강제한다.
  • awaitDownload(sink) streaming chunk는 해제하지 않는다(받은 그대로 전달).

본문이 손상됐으면 decode 실패 예외, decoded 크기가 한도를 넘으면 request 실패 예외로 보고된다.

다음: 에러 처리 →