aardio 文档

inet.httpFile 库模块帮助文档

inet 成员列表 #

inet.httpFile #

下载文件,支持断点续传

inet.httpFile() #

返回对象:inetFileObject

inet.httpFile(URL,存储路径,配置文件路径,userAgent,proxy,...) #

存储路径如果是目录则必须以反斜杠结尾,
存储路径如果是目录或者未指定后缀名,则尝试自动获取文件名
配置文件可指定目录,也可以是文件路径(必须指定后缀名)
如果不指定配置文件路径,则指定为存储路径 + ".dow!oad"
其他可选参数用于创建http对象,参考inet.http构造函数说明

inetFileObject 成员列表 #

inetFileObject.bufferSize #

缓冲区大小
不指定则默认为 256KB

inetFileObject.close() #

关闭连接

inetFileObject.complete #

是否下载完成

inetFileObject.contentLength #

需要下载的文件长度
如果文件长度为零,并且modified属性为false,表示不需要重新下载
download函数返回值为 true 则 contentLength 表示已下载文件总长度

inetFileObject.download(HTTP头,引用网址,accept,flags,postData) #

下载文件,所有参数都是可选参数.
下载成功返回true,
文件已下载成功无需重新下载返回true,错误信息,
下载失败返回null以及错误信息
取消返回false,无错误信息

可通过complete属性检测本次下载文件是否成功

inetFileObject.filename #

存储文件名,
仅在存储路径为目录时有效,
可在调用download函数以前修改,
如果未指定则在调用 test 或 download 函数时自动获取

inetFileObject.isModified() #

检测已下载的文件在服务器上是否已被修改,
该函数会调用 download() 进行测试(不会启动下载)

inetFileObject.modified #

文件是否己更新

inetFileObject.onReceive #

inetFileObject.onReceive = function(buffer,readSize,contentLength){

}

inetFileObject.onReceiveBegin #

inetFileObject.onReceiveBegin = function(statusCode,contentLength,fileSize){
    if( statusCode == 206/*断点续传*/ ){

    }
}

inetFileObject.path #

存储路径,
可在调用download函数以前修改

inetFileObject.removeResumeFile() #

移除断点续传配置文件

inetFileObject.resumePath #

续传文件路径,
可在调用download函数以前修改

inetFileObject.session #

HTTP连接对象

返回对象:inetHttpObject

inetFileObject.statusCode #

HTTP 状态码

inetFileObject.test(HTTP头,引用网址,accept,flags,postData) #

检测是否已下载最新文件
已下载文件未变更返回true
需要下载或续传返回false,下载错误返回null以及错误信息

Markdown 格式