fileDownload

URI

/download[.<format>]

支持的方法

GET、HEAD

父资源

data

介绍

fileDownload 资源用于下载由数据项 id 指定的有权限下载的数据文件。支持在请求中使用 Range 头实现断点续传。

支持的方法：

GET：下载由数据项 id 指定的有权限下载的数据文件。
HEAD：检查 fileDownload 资源是否存在，或权限是否可以访问 fileDownload 资源。

支持的表述格式：数据流。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiportal 是服务器名。

http://supermapiportal:8190/iportal/web/datas/download.rjson

GET 请求

下载由数据项 id 指定的有权限下载的数据文件。

响应示例

对 fileDownload 资源：http://localhost:8190/iportal/web/datas/1/download 执行 get 请求，可以获取到数据项对应的下载文件。下载得到的文件名和数据项文件名相同，如：数据项文件名为 China400.zip ，则下载得到的文件名也为 China400.zip 。

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 fileDownload 资源是否存在，或者客户端是否有权限访问 fileDownload 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 fileDownload 资源是否支持<format>格式的表述。