pb如何读取json

PB (PowerBuilder) 读取 JSON 数据的实用指南**

在现代软件开发中,JSON (JavaScript Object Notation) 凭借其轻量级、易读易写的特性，已成为数据交换的主流格式之一，PowerBuilder (PB) 作为一款成熟的快速应用开发 (RAD) 工具，虽然其传统上更擅长处理数据窗口和结构化数据，但通过引入新的对象库或利用第三方工具，也能高效地处理 JSON 数据，本文将详细介绍在 PowerBuilder 中读取 JSON 数据的几种常用方法。

JSON 简介

JSON 是一种轻量级的数据交换格式，易于人阅读和编写，也易于机器解析和生成，它采用键值对的方式来组织数据，结构清晰，通常用于表示对象、数组、字符串、数字、布尔值和 null。

{
  "name": "张三",
  "age": 30,
  "isEmployee": true,
  "address": {
    "city": "北京",
    "district": "朝阳区"
  },
  "hobbies": ["阅读", "游泳", "编程"]
}

PowerBuilder 读取 JSON 的主要方法

PowerBuilder 本身从版本 12.5 开始逐步增强了 JSON 支持，尤其是在 PB 2017 及更高版本中，内置了 JSONParser 和 JSONGenerator 等系统对象，使得 JSON 处理变得更加便捷，也可以使用第三方 JSON 库或通过 .NET 互操作性来实现。

使用 PowerBuilder 内置 JSON 功能 (PB 2017 及更高版本推荐)

这是目前最推荐、最原生的方法，尤其在较新版本的 PB 中。

1. 创建 JSONParser 对象： JSONParser 是用于解析 JSON 字符串的核心对象。

   n_cst_json_parser lnvo_json_parser
   lnvo_json_parser = CREATE n_cst_json_parser
   // 假设 ls_json_string 是你的 JSON 字符串
   string ls_json_string = '{"name":"张三", "age":30, "hobbies":["阅读","游泳"]}'

2. 加载 JSON 字符串并解析： 使用 Parse() 方法加载 JSON 字符串，如果解析成功，Parse() 函数返回 1。

   long ll_ret
   ll_ret = lnvo_json_parser.of_Parse(ls_json_string)
   IF ll_ret <> 1 THEN
       // 解析失败，处理错误
       MessageBox("JSON 解析错误", lnvo_json_parser.of_GetError())
       DESTROY lnvo_json_parser
       RETURN
   END IF

3. 访问 JSON 数据： 解析成功后，可以通过 JSONParser 对象的方法和属性来访问数据，通常我们会将 JSON 数据转换为 PowerBuilder 的原生数据类型，如 Structure (结构体) 或 DataStore。

   • 转换为 Structure (适用于结构固定的 JSON)： 定义一个与 JSON 结构对应的 PB 结构体，针对上面的 JSON 字符串：

     // 在 PB 中定义结构体 s_employee_info
     // global type s_employee_info from structure
     //    string name
     //    long age
     //    string hobbies[]
     // end type

     使用 JSONParser 的 GetStructure() 方法：

     s_employee_info lstr_employee
     lstr_employee = lnvo_json_parser.GetStructure("s_employee_info")
     IF IsValid(lstr_employee) THEN
         MessageBox("解析成功", "姓名: " + lstr_employee.name + ", 年龄: " + String(lstr_employee.age))
         // 遍历 hobbies 数组
         FOR long i = 1 TO UpperBound(lstr_employee.hobbies)
             MessageBox("爱好", lstr_employee.hobbies[i])
         NEXT
     END IF

   • 访问嵌套对象和数组： 对于嵌套的 JSON 对象或数组，可以使用 GetJSONObject()、GetJSONArray() 等方法进行递归访问。

     // 假设 lnvo_json_parser 已解析包含 address 对象的 JSON
     n_cst_json_object lnvo_address_object
     lnvo_address_object = lnvo_json_parser.GetJSONObject("address")
     IF IsValid(lnvo_address_object) THEN
         string ls_city = lnvo_address_object.GetItemString("city")
         MessageBox("城市", ls_city)
     END IF
     // 访问数组
     n_cst_json_array lnvo_hobbies_array
     lnvo_hobbies_array = lnvo_json_parser.GetJSONArray("hobbies")
     IF IsValid(lnvo_hobbies_array) THEN
         FOR long i = 1 TO lnvo_hobbies_array.Length()
             string ls_hobby = lnvo_hobbies_array.GetItemString(i)
             // 处理每个爱好
         NEXT
     END IF

