跳转到正文

JSON 转 Swift

根据 JSON 示例生成遵循 Codable 的 Swift 结构体。属性名称会转换为 camelCase;键名不同时会生成 CodingKeys 枚举;可选值和可空值会转换为可选类型;混合类型的值会使用工具添加到输出中的小型 JSONValue 枚举。使用 JSONDecoder 解码结果。

重置

常见问题

嵌套对象如何命名?

每个嵌套对象都会成为独立的 Swift 类型,类型名称取自其所在键并采用 PascalCase,例如 address 会变成 Address。数组中的对象使用数组键的单数形式命名,例如 users 会变成 User。字段完全相同的对象会共用一个类型。

字段在什么情况下会是可选的?

如果数组包含多个对象,且某个键在部分对象中缺失,则该字段为可选字段:其类型会变为可选类型,Codable 在键缺失时会将其解码为 nil。每个示例中都存在的键为必填键。单个对象没有可供比较的对象,因此其所有键都是必填键。

如何处理 null 值?

如果某个键在部分示例中为 null、在其他示例中有值,则该键会变为可选类型,例如 String?。如果某个键始终为 null,工具就无法据此判断其实际类型,因此会将其设为 JSONValue?;粘贴包含实际值的示例即可获得准确类型。

会使用哪些数字类型?

整数会变为 Int,带小数的数字会变为 Double。同时包含这两种数字的字段会变为 Double。

如何处理无效名称的键?

属性名称会转换为 camelCase。如果至少有一个名称与其键名不同,结构体就会包含一个 CodingKeys 枚举,将每个属性映射到对应的 JSON 键。对于 default 等 Swift 关键字,名称会用反引号括起来。

我的 JSON 会被上传或存储吗?

JSON 仅会发送到服务器以便为此次请求生成代码,不会被存储。生成器只会读取示例的结构和值类型,因此你可以在粘贴前将敏感值替换为类型相同的占位值。

关于 OneClick Pro

OneClick Pro 是一个免费的工具集合,包含超过 150 种网络工具,助你处理日常工作:转换图像和单位、格式化和验证代码、检查域名和 SEO,以及处理文本、日期和数字。所有工具均可免注册、免订阅使用;你输入的内容仅用于计算结果,绝不会被存储。你可以将它用作处理临时任务的快捷工具箱,也可以收藏每天都会用到的工具。