aardio 文档

inet.httpFile 库模块帮助文档

inet 成员列表

inet.httpFile

下载文件,支持断点续传

inet.httpFile()

返回对象:inetFileObject

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

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

inetFileObject 成员列表

inetFileObject.bufferSize

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

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 格式