4. 释放对象： 使用完毕后，记得销毁创建的对象。

   DESTROY lnvo_json_parser

使用第三方 JSON 库

对于使用较旧版本 PB 的开发者，或者需要更高级 JSON 功能的场景，可以使用第三方 JSON 库，如 pbl_json (一个流行的开源 JSON 库 for PB)。

1. 获取并集成库：下载第三方 JSON 库，并将其中的 PBL 文件添加到你的 PB 应用库列表中。

2. 使用库中的对象：通常这些库会提供类似 JSONParser 和 JSONObject 的对象。

   // 假设使用 pbl_json 库
   // n_jsonobject lnvo_json_object
   // n_jsonparser lnvo_json_parser
   // lnvo_json_parser = CREATE n_jsonparser
   // lnvo_json_object = lnvo_json_parser.parse(ls_json_string)
   // 然后通过 lnvo_json_object 的方法获取数据
   // string ls_name = lnvo_json_object.getstring("name")
   // DESTROY lnvo_json_parser

   具体使用方法需参考所选第三方库的文档。

通过 .NET 互操作性 (适用于 PB 12.5 及以上版本)

如果你的 PB 版本支持 .NET 互操作性 (PB 12.5+，特别是 Classic 和 .NET 混合模式或 .NET Target)，可以利用强大的 .NET JSON 类 (如 Newtonsoft.Json 或 System.Text.Json)。

1. 添加 .NET 程集引用：在 PB 中，你需要引用包含 JSON 处理类的 .NET 程集 (如 Newtonsoft.Json.dll)。

2. 编写 PB 代码调用 .NET 方法：

   // 假设已引用 Newtonsoft.Json.dll
   // 声明 .NET 对象变量
   System.Object lnvo_dotnet_serializer
   System.Object lnvo_dotnet_jtoken
   // 创建 .NET 对象实例 (使用 CreateUsingKeywords)
   lnvo_dotnet_serializer = CreateUsingKeywords "Newtonsoft.Json.JsonSerializer"
   lnvo_dotnet_jtoken = CreateUsingKeywords "Newtonsoft.Json.Linq.JToken"
   // 调用 .NET 方法解析 JSON
   // 注意：这里只是示意，具体语法可能需要调整
   // lnvo_dotnet_jtoken = lnvo_dotnet_serializer.Parse(ls_json_string)
   // 然后通过 lnvo_dotnet_jtoken 的属性和方法访问数据
   // 释放 .NET 对象
   // Dispose(lnvo_dotnet_serializer)
   // Dispose(lnvo_dotnet_jtoken)

   这种方法功能强大,但需要对 .NET 和 PB 互操作有一定了解，且部署时需要包含相应的 .NET DLL。

最佳实践与注意事项

1. 版本兼容性：优先考虑使用 PB 内置 JSON 功能，这能更好地保证兼容性和性能，根据你的 PB 版本选择合适的方法。
2. 错误处理：JSON 解析过程中可能会因为格式错误等原因抛出异常，务必做好错误捕获和处理，避免程序崩溃。
3. 结构定义：当使用 GetStructure() 方法时，确保 PB 结构体与 JSON 结构严格匹配，特别是数据类型和字段名。
4. 性能考虑：对于大型 JSON 文件，解析和转换可能会消耗较多资源，评估性能需求，必要时考虑流式解析（如果第三方库支持）。
5. 安全性：处理来自不可信源的 JSON 数据时，要防范 JSON 注入等安全风险。
6. 文档与测试：对于复杂的 JSON 结构，建议先绘制其对应的数据结构图，并编写单元测试确保解析逻辑的正确性。

PowerBuilder 读取 JSON 数据已不再是难题，无论是使用 PB 2017 及更高版本提供的内置 JSONParser 对象，还是借助第三方库或 .NET 互操作性，开发者都能找到适合自己的解决方案，对于新项目或能够升级 PB 版本的开发者，强烈推荐使用内置 JSON 功能，它更简洁、高效且易于维护， JSON 处理能力，能让 PowerBuilder 应用更好地与现代 Web 服务和 API 进行集成，