PbIdea 实战教程 - 常用对象使用指南 QQ:3912810832提供

ehxz

免费乐捐，感谢支持

## PbIdea 实战教程 - 常用对象使用指南
作者：在神
---
前言
最近群里经常有朋友问 PbIdea 的各种用法，我把最近几天讨论的内容整理成这篇实战教程，方便大家参考学习。
---
一、uo_json - JSON 解析与操作
这是最常用的对象之一，几乎每个项目都会用到。
1、基本用法

1. 
   
2. // 创建 JSON 对象
   
3. uo_json ljson = create uo_json
   
4. // 解析 JSON 字符串
   
5. string ls_json = '{"name":"智子","age":25}'
   
6. boolean lb_ok = ljson.Parse(ls_json)
   
7. if lb_ok then
   
8.     // 获取 name 值
   
9.     string ls_name = ljson.GetString("name")
   
10.     MessageBox("解析结果", "name = " + ls_name)
    
11. else
    
12.     MessageBox("解析失败", ljson.GetError())
    
13. end if
    
14. // 销毁对象
    
15. destroy ljson
    

复制代码

2、获取值的三种方式

1. 
   
2. uo_json ljson = create uo_json
   
3. ljson.Parse('{"name":"张三","age":25,"price":99.5}')
   
4. // 方式 1：快捷获取（推荐）
   
5. string ls_name = ljson.GetString("name")
   
6. long ll_age = ljson.GetLong("age")
   
7. double ld_price = ljson.GetDouble("price")
   
8. // 方式 2：常规获取（可判断是否成功）
   
9. string ls_name2
   
10. boolean lb_ok = ljson.Get("name", ls_name2)
    
11. // 方式 3：带默认值
    
12. string ls_name3 = ljson.GetString("name", "未知")
    
13. destroy ljson
    

复制代码

3、获取数组值

1. 
   
2. string ls_json = '{"tags":["程序员","Java","PowerBuilder"]}'
   
3. uo_json ljson = create uo_json
   
4. ljson.Parse(ls_json)
   
5. // 获取字符串数组
   
6. string ls_tags[]
   
7. ljson.Get("tags", ls_tags[])
   
8. long ll_count = UpperBound(ls_tags)
   
9. for li_i = 1 to ll_count
   
10.     MessageBox("标签", ls_tags[li_i])
    
11. next
    
12. destroy ljson
    

复制代码

4、获取嵌套对象

1. 
   
2. string ls_json = '{"user":{"name":"张三","age":25},"address":{"city":"北京","zip":"100000"}}'
   
3. uo_json ljson = create uo_json
   
4. ljson.Parse(ls_json)
   
5. // 获取嵌套对象
   
6. uo_json luser = create uo_json
   
7. ljson.Get("user", luser)
   
8. string ls_name = luser.GetString("name")
   
9. long ll_age = luser.GetLong("age")
   
10. uo_json laddress = create uo_json
    
11. ljson.Get("address", laddress)
    
12. string ls_city = laddress.GetString("city")
    
13. destroy luser
    
14. destroy laddress
    
15. destroy ljson
    

复制代码

5、构建 JSON

1. 
   
2. uo_json ljson = create uo_json
   
3. ljson.Set("name", "张三")
   
4. ljson.Set("age", 25)
   
5. ljson.Set("email", "zhangsan@example.com")
   
6. // 输出为字符串（true 表示格式化输出）
   
7. string ls_result = ljson.ToString(true)
   
8. MessageBox("JSON", ls_result)
   
9. destroy ljson
   

复制代码

---
二、uo_curl - HTTP 请求
基于 curl 库的 HTTP 客户端，功能强大。
1、GET 请求

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. // 设置 URL 和方法
   
4. lcURL.SetUrl("https://api.example.com/data", HttpGet)
   
5. // 设置请求头
   
6. lcURL.SetHeader("Authorization", "Bearer your-token")
   
7. lcURL.SetHeader("Accept", "application/json")
   
8. // 设置超时（毫秒）
   
9. lcURL.SetTimeout(10000)
   
10. // 发送请求
    
11. boolean lb_ok = lcURL.request()
    
12. if lb_ok then
    
13.     // 检查 HTTP 状态码
    
14.     if lcURL.response.httpcode = 200 then
    
