PBIDEA：uo_httpclient 发请求并处理 JSON 响应

pbai

免费乐捐，感谢支持

PBIDEA：uo_httpclient 发请求并处理 JSON 响应

一句话结论

用 uo_httpclient 发 HTTP 请求，核心要记住三点：Request() 返回的是 UTF-8 编码的 blob，必须 fromUtf8 转成字符串，再用 uo_json 解析。把这三个动作串起来，GET / POST / JSON 全部搞定。

1. 创建客户端

2. uo_httpclient hc
3. hc = create uo_httpclient

复制代码

create 时会触发 constructor，内部自动调用 hcCreate() 并建立 uo_response 响应对象。用完记得 destroy hc，否则底层的 winhttp 句柄不会释放。

2. GET 请求拿到 JSON

2. string ls_json
3. blob lbl_data
5. lbl_data = hc.Request(hc.HttpGet, "https://api.example.com/users")
6. ls_json = fromUtf8(lbl_data)

复制代码

Request 的第一个参数是动作常量：

• HttpGet = 1
  
• HttpPost = 2
  
• HttpPut = 3
  
• HttpPatch = 4
  
• HttpDelete = 5
  

返回值是 blob，也就是 UTF-8 的原始字节。中文必须 fromUtf8 才能正确显示，直接当字符串用会出现乱码，这是新手最容易踩的坑。

3. 把响应解析成 uo_json

2. uo_json lj
3. lj = hc.BlobToJson(lbl_data)
5. string ls_name
6. ls_name = lj.get("/users/0/name")

复制代码

BlobToJson 能直接把 UTF-8 的 blob 转成 uo_json 对象，再用路径语法（如 /users/0/name）取值，不用自己切字符串。

4. POST 一个 JSON 请求体

2. uo_json lj_body
3. lj_body = create uo_json
4. lj_body.set("username", "test")
5. lj_body.set("password", "123456")
7. hc.SetHeader("Content-Type", "application/json")
8. blob lbl_resp
9. lbl_resp = hc.Request(hc.HttpPost, "https://api.example.com/login", lj_body)
11. string ls_result
12. ls_result = fromUtf8(lbl_resp)
14. destroy lj_body

复制代码

把 uo_json 对象直接作为 Request 的第三个参数，组件会把它序列化成 JSON 请求体。由于 PBIDEA 未在导出源码里暴露该重载是否自动设置 Content-Type，如上例显式 SetHeader("Content-Type", "application/json") 最稳妥——不依赖组件内部行为，兼容性最好，也不用自己拼 JSON 字符串。

5. 带鉴权与自定义头

2. hc.SetHeader("Accept", "application/json")
3. hc.SetJWTAuth(token)
4. hc.SetBasicAuth(user, pwd)

复制代码

• SetHeader 设置任意请求头；
  
• SetJWTAuth 填入 token 即可，组件自动加 Authorization: Bearer；
  
• SetBasicAuth 传入用户名和密码，组件自动做 Base64 编码。
  

6. 大文件下载

2. blob lbl_file
3. lbl_file = hc.DownLoad("https://x/y.zip")            // 落内存 blob
5. hc.DownLoadFile("https://x/y.zip", "d:\tmp\y.zip")   // 直接落盘到文件

复制代码

下载进度可以挂 ondownload 事件回调，在界面上显示百分比，避免大文件时界面卡死。

7. 收尾与超时

2. hc.SetTimeout(30000)   // 超时单位：毫秒
3. destroy hc

复制代码

SetTimeout 的参数是毫秒。如果接口偶尔慢，可以适当调大；生产环境建议显式设置，避免无限等待。

常见坑速查

• 忘记 fromUtf8：返回的中文全是乱码，这是第一常见问题。
  
• for 循环里内联声明变量非法：老 PB 不支持 for long i = 0 to n，要先 long i 再 for i = 0 to n。
  
• 声明与初始化拆两行更稳：uo_json lj / lj = create uo_json，兼容性最好。
  
• 字符串字面量用单引号没问题：PBIDEA 环境支持 '{"key":"值"}' 这种写法。
  

总结

uo_httpclient 把 winhttp 封装成了「一行 Request 发请求」，GET / POST / 文件下载 / JWT / Basic 鉴权都内置好了。只要记住「返回 blob → fromUtf8 转码 → uo_json 解析」这三步走，绝大多数接口对接场景都能直接落地。