跳到主要内容

HttpClient

描述:

  代表一个HTTP客户端。

postAsync

类型: 函数。

描述:

  向指定的URL发送JSON文本的POST请求,并返回响应文本。

签名:

postAsync: function(self: HttpClient, url: string, json: string, timeout?: number): string | nil

参数:

参数名类型描述
urlstring要发送请求的URL。
jsonstring要在请求中发送的JSON文本。
timeoutnumber[可选] 请求超时时间(以秒为单位,默认为5秒)。

返回值:

返回类型描述
string响应体的文本,如果请求失败则返回nil。

getAsync

类型: 函数。

描述:

  向指定的URL发送GET请求,并返回响应文本。

签名:

getAsync: function(self: HttpClient, url: string, timeout?: number): string | nil

参数:

参数名类型描述
urlstring要发送请求的URL。
timeoutnumber[可选] 请求超时时间(以秒为单位,默认为5秒)。

返回值:

返回类型描述
string响应体的文本,如果请求失败则返回nil。

downloadAsync

类型: 函数。

描述:

  从指定的URL异步下载文件,并保存到指定的路径。必须在一个协程中调用此方法。

签名:

downloadAsync: function(self: HttpClient, url: string, fullPath: string, timeout?: number, progress?: function(current: integer, total: integer): boolean): boolean

参数:

参数名类型描述
urlstring需要下载的文件的URL。
fullPathstring下载文件应保存的完整路径。
timeoutnumber[可选] 下载超时时间(以秒为单位,默认为30秒)。
progressstring[可选] 一个定期报告下载进度的回调函数。 该函数接收两个参数:current(到目前为止下载的字节数)和 total(需要下载的总字节数)。如果回调函数返回 true,则下载将被取消。

返回值:

返回类型描述
boolean一个布尔值,表示下载是否成功完成。