15.         MessageBox("请求成功", lcURL.response.text)
    
16.     else
    
17.         MessageBox("请求失败", "状态码：" + string(lcURL.response.httpcode))
    
18.     end if
    
19. else
    
20.     MessageBox("网络错误", lcURL.response.errtext)
    
21. end if
    
22. destroy lcURL
    

复制代码

2、POST 请求（JSON 数据）

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. // 设置 URL
   
4. lcURL.SetUrl("https://api.example.com/api/users", HttpPost)
   
5. // 设置请求头
   
6. lcURL.SetHeader("Content-Type", "application/json")
   
7. lcURL.SetHeader("Accept", "application/json")
   
8. // 构建 JSON 数据
   
9. uo_json ljson = create uo_json
   
10. ljson.Set("name", "张三")
    
11. ljson.Set("age", 25)
    
12. ljson.Set("email", "zhangsan@example.com")
    
13. // 发送请求
    
14. boolean lb_ok = lcURL.request(ljson)
    
15. if lb_ok then
    
16.     if lcURL.response.httpcode = 200 then
    
17.         // 解析响应
    
18.         uo_json lresp = create uo_json
    
19.         lresp.Parse(lcURL.response.data)
    
20.         string ls_id = lresp.GetString("id")
    
21.         MessageBox("创建成功", "用户 ID：" + ls_id)
    
22.         destroy lresp
    
23.     else
    
24.         MessageBox("请求失败", lcURL.response.errtext)
    
25.     end if
    
26. end if
    
27. destroy ljson
    
28. destroy lcURL
    

复制代码

3、POST 请求（表单数据）

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. lcURL.SetUrl("https://api.example.com/api/login", HttpPost)
   
4. // 设置表单字段
   
5. lcURL.SetForm("username", "admin")
   
6. lcURL.SetForm("password", "123456")
   
7. lcURL.SetForm("remember", "1")
   
8. boolean lb_ok = lcURL.request()
   
9. if lb_ok then
   
10.     MessageBox("登录结果", lcURL.response.text)
    
11. end if
    
12. destroy lcURL
    

复制代码

4、文件下载

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. lcURL.SetUrl("https://example.com/file.zip", HttpGet)
   
4. lcURL.SetDownloadFile("C:\\download\\file.zip")
   
5. boolean lb_ok = lcURL.request()
   
6. if lb_ok then
   
7.     MessageBox("下载成功", "文件已保存到 C:\\download\\file.zip")
   
8. end if
   
9. destroy lcURL
   

复制代码

5、文件上传

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. lcURL.SetUrl("https://api.example.com/api/upload", HttpPost)
   
4. // 设置上传文件
   
5. lcURL.SetUploadFile("C:\\document.pdf")
   
6. // 设置其他表单字段
   
7. lcURL.SetForm("title", "重要文档")
   
8. lcURL.SetForm("category", "报告")
   
9. boolean lb_ok = lcURL.request()
   
10. if lb_ok then
    
11.     MessageBox("上传成功", lcURL.response.text)
    
12. end if
    
13. destroy lcURL
    

复制代码

6、Basic 认证

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. lcURL.SetUrl("https://api.example.com/api/protected", HttpGet)
   
4. lcURL.SetBasicAuth("username", "password")
   
5. boolean lb_ok = lcURL.request()
   
6. if lb_ok then
   
7.     MessageBox("认证成功", lcURL.response.text)
   
8. end if
   
9. destroy lcURL
   

复制代码

7、JWT 认证

1. 
   
2. uo_curl lcURL = create uo_curl
   
3. lcURL.SetUrl("https://api.example.com/api/user", HttpGet)
   
4. lcURL.SetJWTAuth("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...")
   
5. boolean lb_ok = lcURL.request()
   
6. if lb_ok then
   
7.     MessageBox("请求成功", lcURL.response.text)
   
8. end if
   
9. destroy lcURL
   

复制代码

---
三、uo_crypto - 加密与安全
支持几乎所有常见加密算法，包括国密 SM2/SM3/SM4。
1、AES 加密解密

1. 
   
2. string ls_key = "my-secret-key-123456"
   
3. string ls_iv = "0123456789abcdef"
   
4. blob lb_data = blob("敏感数据")
   
5. // 加密
   
