1. 项目概述:为什么需要另一个Delphi JSON库?
在Delphi生态中,处理JSON数据一直是个既基础又令人头疼的问题。System.JSON单元作为官方解决方案虽然功能完整,但API设计过于底层,一个简单的对象属性访问就需要五六行代码。我在实际项目中见过太多这样的代码片段:
delphi复制var
LJSONValue: TJSONValue;
begin
LJSONValue := TJSONObject.ParseJSONValue('{"name":"John","age":30}');
if (LJSONValue is TJSONObject) then
begin
if TJSONObject(LJSONValue).GetValue('name') <> nil then
ShowMessage(TJSONObject(LJSONValue).GetValue('name').Value);
end;
LJSONValue.Free;
end;
这种写法存在三个明显问题:1) 类型检查冗长 2) 空值判断繁琐 3) 内存管理容易遗漏。我们的封装库就是要用更符合Delphi习惯的方式解决这些问题,最终实现这样的调用效果:
delphi复制with TSimpleJSON.Parse('{"name":"John","age":30}') do
try
ShowMessage(Item['name'].AsString);
finally
Free;
end;
1.1 目标用户场景分析
根据社区反馈,以下三类开发者最需要这样的封装:
- 移动应用开发者:需要频繁处理REST API返回的JSON数据
- 企业应用集成者:对接各种Web Service接口
- 快速原型开发者:需要简洁的数据序列化方案
特别是在Android/iOS跨平台开发中,约67%的API交互都采用JSON格式(根据DelphiPraxis论坛2023年调查数据),但System.JSON在移动端的性能表现并不理想,我们的封装会针对性优化。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心架构设计
2.1 类型系统封装策略
原始System.JSON的类型层级较深(TJSONValue→TJSONObject→TJSONPair等),我们将其简化为三层结构:
code复制TSimpleJSON (抽象基类)
├─ TSimpleJSONObject
├─ TSimpleJSONArray
└─ TSimpleJSONValue
关键改进点:
- 统一Value访问方式:通过AsString/AsInteger等属性自动处理类型转换
- 链式调用支持:
Get('user').Get('address').Get('city').AsString - 空安全设计:访问不存在的路径返回nil而非抛出异常
2.2 内存管理方案
采用"Owner模式"与"非Owner模式"双机制:
delphi复制// Owner模式(自动管理子树)
var
Root: TSimpleJSONObject;
begin
Root := TSim
