Dart Model Maker:从 JSON 生成 Dart 模型

记录 2024 年版模型生成工具的输入、类型选项、代码预览与文件导出,说明文件覆盖和字段类型的区别。

适用版本

记录 2024 年 12 月版 Dart Model Maker 的界面与操作。

本文目录
  1. 界面与输入
  2. 生成选项
  3. 预览与导出
  4. 旧版数据处理说明
  5. 项目来源

Dart Model Maker 把 JSON 样本转换成 Dart 模型类,提供代码预览、类型选项和文件导出。这里记录的是 2024 年 12 月版的操作方式,适合回看这个小工具的设计和使用流程。

界面与输入

Dart Model Maker 2024 年版主界面,左侧为文件名、模型根名和 JSON 输入,右侧为生成选项与代码预览

左侧三个输入区分别承担不同的工作。

输入项用途
文件名决定导出的 Dart 文件名称,与模型类名分别设置。
Model 根名用于生成根模型的类名,以及相关嵌套模型的命名。
JSON 报文填入需要转换的 JSON;这个版本要求最外层为对象,对应 Dart 的 Map。

例如,文件名可以设为 user_profile,Model 根名设为 UserProfile。两者分别面向文件组织和代码中的类型命名,填写时无需保持完全相同。

生成选项

右侧的四个开关控制文件保存和代码生成。

选项启用后的行为
允许文件覆盖控制目标目录已有同名文件时是否允许覆盖。它属于文件保存设置。
启用类型全 String按旧版说明,将 List、Map 之外的字段按 String 类型生成;关闭时根据输入样本推断类型。
final 修饰词为字段添加 final,例如 final String? id。关闭后不添加该修饰词。
ToJson 功能生成把模型转回 Map/JSON 的相关方法。

「允许文件覆盖」和「启用类型全 String」分别影响保存行为与字段类型。作者仓库对同名文件覆盖控制有独立说明。Dart Model Maker 项目

预览与导出

  1. 填写文件名和 Model 根名,粘贴完整的 JSON 对象。
  2. 根据接口字段的使用方式设置类型、final 和 ToJson 选项。
  3. 点击「生成预览」,右下方显示生成的 Dart 代码。旧版支持长按该按钮复制代码。
  4. 点击「生成 Model 文件」,在弹出的窗口选择输出目录,按输入的文件名保存。

模型生成依赖输入样本。样本中缺少的字段、只有空数组的列表,以及一直为 null 的值,都不足以说明完整的接口类型。作者的早期更新记录专门处理过空 List 和 Null 值;把生成结果接入项目时,仍需结合接口约定补全这些情况。项目更新记录

旧版数据处理说明

2024 年 12 月 8 日随应用发布的说明将 JSON 转换与文件生成描述为设备本地处理,文件路径用于读取和保存。该说明适用于当时的 Dart Model Maker 应用;网站及其他软件的数据处理规则,以各自的隐私说明为准。

项目来源

作者:NeverOuO。原使用说明发表于 2024 年 12 月 8 日。

查看 Dart Model Maker 源码

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。