downloader
Downloader模块管理网络文件下载任务，用于从服务器下载各种文件，并支持跨域访问操作。通过plus.downloader获取下载管理对象。Downloader下载使用HTTP的GET/POST方式请求下载文件，符合标准HTTP/HTTPS传输协议。
方法：
- createDownload: 新建下载任务
- enumerate: 枚举应用的所有下载任务
- clear: 清除下载任务
- startAll: 开始所有下载任务
对象：
- Download: Download对象用于管理单个下载任务
- DownloadEvent: 下载任务事件类型
- DownloadState: 下载任务状态
- DownloadOptions: 下载任务的参数
回调方法：
- DownloadCompletedCallback: 下载任务完成时的回调
- DownloadStateChangedCallback: 下载任务状态变化回调
- DownloadEnumerateCallback: 枚举下载任务回调
权限：
permissions
"Downloader": {
"description": "管理下载任务"
}
Download
Download对象用于管理单个下载任务
interface Download {
readonly attribute String id;
readonly attribute String url;
readonly attribute Number state;
readonly attribute DownloadOptions options;
readonly attribute String filename;
readonly attribute Number downloadedSize;
readonly attribute Number totalSize;
function void abort();
function void addEventListener( String event, function Callback listener, Boolean capture );
function String getAllResponseHeaders();
function String getResponseHeader( headerName );
function void pause();
function void resume();
function void setRequestHeader( String headerName, String headerValue );
function void start();
}
属性：
- id: 下载任务的标识
- url: 下载文件的地址
- state: 任务的状态
- options: 下载任务的参数
- filename: 下载的文件名称
- downloadedSize: 已完成下载文件的大小
- totalSize: 下载任务文件的总大小
方法：
- abort: 取消下载任务
- addEventListener: 添加下载任务事件监听器
- getAllResponseHeaders: 获取下载请求HTTP响应头部信息
- getResponseHeader: 获取下载请求指定的HTTP响应头部的值
- pause: 暂停下载任务
- resume: 继续下载任务
- setRequestHeader: 设置下载请求的HTTP头数据
- start: 开始下载任务
DownloadEvent
下载任务事件类型
常量：
- "statechanged": (String
类型
)下载任务状态变化事件
当下载任务状态发生变化时触发此事件，事件原型参考DownloadStateChangedCallback。
DownloadState
下载任务状态
常量：
- undefined: (undefined
类型
)未开始状态
在创建之后触发此状态事件，下载任务处于可开始状态，需调用下载任务的start方法。
- 0: (Number
类型
)初始状态
在调用下载任务start之后触发此状态事件，下载任务处于可调度状态。
- 1: (Number
类型
)下载任务开始处理
开始建立网络连接，发送请求到服务器并等待服务器的响应。
- 2: (Number
类型
)下载任务请求已经接收
网络连接已建立，服务器返回响应，准备传输数据内容。
- 3: (Number
类型
)下载任务请求处理中
传输数据中，在传输过程中不断触发此状态事件。
- 4: (Number
类型
)下载任务已完成
下载任务成功或失败都会设置为此状态。
- 5: (Number
类型
)下载任务暂停状态
暂停任务时设置任务的状态，此时可重新开始下载任务。
- -1: (Number
类型
)非任务状态
不用于表示任务的状态，用于enumerate()和claer()操作所有下载任务。
DownloadOptions
下载任务的参数
说明：
在创建下载任务时设置的参数，如设置下载任务使用的HTTP协议类型、优先级等。
属性：
- method: (String
类型
)网络请求类型
支持http协议的“GET”、“POST”，默认为“GET”请求。
- data: (String
类型
)POST请求时提交的数据
仅在网络请求类型为"POST"时有效，"GET"请求时忽略此数据。
- filename: (String
类型
)下载文件保存的路径
以文件后缀名结尾（如"_doc/download/a.doc"）表明指定保存文件目录及名称，否则认为指定保存文件的目录，若没有指定文件名称则由程序自动生成文件名称。
- priority: (Number
类型
)下载任务的优先级
数值类型，数值越大优先级越高，默认优先级值为0。
- timeout: (Number
类型
)下载任务超时时间
数值类型，单位为s，默认值为120s。 超时时间为服务器响应请求的时间（不是下载任务完成的总时间），如果设置为0则表示永远不超时。
- retry: (Number
类型
)下载任务重试次数
数值类型，默认为重试3次。
- retryInterval: (Number
类型
)下载任务重试间隔时间
单位为s(秒)，默认值为30s。
DownloadCompletedCallback
下载任务完成时的回调
vaoid onCompleted( Download download, Number status ) {
// Download file complete code
}
说明：
下载任务完成时的回调函数，在下载任务完成时调用。 下载任务失败也将触发此回调。
参数：
- download :
(
Download
)
必选 下载任务对象
- status:
(
Number
)
必选 Http传输协议状态码，如果未获取传输状态则其值则为0，如下载成功其值通常为200
返回值：
void : 无DownloadStateChangedCallback
下载任务状态变化回调
void onStateChanged( Download download, status ) {
// Download state changed code.
}
参数：
- download :
(
Download
)
必选 下载任务对象
- status:
(
Number
)
必选 Http传输协议状态码，如果未获取传输状态则其值则为0，如下载成功其值通常为200
返回值：
void : 无DownloadEnumerateCallback
枚举下载任务回调
void onEnumerated( Download[] downloads ) {
// Enumerate success code
}
参数：
- downloads :
(
Download
)
必选 枚举到的下载任务对象数组