1. 项目概述
在Delphi开发领域,JSON数据处理一直是高频需求场景。System.JSON作为Delphi内置的JSON处理单元,虽然功能完备但API设计偏底层,直接使用时常需要编写大量样板代码。这个开源库正是针对这一痛点,基于System.JSON进行二次封装,提供更符合直觉的链式调用接口。
我在实际项目中使用System.JSON处理复杂JSON结构时,经常遇到嵌套对象访问繁琐、类型转换冗长等问题。这个封装库通过精心设计的API层,将常见操作简化为单行代码,同时保持与原生单元的无缝兼容。特别适合需要频繁处理JSON数据的REST接口开发、配置文件解析等场景。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心设计解析
2.1 架构设计原则
该库采用门面模式(Facade Pattern)对System.JSON进行封装,主要实现三个目标:
- 保持原始功能完整性 - 所有System.JSON.TJSONObject/TJSONArray能力均可通过封装对象访问
- 简化高频操作 - 如路径查询、自动类型转换等
- 统一错误处理 - 提供带默认值的安全访问方法
典型使用对比:
delphi复制// 原生方式
if (jsonObj.GetValue('user') is TJSONObject) then
age := (jsonObj.GetValue('user') as TJSONObject).GetValue('age').Value;
// 封装后
age := JObject(jsonObj).Path['user.age'].AsInteger;
2.2 关键类设计
2.2.1 TJValueWrapper
基础包装类,提供类型安全访问方法:
delphi复制public
function AsString(const Default: string = ''): string;
function AsInteger(Default: Integer = 0): Integer;
function AsBoolean(Default: Boolean = False): Boolean;
// 其他基本类型...
end;
