Slide 1
Slide 1 text
Swagger-codegen͔Β
ோΊΔSwift4
Daiki Matsudate / @d_date
2017/11/28 potatotips
Slide 2
Slide 2 text
Daiki Matsudate
iOS Mobile App Engineer
@d_date
Slide 3
Slide 3 text
No content
Slide 4
Slide 4 text
No content
Slide 5
Slide 5 text
No content
Slide 6
Slide 6 text
No content
Slide 7
Slide 7 text
No content
Slide 8
Slide 8 text
͓Βͤ
Slide 9
Slide 9 text
No content
Slide 10
Slide 10 text
https://firebase.asia/
Slide 11
Slide 11 text
͓Βͤᶄ
Slide 12
Slide 12 text
Tokyo
2018/3/1 - 3
Slide 13
Slide 13 text
͓Βͤᶅ
Slide 14
Slide 14 text
No content
Slide 15
Slide 15 text
͓Βͤᶆ
Slide 16
Slide 16 text
No content
Slide 17
Slide 17 text
͓Βͤᶇ
Slide 18
Slide 18 text
No content
Slide 19
Slide 19 text
No content
Slide 20
Slide 20 text
͔͜͜Βຊฤ
Slide 21
Slide 21 text
No content
Slide 22
Slide 22 text
• APIͷ༷ΛYAMLͰཧ (OpenAPI2.0)
• αʔόʔαΠυ / ΫϥΠΞϯταΠυͷίʔυੜ͕Մೳ
• MockͨͯΒΕΔ
Slide 23
Slide 23 text
https://github.com/swagger-api/
swagger-codegen
Slide 24
Slide 24 text
SwaggerͰ࢝ΊΔAPIఆٛཧͱ
ίʔυδΣωϨʔτ
ɹ
iOSDC 2017
2017/09/15@ૣҴాେֶཧֶ෦ૣҴాΩϟϯύε 63߸ؗ
Yohei Suginami ( @susieyy )
https://speakerdeck.com/susieyy/swaggerdeshi-meruapiding-yi-guan-li-tokodozienereto
Slide 25
Slide 25 text
swagger-api / swagger-codegen
swagger.yaml
swagger-codegen -l swift4 -i swagger.yaml
Slide 26
Slide 26 text
Swagger Automation
API.framework
carthage build —-no-skip-current
carthage archive
Slide 27
Slide 27 text
Swagger Codegen Swi!ͷରԠঢ়گ
— Swift4ʹઈࢍରԠத
— JSONͷύʔεCodableͰ࣮
— OptionalͷఆٛʹରԠ
— EnumରԠ
— API Client෦Alamofire͕ϕʔε
— CocoaPodsͷϥΠϒϥϦͱͯ͠ग़ྗͰ͖Δ
— RxSwiftͱ࿈ܞՄೳʢ Ϩεϙϯε͕ObservableʹͳΔ ʣ
https://speakerdeck.com/susieyy/swaggerdeshi-meruapiding-yi-guan-li-tokodozienereto?slide=17
Slide 28
Slide 28 text
Swagger Codegen Swi!ͷରԠঢ়گ
— Swift4ʹઈࢍରԠத
— JSONͷύʔεCodableͰ࣮
— OptionalͷఆٛʹରԠ
— EnumରԠ
— API Client෦Alamofire͕ϕʔε
— CocoaPodsͷϥΠϒϥϦͱͯ͠ग़ྗͰ͖Δ
— RxSwiftͱ࿈ܞՄೳʢ Ϩεϙϯε͕ObservableʹͳΔ ʣ
https://speakerdeck.com/susieyy/swaggerdeshi-meruapiding-yi-guan-li-tokodozienereto?slide=17
Slide 29
Slide 29 text
Swift4ʹઈࢍରԠத
Slide 30
Slide 30 text
Swift4ʹઈࢍରԠத
master͕յΕ͍ͯΔ
Slide 31
Slide 31 text
Swift4ʹઈࢍରԠத…
• Swift4ͳͷʹRxSwiftͷόʔδϣϯ͕3.xͰίϯύΠϧΤϥʔ
• allOf: λάʹهࡌͨ͠$ref͕ܧঝؔʹͳΔͷʹinitͰ
super.init(coder:)ΛݺΜͰ͍ͳ͍ͷͰίϯύΠϧΤϥʔ
• ۭͷλϓϧͷมߋʹै͍ͯ͠ͳ͍ͷͰɺon(.next())ͰίϯύΠϧΤϥʔ
• enumΛStringͰσίʔυ͠Α͏ͱͯ͠ίϯύΠϧΤϥʔ
• CodableΛҾʹͱΔϝιουʹAnyΛͦ͏ͱͯ͠ίϯύΠϧΤϥʔ
Slide 32
Slide 32 text
ࣗ࡞ͷmastachςϯϓϨʔτΛ࡞Δ
Slide 33
Slide 33 text
ΦϨΦϨYAML Parser & GeneratorΛ࡞Δ
Slide 34
Slide 34 text
https://github.com/hiragram/
Swako
ΦϨΦϨYAML Parser & GeneratorΛ࡞Δ
Slide 35
Slide 35 text
No content
Slide 36
Slide 36 text
PRΛૹΖ͏ʂʂ
Slide 37
Slide 37 text
ࣗྗͰ͢
Slide 38
Slide 38 text
Swift4ʹઈࢍରԠத…
• Swift4ͳͷʹRxSwiftͷόʔδϣϯ͕3.xͰίϯύΠϧΤϥʔ
• allOf: λάʹهࡌͨ͠$ref͕ܧঝؔʹͳΔͷʹinitͰ
super.init(coder:)ΛݺΜͰ͍ͳ͍ͷͰίϯύΠϧΤϥʔ
• ۭͷλϓϧͷมߋʹै͍ͯ͠ͳ͍ͷͰɺon(.next())ͰίϯύΠϧΤϥʔ
• enumΛStringͰσίʔυ͠Α͏ͱͯ͠ίϯύΠϧΤϥʔ
• CodableΛҾʹͱΔϝιουʹAnyΛͦ͏ͱͯ͠ίϯύΠϧΤϥʔ
Slide 39
Slide 39 text
RxSwift in Swift 4
• ʮRxSwift4Λνϥݟ͢Δʯ@tarunon
https://www.icloud.com/keynote/
0lglRaoECYvXtcY3bkhRC1C7Q#OverviewRxSwift4
Slide 40
Slide 40 text
on(.next())ͰίϯύΠϧΤϥʔʁ
ObserverʹVoidͷΠϕϯτΛͦ͏ͱ͢Δɻ
open class func updatePet(body: Pet) -> Observable {
return Observable.create { observer -> Disposable in
updatePet(body: body) { error in
if let error = error {
observer.on(.error(error))
} else {
observer.on(.next())
}
observer.on(.completed)
}
return Disposables.create()
}
}
Slide 41
Slide 41 text
on(.next())ͰίϯύΠϧΤϥʔʁ
ObserverʹVoidͷΠϕϯτΛͦ͏ͱ͢Δɻ
open class func updatePet(body: Pet) -> Observable {
return Observable.create { observer -> Disposable in
updatePet(body: body) { error in
if let error = error {
observer.on(.error(error))
} else {
observer.on(.next())
}
observer.on(.completed)
}
return Disposables.create()
}
}
Missing argument for parameter #1 in call
Slide 42
Slide 42 text
on(.next())ͰίϯύΠϧΤϥʔʁ
ObserverʹVoidͷΠϕϯτΛͦ͏ͱ͢Δɻ
open class func updatePet(body: Pet) -> Observable {
return Observable.create { observer -> Disposable in
updatePet(body: body) { error in
if let error = error {
observer.on(.error(error))
} else {
observer.on(.next(()))
}
observer.on(.completed)
}
return Disposables.create()
}
}
Slide 43
Slide 43 text
No content
Slide 44
Slide 44 text
Swift4ͰλϓϧͱɺෳҾؔΛ۠ผ͢ΔΑ͏ʹͳͬͨ
f f(()) ͱॻ͘
Slide 45
Slide 45 text
classܧঝͯ͠ΔͷʹɺsuperݺΜͰͳ͍ʁ
open class Cat: Animal {
public var declawed: Bool?
// Decodable protocol methods
public override required init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: String.self)
declawed = try container.decodeIfPresent(Bool.self, forKey: "declawed")
}
}
superݺΜͰͳ͍
Slide 46
Slide 46 text
classܧঝͯ͠ΔͷʹɺsuperݺΜͰͳ͍ʁ
open class Cat: Animal {
public var declawed: Bool?
// Decodable protocol methods
public required init(from decoder: Decoder) throws {
let container = try decoder.container(keyedBy: String.self)
declawed = try container.decodeIfPresent(Bool.self, forKey: "declawed")
try super.init(from: decoder)
}
}
Slide 47
Slide 47 text
ͦͦɺͳΜͰܧঝ͕ؔൃੜ
͢ΔΜͰ͔͢ʁ
Slide 48
Slide 48 text
Cat:
allOf:
- $ref: '#/definitions/Animal'
- type: object
properties:
declawed:
type: boolean
Animal:
type: object
discriminator: className
required:
- className
properties:
className:
type: string
color:
type: string
default: 'red'
= Animal + declawed
open class Cat: Animal {
public var declawed: Bool?
}
Slide 49
Slide 49 text
ΫϥεΛܧঝͨ͠ΒͲ͏͔ʁ
encode / decode Λ࣮
ܧঝͻͱͭͷΫϥε·Ͱ
superclass ͷ มॻ͔ͳͯ͘ྑ͍
Slide 50
Slide 50 text
ΫϥεΛܧঝͨ͠ΒͲ͏͔ʁ
encode / decode Λ࣮ → ίʔυੜͰͰ͖Δ
ܧঝͻͱͭͷΫϥε·Ͱ
superclass ͷ มॻ͔ͳͯ͘ྑ͍
Slide 51
Slide 51 text
protocolΛద߹ͨ͠ΒͲ͏͔ʁ
ద߹͢Δprotocolͷมॻ͔ͳ͚Ε͍͚ͳ͍
encode / decodeॻ͔ͳͯ͘ྑ͍
structͰॻ͚Δ
Slide 52
Slide 52 text
ίʔυੜʹ͓͚ΔϕετϓϥΫςΟε
Կܧঝ͠ͳ͍
Slide 53
Slide 53 text
ίʔυੜʹ͓͚ΔϕετϓϥΫςΟε
ͦͦBMM0GͷSFGऔಘͯ͠ɺଞͷมͱDPODBUͯ͘͠
ΕΕ͍͍Μ͡Όͳ͍͔ͳ͊
Slide 54
Slide 54 text
https://github.com/swagger-api/
swagger-codegen/issues/6941
classΛstructʹ͍ͨ͠
Slide 55
Slide 55 text
Swift4ʹઈࢍରԠத
• Swift4 ͳͷʹ RxSwift ͷόʔδϣϯ͕ 3.x ͰίϯύΠϧΤϥʔ
• allOf λάʹهࡌͨ͠ ref ͕ܧঝؔʹͳΔͷʹinitͰsuper.init(coder:)Λݺ
ΜͰ͍ͳ͍ͷͰίϯύΠϧΤϥʔ
• ۭͷλϓϧͷมߋʹै͍ͯ͠ͳ͍ͷͰɺonNext()ͰίϯύΠϧΤϥʔ
• enumΛStringͰσίʔυ͠Α͏ͱͯ͠ίϯύΠϧΤϥʔ
• CodableΛҾʹͱΔϝιουʹAnyΛͦ͏ͱͯ͠ίϯύΠϧΤϥʔ
Slide 56
Slide 56 text
(ݩ͔Β) sampleյΕͯΔ͔Β͠ͱ͍ͯ
Slide 57
Slide 57 text
(ݩ͔Β) ςετ௨Βͳ͍Μ͚ͩͲ…
Slide 58
Slide 58 text
Ώͬ͘ΓٳΜͰ…
Slide 59
Slide 59 text
Swift4ʹઈࢍରԠத
• Swift4ͳͷʹRxSwift, Alamofireͷόʔδϣϯ͕3.xͰίϯύΠϧΤϥʔ
• allOf λάʹهࡌͨ͠ref ͕ܧঝؔʹͳΔͷʹinitͰsuper.init(coder:)Λݺ
ΜͰ͍ͳ͍ͷͰίϯύΠϧΤϥʔ
• ۭͷλϓϧͷมߋʹै͍ͯ͠ͳ͍ͷͰɺonNext()ͰίϯύΠϧΤϥʔ
• enumΛStringͰσίʔυ͠Α͏ͱͯ͠ίϯύΠϧΤϥʔ
• CodableΛҾʹͱΔϝιουʹAnyΛͦ͏ͱͯ͠ίϯύΠϧΤϥʔ
શ෦͠·ͨ͠
Slide 60
Slide 60 text
https://github.com/swagger-api/
swagger-codegen/pull/6921
Slide 61
Slide 61 text
Merge͞Εͨ͋ͱϝʔϧ͕དྷͨ
Slide 62
Slide 62 text
https://jknack.github.io/
handlebars.java/
Handling OpenAPI 3.0 with new engine
Slide 63
Slide 63 text
Recap
• swagger-codegen ͷ Swift4 ରԠ͠·ͨ͠
• खऔΓૣ͘Λੜ͍ͨ͠ਓʹΦεεϝ
• Codable ͷܧঝؔʹ͍ͭͯɺ࠙ձͰ