HTTP 범위 요청
==========

HTTP 범위 요청은 HTTP의 일정 부분만 서버에서 클라이언트로 보내도록 허락하는 것입니다. 부분 요청은 예를들어 대형 미디어나 파일 다운로드 도중 일시정지와 다시 시작 기능에 유용합니다.

서버가 부분 요청을 지원하는지 확인
-------------------

서버가 범위 요청을 지원한다면, HTTP 응답에 `Accept-Ranges`이 존재(그리고 그 값이 "`none`"이 아님)할 것입니다. 이는 예를들면 `HEAD` 를 cURL에서 요청함으로 확인할 수 있습니다.
```

curl -I http://i.imgur.com/z4d4kWk.jpg

HTTP/1.1 200 OK
...
Accept-Ranges: bytes
Content-Length: 146515
```


이 응답에서, `Accept-Ranges: bytes`는 바이트가 범위 요청에서 최소단위로 사용될 수 있음을 알려줍니다. 여기에서 `Content-Length` 헤더 역시 이미지를 얻기 위한 최대 크기를 알 수 있어 유용합니다.

만약 사이트에서 `Accept-Ranges`헤더를 빠트린다면, 분할 요청을 지원하지 않는 것으로 생각됩니다. 일부 사이트는 명확하게 "`none`"을 값으로 보내 지원하지 않는 것을 알려줍니다. 일부 어플리케이션에서는 다운로드 매니저에서 일시정지 버튼을 없애버리는 경우가 있습니다.
```

curl -I https://www.youtube.com/watch?v=EwTZ2xpQwpA

HTTP/1.1 200 OK
...
Accept-Ranges: none
```

서버에 특정 범위를 요청
-------------

만약 서버가 범위 요청을 지원한다면, `Range` 헤더를 사용하여 요청할 수 있습니다. 이는 서버에서 문서의 일부분만 돌려주면 된다는 것을 알 수 있게 해줍니다.

### 단일 부분 범위

우리는 리소스의 단일 부분에 대해서만 요청할 수 있습니다. 역시 cURL을 사용하여 테스트 합니다. "`-H`"는 HTTP요청의 헤더에 추가된다는 옵션이며, 이 경우에는 `Range`헤더로 첫 1024 바이트를 요청합니다.
```

curl http://i.imgur.com/z4d4kWk.jpg -i -H "Range: bytes=0-1023"
```


요청은 다음처럼 보여집니다:
```

GET /z4d4kWk.jpg HTTP/1.1
Host: i.imgur.com
Range: bytes=0-1023
```


서버에서 `206` `Partial Content` 상태로 응답합니다:
```

HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/146515
Content-Length: 1024
...
(binary content)
```


`Content-Length` 헤더는 이제 요청한 범위의 크기(전체 이미지의 크기가 아님)를 알려줍니다. `Content-Range` 헤더는 리소스의 전체 크기와 메시지가 어느 부분에 속하는지 알려줍니다.

### 다중 부분 범위

`Range` 헤더는 문서의 여러 부분 역시 다중 범위 요청을 통해 한번에 가져올 수 있습니다. 범위는 콤마로 나누어집니다.
```

curl http://www.example.com -i -H "Range: bytes=0-50, 100-150"
```


서버는 `206` `Partial Content` 상태로 응답하며 `Content-Type``: multipart/byteranges; boundary=3d6b6a416f9b5` 는 다중 부분 바이트 범위를 알려줍니다. 각 부분은 고유의 `Content-Type`과 `Content-Range` 영역을 가지고 있으며, 경계를 나누는 문자열인 경계 파라미터를 필요로 합니다.
```

HTTP/1.1 206 Partial Content
Content-Type: multipart/byteranges; boundary=3d6b6a416f9b5
Content-Length: 282

--3d6b6a416f9b5
Content-Type: text/html
Content-Range: bytes 0-50/1270

<!doctype html>
<html>
<head>
    <title>Example Do
--3d6b6a416f9b5
Content-Type: text/html
Content-Range: bytes 100-150/1270

eta http-equiv="Content-type" content="text/html; c
--3d6b6a416f9b5--
```

### 조건 분할 요청

리소스에 대해 추가 요청을 재개하기에 앞서, 마지막에 분할된 데이터를 받은 이후 저장된 리소스가 수정되지는 않았는지 확인해야 합니다.

`If-Range` HTTP 요청 헤더는 범위 요청에 조건을 만듭니다: 만약 조건이 만족하면, 분할 요청은 서버에서 처리되어 `206` `Partial Content` 응답과 함께 적절한 바디와 돌아올겁니다. 만약 조건이 만족하지 못한다면, 전체 리소스가 `200` `OK` 상태로 보내집니다. 이 헤더는 `Last-Modified` 확인자나 `ETag`와 함께 사용될 수 있지만, 동시에는 안됩니다.
```

If-Range: Wed, 21 Oct 2015 07:28:00 GMT
```

분할 요청 응답
--------

범위 요청을 처리할 때, 다음의 3가지 상태가 있습니다:

* 성공적으로 보내질 경우에는, `206` `Partial Content` 상태가 서버에서 돌아옵니다.
* 범위를 벗어난 경우(범위 값이 리소스 크기를 벗어났을 때), 서버는 `416` `Requested Range Not Satisfiable` 상태로 답합니다.
* 범위 요청을 지원하지 않는 경우, 서버는 `200` `OK` 상태를 돌려보냅니다.
`Chunked Transfer-Encoding`과 비교
-------------------------------

`Transfer-Encoding` 헤더는 `chunked encoding` 또한 지원하며, 이는 대용량 데이터를 클라이언트에 보낼 때와 요청이 모두 처리되기 전까지 총 크기를 알 수 없을 때 유용합니다. 서버는 데이터를 클라이언트에 응답 버퍼링 없이 즉시 보내거나, 정확한 길이를 측정하여 지연 시간을 향상시킵니다. 범위 요청과 청크는 호환되어 함께 사용할 수도 있고, 따로 사용할 수 있습니다.

함께 참고할 내용
---------

* 연관된 상태 코드 `200`, `206`, `416`.
* 연관된 헤더: `Accept-Ranges`, `Range`, `Content-Range`, `If-Range`, `Transfer-Encoding`.
* Download resumption in Internet Explorer