|
|
@@ -9,66 +9,7 @@
|
|
|
本文件没有对外接口，直接在main.lua中require "http_app"就可以加载运行；
|
|
|
]]
|
|
|
|
|
|
---[[
|
|
|
-此处先详细解释下http.request接口的使用方法
|
|
|
-
|
|
|
-接口定义：
|
|
|
- http.request(method, url, headers, body, opts, server_ca_cert, client_cert, client_key, client_password)
|
|
|
-
|
|
|
-使用方法：
|
|
|
- local code, headers, body = http.request(method, url, headers, body, opts, server_ca_cert, client_cert, client_key, client_password).wait()
|
|
|
- 只能在task中使用
|
|
|
- 发送http请求到服务器，等待服务器的http应答，此处会阻塞当前task，等待整个过程成功结束或者出现错误异常结束或者超时结束
|
|
|
|
|
|
-参数定义：
|
|
|
- method，stirng类型，必须包含此参数，表示HTTP请求方法，支持"GET"、"POST"、"HEAD"等所有HTTP请求方法
|
|
|
- url，string类型，必须包含此参数，表示HTTP请求URL地址，支持HTTP、HTTPS，支持域名、IP地址，支持自定义端口，标准的HTTP URL格式都支持
|
|
|
- headers，table或者nil类型，可选包含此参数，表示HTTP请求头，例如 {["Content-Type"] = "application/x-www-form-urlencoded", ["self_defined_key"] = "self_defined_value"}
|
|
|
- body，string或者zbuff或者nil类型，可选包含此参数，表示HTTP请求体，如果请求体是一个文件中的内容，要把文件内容读出来，赋值给body使用
|
|
|
- opts，table或者nil类型，可选包含此参数，表示HTTP请求的一些额外配置，包含以下内容
|
|
|
- {
|
|
|
- timeout -- -- number或者nil类型，单位毫秒，可选包含此参数，表示从发送请求到读取到服务器响应整个过程的超时时间，如果传入0，表示永久等待；如果没有传入此参数或者传入nil，则使用默认值10分钟
|
|
|
- dst -- 下载路径，string类型，当HTTP请求的数据需要保存到文件中时，此处填写完整的文件路径
|
|
|
- adapter -- 使用的网卡ID，number类型，例如4G网卡，SPI外挂以太网卡，WIFI网卡等；如果没有传入此参数，内核固件会自动选择当前时间点其他功能模块设置的默认网卡
|
|
|
- -- 除非你HTTP请求时，一定要使用某一种网卡，才设置此参数；如果没什么特别要求，不要使用此参数，使用系统中设置的默认网卡即可
|
|
|
- -- 这个参数和本demo中的netdrv_device.lua关系比较大，netdrv_device会设置默认网卡，此处http不要设置adapter参数，直接使用netdrv_device设置的默认网卡就行
|
|
|
- debug -- 调试开关，bool类型，true表示打开debug调试信息日志，false表示关闭debug调试信息日志，默认为关闭状态
|
|
|
- ipv6 -- 是否为ipv6，bool类型，true表示使用ipv6，false表示不使用ipv6，默认为false
|
|
|
- userdata -- 下载回调函数使用的用户自定义回调参数，做为callback回调函数的第三个参数使用
|
|
|
- callback -- 下载回调函数，function类型，当下载数据时，无论是保存到内存中，还是保存到文件系统中，如果设置了callback，内核固件中每收到一包body数据，都会自动执行一次callback回调函数
|
|
|
- -- 回调函数的调用形式为callback(content_len, body_len, userdata)
|
|
|
- -- content_len：number类型，数据总长度
|
|
|
- -- body_len：number类型，已经下载的数据长度
|
|
|
- -- userdata：下载回调函数使用的用户自定义回调参数
|
|
|
- }
|
|
|
- server_ca_cert，string类型，服务器ca证书数据，可选包含此参数，当客户端需要验证服务器证书时，需要此参数，如果证书数据在一个文件中，要把文件内容读出来，赋值给server_ca_cert
|
|
|
- client_cert，string类型，客户端证书数据，可选包含此参数，当服务器需要验证客户端证书时，需要此参数，如果证书数据在一个文件中，要把文件内容读出来，赋值给client_cert
|
|
|
- client_key, string类型，客户端加密后的私钥数据，可选包含此参数，当服务器需要验证客户端证书时，需要此参数，如果加密后的私钥数据在一个文件中，要把文件内容读出来，赋值给client_key
|
|
|
- client_password，string类型，客户端私钥口令数据，可选包含此参数，当服务器需要验证客户端证书时，需要此参数，如果私钥口令数据在一个文件中，要把文件内容读出来，赋值给client_password
|
|
|
-
|
|
|
-返回值定义：
|
|
|
-
|
|
|
- http.request().wait()有三个返回值code，headers，body
|
|
|
- code表示执行结果，number类型，有以下两种含义：
|
|
|
- 1、code大于等于100时，表示服务器返回的HTTP状态码，例如200表示成功，详细说明可以通过搜索引擎搜索“HTTP状态码”自行了解
|
|
|
- 2、code小于0时，表示内核固件中检测到通信异常，有如下几种:
|
|
|
- -1 HTTP_ERROR_STATE 错误的状态, 一般是底层异常,请报issue
|
|
|
- -2 HTTP_ERROR_HEADER 错误的响应头部, 通常是服务器问题
|
|
|
- -3 HTTP_ERROR_BODY 错误的响应体,通常是服务器问题
|
|
|
- -4 HTTP_ERROR_CONNECT 连接服务器失败, 未联网,地址错误,域名错误
|
|
|
- -5 HTTP_ERROR_CLOSE 提前断开了连接, 网络或服务器问题
|
|
|
- -6 HTTP_ERROR_RX 接收数据报错, 网络问题
|
|
|
- -7 HTTP_ERROR_DOWNLOAD 下载文件过程报错, 网络问题或下载路径问题
|
|
|
- -8 HTTP_ERROR_TIMEOUT 超时, 包括连接超时,读取数据超时
|
|
|
- -9 HTTP_ERROR_FOTA fota功能报错,通常是更新包不合法
|
|
|
- headers有以下两种含义：
|
|
|
- 1、当code的返回值大于等于100时，headers表示服务器返回的应答头，table类型
|
|
|
- 2、当code的返回值小于0时，headers为nil
|
|
|
- body有以下三种含义
|
|
|
- 1、当code的返回值大于等于100时，如果请求的body数据不需要保存到文件中，而是直接保存到内存中，则body表示请求到的数据内容，string类型
|
|
|
- 2、当code的返回值大于等于100时，如果请求的body数据需要保存到文件中，则body表示保存请求数据后的文件的大小，number类型
|
|
|
- 3、当code的返回值小于0时，body为nil
|
|
|
-]]
|
|
|
|
|
|
|
|
|
-- 普通的http get请求功能演示
|
王城钧