Http 类

网络请求工具类

@note 网络使用的cache策略请参考CachePolicy 网络请求的加密策略请参考EncType 网络响应体中相关key请参考ResponseKey 网络错误信息中相关key请参考ErrorKey

变量

_priveta_class_name : string

name : string

方法

setBaseUrl

配置根地址，可以避免每次都拼接重复的基础地址

@note 目前不支持使用此方法设置BaseUrl，如需设置baseUrl，可继承Http在协议方法中自行实现

参数

• baseURL : string 根地址

返回值

• 返回http对象本身 : Http

addCachePolicyFilterKey

为缓存策略添加过滤参数

在使用缓存策略时，有些参数会影响缓存的命中率（eg，地理位置参数实时变更， 可能会导致无法命中缓存)，可以使用该方法过滤

@note 具体的cache策略请参考CachePolicy

参数

• filterKey : string 缓存策略CachePolicy

返回值

• 返回http对象本身 : Http

get

发起GET请求

 网络结果回调方法，格式为：
	```
	function(success, response, error)
		--- success为boolean，请求是否成功
		--- response为Map，网络响应数据
		--- error为Map，请求失败的信息
	end
	```

@note url必须去掉host，host必须通过setBaseUrl设置

参数

• url : string url地址，如果设置了BaseURL可以只填写path
• param : Map 请求使用到的所有参数，可以是Map
• callback : function(success|response|error)

返回值

• 返回http对象本身 : Http

post

发起POST请求

 网络结果回调方法，格式为：
	```
	function(success, response, error)
		--- success为boolean，请求是否成功
		--- response为Map，网络响应数据
		--- error为Map，请求失败的信息
	end
	```

@note url必须去掉host，host必须通过setBaseUrl设置

参数

• url : string url地址，如果设置了BaseURL可以只填写path
• param : Map 请求使用到的所有参数，可以是Map
• callback : function(success|response|error)

返回值

• 返回http对象本身 : Http

download

下载数据请求

 下载进度回调，格式为：
	```
	function(number progress, number total)
		--- progress:当前的进度
		--- total:文件总长度
	end
	```
 网络结果回调方法，格式为：
	```
	function(success, response, error)
		--- success为boolean，请求是否成功
		--- response为Map，网络响应数据
		--- error为Map，请求失败的信息
	end
	```

@note url必须去掉host，host必须通过setBaseUrl设置

参数

• url : string url地址，如果设置了BaseURL可以只填写path
• param : Map 请求使用到的所有参数，可以是Map
• callback : function(success|response|error)
• callback : any

返回值

• 返回http对象本身 : Http

upload

上传数据请求

 网络结果回调方法，格式为：
	```
	function(success, response, error)
		--- success为boolean，请求是否成功
		--- response为Map，网络响应数据
		--- error为Map，请求失败的信息
	end
	```

参数

• url : string url地址，如果设置了BaseURL可以只填写path
• param : Map 请求使用到的所有参数，可以是Map
• filePaths : Array 文件路径数组
• fileNames : Array 文件名字数组
• callback : function(success|response|error)

返回值

• 返回http对象本身 : Http