υΩϡϝϯτΈ͍ͨͳ API Client ΛٻΊͯ 2015/06/20 ԣ඿΁ͳͪΐ͜iOS #20 @dealforest Toshihiro Morimoto

ࣗݾ঺հ

Crying DFTDebugScreenshot cocoapods-browser Tuna

https://github.com/dealforest/Tuna

by AlcatrazTour

ܦҢ

ܦҢ

·ͩಀ͛ΕΔ…

ܦҢ

Φϫλ/(^o^)\

ͱ͍͏Θ͚ͰLT͢Δ͜ͱʹͳΓ·ͨ͠

஫ҙ ͜ΕΑΓઌ͸ࢲݟͰຬͪᷓΕ͍ͯΔͷͰɹ ͦΕΛ౿·্͑ͨͰฉ͍ͯ௖͚Δͱ޾͍Ͱ ͢

API Client ࢙ 1. UIKitظ (NSURLConnection, NSURLSession ౳) 2. ϥΠϒϥϦظ (AFNetwork, Alamofire ౳) 3. UIKit + αظ (؆୯ͳ Wrapper Λࣗ෼Ͱॻ͘)

࠷௿ݶͳχʔζ • ௨৴ϨΠϠʔΛू໿Խ͍ͨ͠ • Object Mapping ͸΄͍͠ • υΩϡϝϯτΛॻ͔ͣʹɺ͍͔ʹυΩϡ ϝϯτͬΆ͘͢Δ͔

͍͔ʹυΩϡϝϯτͬΆ͘͢Δ͔

Why document?

Կ౓΋ API Client Λ࢖͖ͬͯ·͕ͨ͠ ਺िؒ΋ͨͭͱ API ࢓༷͕ هԱͷ൴ํʹ๨٫ͯ͠͠·͍·͢

͞Θ͍ͬͯͳ͍ͱಛʹૣ͍Ͱ͢ΑͶ

ͦ͏ͳͬͨ৔߹ɺͲΕ͚ͩஸೡʹ ίʔυΛॻ͍ͨͱͯ͠΋ API ͷ ࢓༷·Ͱ͸Θ͔Βͳ͍Ͱ͠ΐ͏

ͳͷͰ࣮ࡍʹϦϑΝϨϯεΛΈͨΓ API Λୟ͍ͨΓ ςετίʔυͰ֬ೝͨ͠Γ ͳͲͳͲ

ͦΜͳ࣌ͱ͋ΔൃදΛΈͯ ײಈ͠·ͨ͠

https://speakerdeck.com/ishkawa/introducing-apikit

ίʔυ͕ͦͷ·· υΩϡϝϯτͬΆ͘ಡΊΔͷͰ͢

Ωʔʹͳͬͯ͘Δͷ͕ “Swift is a type safe language”

ͦͯ͠ ϥΠϒϥϦظ ;ͨͨͼʂʂʂ

APIKit + Himotoki

APIKit https://github.com/ishkawa/APIKit

APIKit Λ API ͷ υΩϡϝϯτͱͯ͠࢖͏

https://speakerdeck.com/ishkawa/introducing-apikit

GitHub serach ͷ API ͷ৔߹

ར༻͢Δํ

// https://api.github.com/search/repositories let request = GitHub.Endpoint.SearchRepositories( query: "APIKit", sort: .Stars, order: .Asceding ) GitHub.sendRequest(request) { response in switch response { case .Success(let box): self.repositories = box.unbox case .Fail println(box.value) } }

// https://api.github.com/search/repositories let request = GitHub.Endpoint.SearchRepositories( query: "APIKit", sort: .Stars, order: .Asceding ) GitHub.sendRequest(request) { response in switch response { case .Success(let box): self.repositories = box.unbox case .Fail println(box.value) } } DBTF CPYWBMVF 4VDDFTT 3FTQPOTF ϦΫΤετ ੒ޭ 'BJMVSF /4&SSPS ϦΫΤετ ࣦഊ

࣮૷