6. blob lb_encrypted = Crypto(lb_data, ls_key, 1, "aes_256_cbc", ls_iv)
   
7. // 解密
   
8. blob lb_decrypted = Crypto(lb_encrypted, ls_key, 0, "aes_256_cbc", ls_iv)
   
9. string ls_result = string(lb_decrypted)
   
10. MessageBox("解密结果", ls_result)
    

复制代码

2、SM4 国密加密

1. 
   
2. string ls_key = "1234567890abcdef"
   
3. string ls_data = "这是需要加密的敏感数据"
   
4. // 加密（decrypto=0 表示加密）
   
5. blob lb_encrypted = gm_sm4(ls_data, ls_key, 0)
   
6. // 解密（decrypto=1 表示解密）
   
7. blob lb_decrypted = gm_sm4(lb_encrypted, ls_key, 1)
   
8. string ls_result = string(lb_decrypted)
   
9. MessageBox("解密结果", ls_result)
   

复制代码

3、SM2 国密加密

1. 
   
2. // 生成 SM2 密钥对
   
3. string ls_pubkey, ls_prikey
   
4. GenerateSM2Key(ls_pubkey, ls_prikey)
   
5. // 加密
   
6. blob lb_encrypted = SM2Encrypt(ls_pubkey, "测试数据", 1)
   
7. // 解密
   
8. blob lb_decrypted = SM2Decrypt(ls_prikey, lb_encrypted, 1)
   
9. // SM2 签名
   
10. string ls_sign = SignWithSM2(ls_prikey, "测试数据", 1)
    
11. // SM2 验签
    
12. boolean lb_ok = VerifyWithSM2(ls_pubkey, "测试数据", ls_sign, 1)
    

复制代码

4、RSA 加密

1. 
   
2. // 生成 RSA 密钥对
   
3. string ls_pubkey, ls_prikey
   
4. GenerateRSAKey(ls_pubkey, ls_prikey, 2048)
   
5. // 加密
   
6. blob lb_encrypted = EncryptByPublicKey(ls_pubkey, "敏感数据")
   
7. // 解密
   
8. blob lb_decrypted = DecryptByPrivateKey(ls_prikey, lb_encrypted)
   
9. // RSA 签名
   
10. string ls_sign = SignWithRSA(ls_prikey, "数据", "sha256")
    
11. // RSA 验签
    
12. boolean lb_ok = SignWithRSAVerify(ls_pubkey, "数据", ls_sign, "sha256")
    

复制代码

5、MD5 哈希

1. 
   
2. string ls_md5 = MD5("需要加密的字符串")
   
3. string ls_filemd5 = MD5File("C:\\file.exe")
   
4. MessageBox("MD5", ls_md5)
   

复制代码

6、SHA 哈希

1. 
   
2. string ls_sha1 = Sha1("数据")
   
3. string ls_sha256 = Sha256("数据")
   
4. string ls_sha512 = Sha512("数据")
   

复制代码

7、Base64 编码解码

1. 
   
2. blob lb_data = blob("测试数据")
   
3. string ls_base64 = Base64(lb_data)
   
4. blob lb_decoded = Base64Decode(ls_base64)
   
5. string ls_result = string(lb_decoded)
   

复制代码

---
四、uo_pdfview - PDF 查看与编辑
1、基本用法

1. 
   
2. uo_pdfview lpdf = create uo_pdfview
   
3. // 打开 PDF 文件
   
4. lpdf.Load("C:\\report.pdf")
   
5. // 获取页数
   
6. long ll_pagecount = lpdf.GetPageCount()
   
7. // 获取指定页文本
   
8. string ls_text = lpdf.GetPageText(1)
   
9. // 打印
   
10. lpdf.Print(false)  // false=不显示打印对话框
    
11. destroy lpdf
    

复制代码

2、加载页面为图片

1. 
   
2. uo_pdfview lpdf = create uo_pdfview
   
3. lpdf.Load("C:\\report.pdf")
   
4. // 获取指定页的 BITMAP 数据
   
5. blob lb_page = lpdf.LoadPage(1, 800, 1000)
   
6. // 保存页面为图片文件
   
7. lpdf.LoadPage(1, 800, 1000, "C:\\page1.png")
   
8. destroy lpdf
   

复制代码

