identifier <-- json["id"]
name <-- json["name"]
stats <-- json["stats"]
因为在 Swift 中解析 JSON 充满了不必要的 if lets, 显而易见的类型转换和 nil 检查
一定有更好的方法
Arrow 是 freshOS iOS 工具集的一部分。 在示例应用程序中尝试它！ 下载 Starter Project
通过使用一个简单的箭头运算符，来处理那些样板代码。
Json 映射代码变得简洁和易于维护 ❤️
- 推断类型
- 让你的模型保持简洁
- 处理自定义 & 嵌套模型
- 点和数组语法
- 纯 Swift, 简单 & 轻量级
struct Profile {
var identifier = 0
var name = ""
var link:NSURL?
var weekday:WeekDay = .Monday
var stats = Stats()
var phoneNumbers = [PhoneNumber]()
}
{
"id": 15678,
"name": "John Doe",
"link": "https://apple.com/steve",
"weekdayInt" : 3,
"stats": {
"numberOfFriends": 163,
"numberOfFans": 10987
},
"phoneNumbers": [{
"label": "house",
"number": "9809876545"
}, {
"label": "cell",
"number": "0908070656"
}, {
"label": "work",
"number": "0916570656"
}]
}
var profile = Profile()
// Int
if let id = json["id"] as? Int {
profile.identifier = id
}
// String
if let name = json["name"] as? String {
profile.name = name
}
// NSURL
if let link = json["link"] as? String, url = NSURL(string:link) {
profile.link = link
}
// Enum
if let weekdayInt = json["weekdayInt"] as? Int, weekday = WeekDay(rawValue:weekdayInt) {
profile.weekday = weekday
}
// Custom nested object
if let statsJson = json["stats"] as? AnyObject {
if let numberOfFans = statsJson["numberOfFans"] as? Int {
profile.stats.numberOfFans = numberOfFans
}
if let numberOfFriends = statsJson["numberOfFriends"] as? Int {
profile.stats.numberOfFriends = numberOfFriends
}
}
// Array of custom nested object
if let pns = json["phoneNumbers"] as? [AnyObject] {
for pn in pns {
phoneNumbers.append(PhoneNumber(json: pn))
}
}
extension Profile:ArrowParsable {
mutating func deserialize(_ json: JSON) {
identifier <-- json["id"]
link <-- json["link"]
name <-- json["name"]
weekday <-- json["weekdayInt"]
stats <- json["stats"]
phoneNumbers <-- json["phoneNumbers"]
}
}
let profile = Profile()
profile.deserialize(json)
Swift Package Manager (SPM) 现在是安装 Arrow 的官方方式。 其他包管理器从 5.1.2 版本开始已被弃用，并且在未来的版本中将不再支持。
Xcode > File > Swift Packages > Add Package Dependency... > 粘贴 https://github.com/freshOS/Arrow
github "freshOS/Arrow"
target 'MyApp'
pod 'Arrow'
use_frameworks!
注意，之前我们输入了
stats <-- json["stats"]
那是因为我们创建了一个扩展 "Stats+Arrow.swift" ，使我们能够使用 Arrow 运算符
// Stats+Arrow.swift
import Foundation
extension Stats:ArrowParsable {
mutating func deserialize(json: JSON) {
numberOfFriends <-- json["numberOfFriends"]
numberOfFans <-- json["numberOfFans"]
}
}
- 我必须对我的子模型使用 <-- 吗？
- 不，如果你想，你可以这样写
stats.numberOfFriends <-- json["stats.numberOfFriends"]
stats.numberOfFans <-- json["stats.numberOfFans"]
// Configure Global Date Parsing with one of those
Arrow.setDateFormat("yyyy-MM-dd'T'HH:mm:ssZZZZZ")
Arrow.setUseTimeIntervalSinceReferenceDate(true)
Arrow.setDateFormatter(aDateFormatter)
// Then later dates can be parsed form custom date format or timestamps automatically 🎉
let json:JSON = JSON(["date": "2013-06-07T16:38:40+02:00", "timestamp": 392308720])
date1 <-- json["date"]
date2 <-- json["timestamp"]
createdAt <-- json["created_at"]?.dateFormat("yyyy-MM-dd'T'HH:mm:ssZZZZZ")
createdAt <-- json["created_at"]?.dateFormatter(aCustomDateFormatter)
只需在个别情况下提供即可！🎉
value <-- json["nested.nested.nested.nestedValue"]
value <-- json[12]
value <-- json[1]?["someKey"]?[2]?["something.other"]
if let collection = json.collection {
for jsonEntry in collection {
//Do something
}
}
- Swift 2 -> 版本 2.0.3
- Swift 3 -> 版本 3.0.5
- Swift 4 -> 版本 4.0.0
- Swift 4.1 -> 版本 4.1.0
- Swift 4.2 -> 版本 4.2.0
- Swift 5.0 -> 版本 5.0.0
- Swift 5.1 -> 版本 5.1.0
- Swift 5.1.3 -> 版本 5.1.1
- Swift 5.3 -> 版本 6.0.0
如果没有 YannickDot, Damien-nd 和 maxkonovalov，这一切都不会存在
喜欢这个项目吗？ 请提供咖啡或每月捐款来支持我们，并帮助我们继续我们的活动：)
成为赞助商，并在我们的 Github README 上获得带有指向您的网站链接的徽标:)
