将JSON数据结构自动转换为Smithy IDL模型定义,简化API设计与服务建模流程。
当您需要将现有JSON数据结构转换为规范的Smithy模型却苦于手动编写时,本工具可自动解析JSON样本并生成对应的Smithy形状定义。它通过类型推断将JSON对象映射为Smithy结构体(structure)、数组转为列表(list)、嵌套对象拆分为独立结构,并生成符合Smithy接口定义语言(IDL)规范的代码输出,有效降低API设计中的手动编码错误。
问:JSON中的空数组会被转换为什么Smithy类型?
答:空数组默认推断为String列表,建议手动调整具体类型。这是类型推断的常见限制。
问:能否生成Smithy特质(traits)如@required?
答:不支持。本工具专注于结构骨架生成,特质需手动添加。
请确认输入为合规JSON格式,复杂联合类型需人工校验。生成的模型不包含验证特质,敏感数据建议离线使用。
对于泛型数据建模,建议先用示例JSON覆盖所有字段变体。常见示例:输入{"status":1}输出status: Integer,而{"status":"active"}则输出status: String。Smithy推荐明确类型边界,避免泛用String类型。