3、PDF 合并与分割

1. 
   
2. uo_pdfview lpdf = create uo_pdfview
   
3. // 合并多个 PDF
   
4. string ls_pdfs[]
   
5. ls_pdfs[1] = "C:\\file1.pdf"
   
6. ls_pdfs[2] = "C:\\file2.pdf"
   
7. lpdf.MeargePDF(ls_pdfs, "C:\\merged.pdf")
   
8. // 按页分割 PDF
   
9. string ls_result[]
   
10. lpdf.SplitPDF("C:\\file.pdf", "C:\\output\\page_", ls_result[])
    
11. destroy lpdf
    

复制代码

4、在 PDF 上绘图

1. 
   
2. uo_pdfview lpdf = create uo_pdfview
   
3. lpdf.Load("C:\\report.pdf")
   
4. // 画线
   
5. lpdf.DrawLine(1, 100, 100, 500, 100, RGB(255,0,0), 2)
   
6. // 画框
   
7. lpdf.DrawBox(1, 100, 200, 500, 300, RGB(0,0,255), 2, false)
   
8. // 添加文字
   
9. lpdf.DrawText("测试文字", 1, 100, 400, RGB(0,0,0), "宋体", 12, 0)
   
10. // 保存
    
11. lpdf.SaveAs("C:\\report_new.pdf")
    
12. destroy lpdf
    

复制代码

---
五、uo_yibao - 医保接口
医保专用接口对象，支持多个省份的医保接口调用。
1、基本用法

1. 
   
2. uo_yibao lyibao = create uo_yibao
   
3. // 设置医保类型（0=甘肃，1=黑龙江，2=吉林，3=江苏，4=山西）
   
4. lyibao.SetYiBao_Option(0, 1)
   
5. // 准备请求参数
   
6. string ls_args = "action=card_auth&card_no=123456"
   
7. string ls_headers = "Content-Type: application/x-www-form-urlencoded"
   
8. string ls_body = "param=加密参数"
   
9. string ls_result
   
10. // 发起请求
    
11. boolean lb_ok = lyibao.YiBao_Request(ls_args, ls_headers, ls_body, ls_result)
    
12. if lb_ok then
    
13.     MessageBox("请求成功", ls_result)
    
14. end if
    
15. destroy lyibao
    

复制代码

2、国密算法

1. 
   
2. uo_yibao lyibao = create uo_yibao
   
3. // 生成 SM2 密钥对
   
4. string ls_pubkey, ls_prikey
   
5. lyibao.GM_createKey(ls_pubkey, ls_prikey)
   
6. // SM2 签名
   
7. string ls_data = "需要签名的数据"
   
8. blob lb_sign = lyibao.sm2sign("1234567812345678", ls_prikey, ls_pubkey, ls_data)
   
9. // SM2 验签
   
10. boolean lb_ok = lyibao.sm2verify("1234567812345678", ls_pubkey, ls_data, lb_sign)
    
11. // SM3 哈希
    
12. blob lb_hash = lyibao.sm3(ls_data)
    
13. // SM4 加密解密
    
14. string ls_key = "1234567890abcdef"
    
15. blob lb_encrypted = lyibao.sm4(ls_data, ls_key, 0)  // 加密
    
16. blob lb_decrypted = lyibao.sm4(lb_encrypted, ls_key, 1)  // 解密
    
17. destroy lyibao
    

复制代码

---
六、注意事项
1、对象必须销毁
所有 uo_* 对象使用完毕后必须 destroy，否则内存泄漏。
2、字符编码
字符串转 blob 时注意字符集，PB10+ 默认 UTF-16LE。
3、HTTP 请求
request() 返回的是调用是否成功，不代表接口处理是否正确，需要检查 response.httpcode。
4、加密算法
SM4 使用 16 字节（128 位）密钥，字符串格式为 16 个字符。
5、线程安全
数据库连接池对象（uo_database_pool）专为多线程设计。
---
七、总结
PbIdea 提供了丰富的功能对象，让 PowerBuilder 开发更加便捷。本文整理了最近几天群里讨论最多的几个对象，希望能帮助大家快速上手。
如有问题欢迎在群里讨论。
---
作者：在神
本文基于 PbIdea 官方文档和实际使用经验整理，如有错误欢迎指正。