class GitHub: API { override class var baseURL: NSURL { return NSURL(string: "https://api.github.com")! } class Endpoint { // https://developer.github.com/v3/search/#search-repositories class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] ... class func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } } }

class GitHub: API { override class var baseURL: NSURL { return NSURL(string: "https://api.github.com")! } class Endpoint { // https://developer.github.com/v3/search/#search-repositories class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] ... class func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } } }

class Endpoint { class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] let query: String let sort: Sort let order: Order var URLRequest: NSURLRequest? { return GitHub.URLRequest( method: .GET, path: "/search/repositories", parameters: ["q": query, "sort": sort.rawValue, "order": order.rawValue] ) } init(query: String, sort: Sort = .Stars, order: Order = .Ascending) { self.query = query self.sort = sort self.order = order } func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } }

class Endpoint { class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] let query: String let sort: Sort let order: Order var URLRequest: NSURLRequest? { return GitHub.URLRequest( method: .GET, path: "/search/repositories", parameters: ["q": query, "sort": sort.rawValue, "order": order.rawValue] ) } init(query: String, sort: Sort = .Stars, order: Order = .Ascending) { self.query = query self.sort = sort self.order = order } func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } } initializer Object Mapping

class Endpoint { class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] let query: String let sort: Sort let order: Order var URLRequest: NSURLRequest? { return GitHub.URLRequest( method: .GET, path: "/search/repositories", parameters: ["q": query, "sort": sort.rawValue, "order": order.rawValue] ) } init(query: String, sort: Sort = .Stars, order: Order = .Ascending) { self.query = query self.sort = sort self.order = order } func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } } ΤϯυϙΠϯτͷ৘ใ

·ΔͰυΩϡϝϯτΛ ॻ͖͔ࣸͨ͠ͷΑ͏ͳఆٛ

ΤϯυϙΠϯτͷఆٛΛ ͜ͷΫϥεʹू໿ԽͰ͖Δ

ͨͩ਺͕૿͑ͯ͘Δͱ initializer, object mapper ͕ अຐʹͳͬͯ͘Δ

class Endpoint { class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] let query: String let sort: Sort let order: Order var URLRequest: NSURLRequest? { return GitHub.URLRequest( method: .GET, path: "/search/repositories", parameters: ["q": query, "sort": sort.rawValue, "order": order.rawValue] ) } init(query: String, sort: Sort = .Stars, order: Order = .Ascending) { self.query = query self.sort = sort self.order = order } func responseFromObject(object: AnyObject) -> Response? { var repositories = [Repository]() if let dictionaries = object["items"] as? [NSDictionary] { for dictionary in dictionaries { if let repository = Repository(dictionary: dictionary) { repositories.append(repository) } } } return repositories } } } initializer Object Mapping

class Endpoint { class SearchRepositories: APIKit.Request { enum Sort: String { case Stars = "stars" case Forks = "forks" case Updated = "updated" } enum Order: String { case Ascending = "asc" case Descending = "desc" } typealias Response = [Repository] let query: String let sort: Sort let order: Order var URLRequest: NSURLRequest? { return GitHub.URLRequest( method: .GET, path: "/search/repositories", parameters: ["q": query, "sort": sort.rawValue, "order": order.rawValue] ) } init(query: String, sort: Sort = .Stars, order: Order = .Ascending) { self.query = query self.sort = sort self.order = order } class func responseFromObject(object: AnyObject) -> Response? { return object["items"].flatMap(decode) ?? [] } } } Using Himotoki

Awesome!!!!

Himotoki ͷ͓͔͛Ͱ ΑΓυΩϡϝϯτͱͯ͠ Έ΍͘͢ͳΓ·͢Ͷ

Himotoki https://github.com/ikesyo/Himotoki

Himotoki Λ API Ϩεϙϯεͷ υΩϡϝϯτͱͯ͠࢖͏

http://www.slideshare.net/syoikeda/himotoki-a-typesafe-json-decoding-library

