HTTP 范围请求
HTTP 的 Range 请求使客户端能够要求服务器仅向其回传 HTTP 消息的一部分。范围请求对于支持随机访问的媒体播放器、明确只需大型文件某部分的数据处理工具,以及允许用户暂停及恢复下载的下载管理器等客户端尤其有用。
特性检测
如果 HTTP 响应中存在 Accept-Ranges 标头,并且其值不是“none”,那么该服务器支持范围请求。你可以通过使用像 cURL 这样的工具发出一个 HEAD 请求来进行手动检查。
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”,以表明它们不支持这一特性。
单一范围请求
如果服务器支持范围请求,那么只需在 HTTP 请求中包含 Range 标头,你可以指定希望服务器返回文档的哪一部分或哪些部分。Range 标头,用于请求前 1024 个字节:
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
…
(二进制内容)
Content-Length 标头现在表示所请求范围的大小(而非图像的完整大小)。Content-Range 响应标头则表示此部分消息在完整资源中的位置。
多重范围请求
Range 标头还允许在文档中支持一次性获取多重范围。这些范围使用逗号分隔。
Range: bytes=0-50, 100-150
服务器以 206 Partial Content 状态码以及 Content-Type: multipart/byteranges; boundary=3d6b6a416f9b5 标头响应,表明随后的数据将采用多部分字节范围格式。每个部分都携带自己的 Content-Type 和 Content-Range 字段,而必须的 boundary 参数定义了用于分割每个消息体部分的边界字符串。
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 lang="en-US">
<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
范围请求的响应
与范围请求相关的有三种状态:
- 范围请求成功后,服务器会发出 206 Partial Content 状态。
- 超出范围的范围请求将导致 416 Requested Range Not Satisfiable 状态,这意味着没有任何范围值与资源的范围重叠。例如,每个范围的第一个字节位置可能大于资源的长度。
- 如果不支持范围请求,则返回 200 OK 状态,并传输完整的响应体。
与分块 Transfer-Encoding 的对比
Transfer-Encoding 标头支持分块编码,这对于向客户端发送大量数据特别有用,尤其是在完全处理请求之前无法知道响应的总大小的情况下。服务器直接向客户端发送数据,无需确定缓冲响应或确切长度,从而减少延迟提高响应速度。范围请求和分块传输是兼容的,可以独立使用或结合使用。