Himotoki: A type-safe JSON decoding library #関モバ
12 likes5,015 views
関西モバイルアプリ研究会 #2での発表スライドです。
![ObjectMapperもいいけど……
• オプショナルな"var"を使うのがいけてない
class User: Mappable {
var username: String?
var age: Int?
var array: [AnyObject]?
var group: Gruop? // 別の`Mappable`な型
required init?(_ map: Map) {
mapping(map)
}
func mapping(map: Map) {
username <- map["username"]
age <- map["age"]
array <- map["array"]
group <- map["group"]
}
}
class Group: Mappable { ... }
• inoutパラメータでRealmとの相性が悪い](https://image.slidesharecdn.com/kanmobahimotoki-150520105232-lva1-app6892/85/Himotoki-A-type-safe-JSON-decoding-library-9-320.jpg)
![サンプルコード
struct Group: Decodable {
let name: String
let floor: Int
let optional: [String]?
// MARK: Decodable
static func decode(e: Extractor) -> Group? {
// 関数（クロージャ）としてのイニシャライザ
// `let create: ((name: String, floor: Int, optional: [String]?)) -> Group` と推論される。
let create = { Group($0) }
// リスト全体がオプショナルの引数リストを生成する（22引数まで対応）。
// 途中で非オプショナルな引数に対して `nil` が出てきたら引数リストが `nil` になる。
// その引数リスト全体を `Optional.map()` に渡す。
// この場合 `build(a: String?, b: Int?, c: [String]??) -> (String, Int, [String]?)?` と推論される。
return build(
e <| "name",
e <| "floor",
e <||? "optional"
).map(create)
}
}](https://image.slidesharecdn.com/kanmobahimotoki-150520105232-lva1-app6892/85/Himotoki-A-type-safe-JSON-decoding-library-17-320.jpg)
![Argoだと
struct Group: Decodable {
let name: String
let floor: Int
let optional: [String]?
static func create(name: String)(floor: Int)(optional: [String]?) -> Group {
return Gruop(name: name, floor: floor, optional: optional)
}
// MARK: Decodable
static func decode(j: JSON) -> Decoded<User> {
return Gruop.create
<^> j <| "name"
<*> j <| "floor"
<*> j <||? "optional"
}
}](https://image.slidesharecdn.com/kanmobahimotoki-150520105232-lva1-app6892/85/Himotoki-A-type-safe-JSON-decoding-library-18-320.jpg)
![サンプルコード
func testGroup() {
var JSON: [String: AnyObject] = [ "name": "Himotoki", "floor": 12 ]
let g: Group? = decode(JSON)
XCTAssert(g != nil)
XCTAssert(g?.name == "Himotoki")
XCTAssert(g?.floor == 12)
XCTAssert(g?.optional == nil)
JSON["name"] = nil
let f: Group? = decode(JSON)
XCTAssert(f == nil)
}](https://image.slidesharecdn.com/kanmobahimotoki-150520105232-lva1-app6892/85/Himotoki-A-type-safe-JSON-decoding-library-19-320.jpg)
![Operators
演算子は以下の6種類
// 以下 T: Decodable
<| // T
<|? // T?
<|| // [T]
<||? // [T]?
<|-| // [String: T]
<|-|? // [String: T]?](https://image.slidesharecdn.com/kanmobahimotoki-150520105232-lva1-app6892/85/Himotoki-A-type-safe-JSON-decoding-library-20-320.jpg)
Himotoki: A type-safe JSON decoding library #関モバ
- 5. 閑話休題
- 9. ObjectMapperもいいけど…… • オプショナルな"var"を使うのがいけてない class User: Mappable { var username: String? var age: Int? var array: [AnyObject]? var group: Gruop? // 別の`Mappable`な型 required init?(_ map: Map) { mapping(map) } func mapping(map: Map) { username <- map["username"] age <- map["age"] array <- map["array"] group <- map["group"] } } class Group: Mappable { ... } • inoutパラメータでRealmとの相性が悪い
- 11. ということで作りました
- 12. Himotoki（紐解き）
- 14. Himotoki • h#ps://github.com/ikesyo/Himotoki • ObjectMapperとは違い、JSONのデコード（デシリアライズ） のみに特化 • Argo>(h#ps://github.com/thoughtbot/Argo)>と同じ方向性 • Argoよりもより簡潔にモデル定義が行えるように • 外部依存なし（今のところは）
- 15. Himotoki • プロトコルベースのAPI • 継承の必要なし • class%も%struct%も使える。 • let%なプロパティのモデルも安全に扱える。 • 必要なJSONの要素が%nil%であればその時点でデコードを失敗させられる。 • 型推論による簡潔なモデル定義 • Argoのようなカリー化した%create()%メソッドは不要。
- 16. Decodable public protocol Decodable { typealias DecodedType = Self static func decode(e: Extractor) -> DecodedType? }
- 17. サンプルコード struct Group: Decodable { let name: String let floor: Int let optional: [String]? // MARK: Decodable static func decode(e: Extractor) -> Group? { // 関数（クロージャ）としてのイニシャライザ // `let create: ((name: String, floor: Int, optional: [String]?)) -> Group` と推論される。 let create = { Group($0) } // リスト全体がオプショナルの引数リストを生成する（22引数まで対応）。 // 途中で非オプショナルな引数に対して `nil` が出てきたら引数リストが `nil` になる。 // その引数リスト全体を `Optional.map()` に渡す。 // この場合 `build(a: String?, b: Int?, c: [String]??) -> (String, Int, [String]?)?` と推論される。 return build( e <| "name", e <| "floor", e <||? "optional" ).map(create) } }
- 18. Argoだと struct Group: Decodable { let name: String let floor: Int let optional: [String]? static func create(name: String)(floor: Int)(optional: [String]?) -> Group { return Gruop(name: name, floor: floor, optional: optional) } // MARK: Decodable static func decode(j: JSON) -> Decoded<User> { return Gruop.create <^> j <| "name" <*> j <| "floor" <*> j <||? "optional" } }
- 19. サンプルコード func testGroup() { var JSON: [String: AnyObject] = [ "name": "Himotoki", "floor": 12 ] let g: Group? = decode(JSON) XCTAssert(g != nil) XCTAssert(g?.name == "Himotoki") XCTAssert(g?.floor == 12) XCTAssert(g?.optional == nil) JSON["name"] = nil let f: Group? = decode(JSON) XCTAssert(f == nil) }
- 20. Operators 演算子は以下の6種類 // 以下 T: Decodable <| // T <|? // T? <|| // [T] <||? // [T]? <|-| // [String: T] <|-|? // [String: T]?