uploadTasks

URI

<fileManager_uri>/uploadtasks[.<format>]

支持的方法

GET、POST、HEAD

父资源

fileManager

子资源

uploadTask

介绍

获取当前所有正在上传的文件列表，以及创建一个文件上传资源 uploadTask。

支持的方法：

支持的表述格式：rjson、json、xml。

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/manager/filemanager/uploadtasks.rjson

GET 请求

获取当前所有文件上传任务列表。

响应结构

返回当前所有文件上传任务列表，该列表是由每个任务的 taskInfo 组成的数组。每个任务的状态信息包括：

字段 类型 说明
path String 当前任务中正在上传文件的目标位置，即上传结果文件名及位置。
progress double 当前任务中正在上传的文件上传进度的百分比数值。

响应示例

对 uploadTasks 资源 http://localhost:8090/iserver/manager/filemanager/uploadtasks.rjson，执行 GET 请求

则返回的当前正在上传的文件如下：

[{

    "path": "d:\test\test.sxwu",

    "progress": "88.51",

    "taskID": "5280c5e718a34667b4d39c9d8ab45dc5_b77784d9aa1a4d578a57b03900fda75d"

}]

POST 请求

创建一个文件上传任务资源，可以传递一个空的请求体，也可以在请求体里面携带以下信息，服务端会根据这些信息判断磁盘空间：

字段 类型 说明
md5 String 待上传文件的 md5校验码字符串。
fileSize long 待上传文件的大小，单位是字节。服务端将根据此大小判断磁盘空间是否充足。
path String 待上传文件的路径或位置，可以用相对路径表示。

响应结构

返回创建的文件上传任务资源，包含以下字段：

字段 类型 说明
newResourceID String 结果资源的 ID。
newResourceLocation String 结果资源的 URI 地址。
postResultType PostResultType POST 请求的结果类型，枚举说明 POST 请求对目标资源的影响，即处理结果是什么样的。
succeed String 请求是否成功。

响应示例

对 uploadTasks 资源 http://localhost:8090/iserver/manager/filemanager/uploadtasks.rjson，执行 POST 请求，创建一次文件上传任务，传递请求体如下：

{

    "md5": "4d028bf15ccc072fa2b769318e00f325" ,

    "fileSize": "22970384",

    "path": "../../samples/data/World/World.udb"

}

则返回的 rjson 格式响应结果如下：

{

    "newResourceID": "5280c5e718a34667b4d39c9d8ab45dc5_b77784d9aa1a4d578a57b03900fda75d",

    "newResourceLocation": "http://localhost:8090/iserver/manager/filemanager/uploadtasks/5280c5e718a34667b4d39c9d8ab45dc5_b77784d9aa1a4d578a57b03900fda75d.rjson",

    "postResultType": "CreateChild",

    "succeed": true

}

其中，生成的子资源 http://localhost:8090/iserver/manager/filemanager/uploadtasks/5280c5e718a34667b4d39c9d8ab45dc5_b77784d9aa1a4d578a57b03900fda75d.rjson 即 uploadTask 资源，"newResourceID"即为其{taskID}。

HEAD 请求

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

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

请参见