Swift JSON转模型Xcode插件

SwiftJSONModeler是一个Xcode插件,一键转换json字符串为Swfit模型,一键转化 YApi 平台接口为模型,并且自动引入注释。

  • 支持struct, class
  • 支持单json转模, 多层嵌套 json
  • 支持YApi RAW或接口id解析转模,并且自动引入 YApi 平台注释和兼容数据类型
  • 支持自定义遵循 和 import
  • 支持自定义模型前缀和后缀
  • 可设置隐式和显示可选类型,默认显示可选?(不使用则为隐式可选!)
  • YApi 支持按照自定义路径解析模型,自动解析子类型

json 转Swfit模型

复制单json, 一步转为模型。
如果无法预览查看传输门或者Sources/example.gif

示例 json 数据:

{
	"title": "第一层 json",
	"stringValue": "字符串值",
	"intValue": 58,
	"doubleValue": 18.2,
	"nullValue": null,
	"boolValue": true,
	"subJson": {
		"title": "第二层 json",
		"stringValue": "字符串值"
	},
	"arrayValue1": [
		"value1",
		"value2",
		"value3"
	],
	"arrayValue2": [{
		"title": "数组包含子 json",
		"intValue": 12,
		"boolValue": false
	}]
}

Swift模型

///
struct HKModel: HandyJSON {
    
    var arrayValue2: [HKArrayValue2Model] = []
    
    var nullValue: NSNull?
    
    var intValue: Int?
    
    var arrayValue1: [String] = []
    
    var title: String?
    
    var stringValue: String?
    ///
    var subJson: HKSubJsonModel?
    
    var doubleValue: Double?
    
    var boolValue: Int?
}

///
struct HKArrayValue2Model: HandyJSON {
    
    var title: String?
    
    var boolValue: Int?
    
    var intValue: Int?
}

///
struct HKSubJsonModel: HandyJSON {
    
    var title: String?
    
    var stringValue: String?
}

支持多层嵌套 josn, 高亮提示 json 中 null类型, 类型自动判断。

YApi 接口平台转模支持

什么是 YApi,YApi 是一个可本地部署的、打通前后端及QA的、可视化的接口管理平台,github 地址

复制YApi接口RAW数据,一步解析带有注释的模型。
解析效果如下:
如果无法预览查看Source/YApiRAW.gif

如果你使用YApi接口平台,我们支持两种方式,通过接口 Id)和 Raw 数据转模。一键转为模型,并且自动根据YApi为模型引入注释。

通过Id转模

在配置了项目token和host基础下,简单复制Id即可实现转模和添加注释.

**如何查看YApi接口中的id?**在YApi对应的接口中,查看浏览器网址,最后的数字就是Id。如下图:

接口Id

具体配置参考下面设置部分。

RAW数据

RAW数据:即YApi接口平台提供的带有接口字段及注释的json数据,查看方式:选择接口 -> 编辑 -> 返回数据设置 -> RAW 如下图

Alt

示例RAW数据:

{"type":"object","title":"empty object","properties":{"message":{"type":"string"},"code":{"type":"string"},"response":{"type":"object","properties":{"teachers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","mock":{"mock":"Mrs Yang"},"description":"名字"},"subject":{"type":"string","mock":{"mock":"语文"},"description":"科目"},"phone":{"type":"string","mock":{"mock":"13459923098"},"description":"联系电话"}},"required":["name","subject","phone"]},"description":"老师"},"name":{"type":"string","description":"姓名"},"age":{"type":"integer","mock":{"mock":"18"},"description":"年龄"},"score":{"type":"number","mock":{"mock":"89.8"},"description":"综合成绩"},"likes":{"type":"array","items":{"type":"string","mock":{"mock":"英雄联盟"}},"description":"爱好"},"emergercyContact":{"type":"object","properties":{"name":{"type":"string"},"phone":{"type":"string","description":"联系电话"},"address":{"type":"string","description":"联系地址","mock":{"mock":"xx街道xx栋xx单元"}}},"description":"紧急联系人","required":["name","phone","address"]},"isBoy":{"type":"boolean","description":"是否为男孩"}},"required":["teachers","name","age","score","likes","emergercyContact","isBoy"]}},"required":["message","code","response"]}

