HimotokiA"type'safe"JSON"decoding"library

@ikesyo

関西モバイルアプリ研究会!#2,!2015(05(20!Wed

#関モバ

@ikesyo

いけしょー／池田翔京都でフリーランスのiOSエンジニア(時々Android)しています

現在はフリュー㈱のモバイル開発のチームにジョイン中。

Swi$もReac)veCocoaも使ってます。

Reac%veCocoaのコミッター(Contributor)やってます

閑話休題

Swi$でJSON(=>(オブジェクトのマッピングってどうしてますか？

前回

Objec&ve(C時代の定番*=>*Mantle

ObjectMapper

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との相性が悪い

もっとタイプセーフなJSONマッパーを

ということで作りました

Himotoki（紐解き）

Himotoki• h#ps://github.com/ikesyo/Himotoki

• ObjectMapperとは違い、JSONのデコード（デシリアライズ）のみに特化

• Argo>(h#ps://github.com/thoughtbot/Argo)>と同じ方向性

• Argoよりもより簡潔にモデル定義が行えるように

• 外部依存なし（今のところは）

Himotoki• プロトコルベースのAPI

• 継承の必要なし

• class%も%struct%も使える。

• let%なプロパティのモデルも安全に扱える。

• 必要なJSONの要素が%nil%であればその時点でデコードを失敗させられる。

• 型推論による簡潔なモデル定義

• Argoのようなカリー化した%create()%メソッドは不要。

Decodable

public protocol Decodable { typealias DecodedType = Self static func decode(e: Extractor) -> DecodedType?}

サンプルコード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) }}

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" }}

サンプルコード

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)}

Operators

演算子は以下の6種類 // 以下 T: Decodable <| // T <|? // T? <|| // [T] <||? // [T]? <|-| // [String: T] <|-|? // [String: T]?

Himotoki'0.2'is'released'today!

Welcome'your'contribu/ons!!'!