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!!'!