Usage struct User: Decodable { let id: Int let login: String let avatar_url: String static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", e <| "avatar_url" ).map(create) } }

Operators <| // T <|? // T? <|| // [T] <||? // [T]? <|-| // [String: T] <|-|? // [String: T]?

tips • SnakeCase → CamelCase • ܕม׵ • ܕม׵ (Enum) • σʔλ֊૚͕ਂ͍৔߹

SnakeCase → CamelCase struct User: Decodable { let id: Int let login: String let avatar_url: String static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", e <| "avatar_url" ).map(create) } }

SnakeCase → CamelCase struct User: Decodable { let id: Int let login: String let avatarURL: String static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", e <| "avatar_url" ).map(create) } }

ܕ͑͞Ұக͍ͯ͠Ε͹ ໊લ͸ͳΜͰ΋͍͍

ܕม׵ struct User: Decodable { let id: Int let login: String let avatarURL: String static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", e <| "avatar_url" ).map(create) } }

ܕม׵ struct User: Decodable { let id: Int let login: String let avatarURL: NSURL static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", (e <| "avatar_url").flatMap { NSURL(string: $0) } ).map(create) } }

ܕม׵ (Enum) struct User: Decodable { enum Type: String { case User = "User" case Organization = "Organization" } let id: Int let login: String let type: Type let avatarURL: NSURL static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", (e <| "type").flatMap { Type(rawValue: $0) }, e <| "avatar_url").flatMap { NSURL(string: $0) } ).map(create) }

σʔλ֊૚͕ਂ͍৔߹ repositories = [ { "id": 3081286, "name": "Tetris", "owner": { "login": "dtrupenn", "id": 872147, "avatar_url": "https://secure.gravatar.com/...", "type": "User" }, ... } ]

σʔλ֊૚͕ਂ͍৔߹ struct Repository: Decodable { let id: Int let name: String let owner: User static func decode(e: Extractor) -> Repository? { let create = { Repository($0) } return build( e <| "id", e <| "name", e <| "owner" ).map(create) } } struct User: Decodable { let id: Int let login: String let avatarURL: NSURL static func decode(e: Extractor) -> User? { let create = { User($0) } return build( e <| "id", e <| "login", (e <| "avatar_url").flatMap { NSURL(string: $0) } ).map(create) } }

σʔλ֊૚͕ਂ͍৔߹ struct Repository: Decodable { let id: Int let name: String let ownerId: Int static func decode(e: Extractor) -> Repository? { let create = { Repository($0) } return build( e <| "id", e <| “name", e <| [“owner”, “id”], ).map(create) } }

ͨ·ʹมͳఆٛΛ͢Δͱ ܕਪ࿦͕ղܾͰ͖ͣʹ ϑΝϯ͕ᄬΓΛ্͛ͨ͋ͱtimeout తͳ ΤϥʔͰίϯύΠϧʹࣦഊ͢Δ

ͭ·Γ͸ϑΝϯ͕ᄬΓΛ͋͛͸͡ΊΔͱ ࣗ෼͕มͳఆٛΛ͍ͯ͠ΔՄೳੑ͕ߴ͍ͷͰ ଈࠁݟͳ͓ͨ͠ํ͕͍͍Ͱ͢

͓͢͢Ί • Object Mapping ͷఆ͚ٛͩΛ୯ҰϑΝΠϧʹͯ͠ఆٛ͠ ͓͚ͯ͹ݟ΍͘͢ͳΔ • extension Ͱ logic Λఆٛ͢Ε͹σʔλͱৼΔ෣͍͕Θ ͔ΕͯΘ͔Γ΍͍͢ • ctrl + 6 ͨ͠Βͪΐͬͱײಈ͢Δ • ؆୯ͳ΋ͷͰ͍͍͔Βςετ͸ॻ͍ͱ͍ͨํ͕͍͍ • Կ͔ͷมߋͰ decode ʹࣦഊͨ͠ࡍʹݕ஌Ͱ͖ΔͨΊ • stub Λߋ৽͢ΔεΫϦϓτͱ͔͋Ε͹ϝϯς͸͔ͲΔ

·ͱΊ APIKit + Himotoki Λ࢖͑͹ݟࣄʹϦϑΝϨ ϯεͬΆ͘ͳΓ·͢Ͷ ͔ͬ͠ΓϨΠϠʔ΋෼͚ΕΔͷͰอक͠΍ ͍͢ίʔυʹͳΓ·͢

·ͱΊ શͯΛ͜ΕͰ΍Ε͹͍͍ͱ͍͏Θ͚Ͱͳ͘ ࣗࣾαʔϏεͷAPIͷ৔߹ͳͲϦϑΝϨϯε ·Ͱ༻ҙͯ͠ΔέʔεͳͲ΄΅ͳ͍ͷͰɺ গ͕࣌ؒ͋͘͠ͱ๨͕ͪʹͳͬͯ͠·͏ͷ Ͱͦ͏͍͏࣌ʹศརͰ͢Ͷ ͜͏͍͏Ξϓϩʔν΋͋Γ͔ͳͱࢥ͏࣍ୈ Ͱ͢

͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