完整示例可下载打开SwiftJSONModelerDemo查看

解析指定路径模型

如果你数据有多层json, 可以在设置中指定解析路线path来获取指定模型。比如我的目标数据在response字段下,则可以配置path为response.则直接解析response下的json模型。多路径使用 .

安装

1.你可以选择Release 直接下载应用安装

2.你也可以选择下载源代码编译为应用
下载项目工程,修改为自己的bundleId

运行主项目SwiftJSONModeler For Xcode

再运行SwiftJSONModeler

确保没有报错的情况下,选择Products下的运行主项目SwiftJSONModeler For Xcode.app点击右键, 选择show in finder如下图

再将应用移动到应用程序, 重启Xcode即可使用。

Tip:如果重启Xcode之后在Editor中还没看见插件选项,请选择系统设置-> 扩展->Xcode Source Editor中对应插件是否导入

设置

SwiftJSONModeler提供多种自定义可选设置,可通过插件的Config选项进行设置。

设置选项如下图:

showfinder.png

YApi模型路径指定:当对象含有多层json,或者有基本json包裹时,可以指定path解析模型。

YApi项目token: 每个YApi项目都有唯一一个token,在YApi项目接口的设置中可以查看对应的token,如下图:

token

YApi项目host:host就是部署YApi的地址

host

多 token配置

在开发中可能团队同时开发多个项目,就会存在多个token,可以通过配置,转模时切换 token

img

设置快捷键

可以给插件设置快捷键,快速转换模型

在Xcode -> Preference -> Key Bindings -> Editor Menu For Source Code【或者搜索】就可以找到,如下图

img

记得双击key下面那个区域才可以编辑,这里我使用的是alt + s 和alt + c 避免与系统的冲突

Xcode 插件制作

Creating a Source Editor Extension – Apple Document
Xcode - Source Editor Extension – 掘金
Xcode Source Editor Extentsion – nshipster
制作一个Mac APP:XcodeExtension – 掘金

Tips: 1. 插件功能选项请在插件 Taget 的Info.plist 文件中配置。
2. 运行插件后 Xcode 没有出现对应插件选项,请删除插件 Target 中的 Cocoa.framework 和 XcodeKit.framework后重新添加。

ESJsonFormat-XcodeJSON 格式化输出为模型的属性 写在之前的注意 JSON中的key对应的value为Null的话会格式化成NSString类型 格式化之前光标放在你需要添加属性的地方 RootClass需要自己手动创建,插件只负责RootClass里面的属性生成 生成的MJExtension 2.0框架中objectClassInArray方法(类方法) 怎么安装: 方式1:下载-Xcode打开-Command B-重启Xcode 方式2:通过Alcatraz安装,搜索ESJsonFormat 方式3:下载-解压plugin文件夹中zip到~/Library/Application Support/Developer/Shared/Xcode/Plug-ins-重启Xcode 怎么使用: Window-ESJsonFormat-输入Json-Enter OR 快捷键(Control Shift J)-输入JSON-Enter 功能说明: -0.1 通过JSON字符串生成对应属性 通过文件写入的方式生成到.m文件 支持输入嵌套模型名称 -0.2 支持Swift 修复JSON的value的值为Null的时候多出来的空行 修复BOOL类型值格式化失效问题 -0.3 支持生成MJExtension框架中objectClassInArray方法 修复数组嵌套多级,里面子数组不能格式化的Bug Alcatraz 支持 Alcatraz ,请搜索ESJsonFormat 效果: 简单模型 复杂模型 图中的JSON格式 {     "name": "王五",     "gender": "man",     "age": 15,     "height": "140cm", } {     "name": "王五",     "gender": "man",     "age": 15,     "height": "140cm",     "addr": {         "province": "fujian",         "city": "quanzhou",         "code": "300000" },     "hobby": [         {             "name": "billiards",             "code": "1" },         {             "name": "computerGame",             "code": "2" }     ]  } 计划实现: 将嵌套模型生成文件 其他: 如在使用过程中需要到问题,请你Issues我。 有什么好的想法也可以Issues我。 如果你半夜睡不着觉也可以Issues我。 Thanks:GsonFormat、VVDocumenter-Xcode、MJExtension 标签:ESJsonFormat
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值