はじめてのSwift Server API / Beginning Swift Server API

Transcript

1. ͸͡ΊͯͷSwift Server API Shun Takebayashi
2. ΞδΣϯμ • Swift Server APIͱ͸ • HTTP APIͱ͸ • αϯϓϧʹֶͿHTTP API • HTTP APIͷݱঢ় • ·ͱΊ
3. Swift Server APIͱ͸
4. Swift Server APIͱ͸ αʔόʔαΠυͰඞཁͱͳΔίϯϙʔωϯτΛඪ४Խͨ͠APIͷ૯শ
5. Swift Server APIͱ͸ ໨త • ૬ޓӡ༻ੑͷ֬อ • ϚϧνϓϥοτϑΥʔϜ΁ͷରԠ
6. Swift Server APIͱ͸ Χόʔ͢ΔྖҬ • ωοτϫʔΫ • ηΩϡϦςΟ • HTTP
7. Swift Server APIͱ͸ Χόʔ͢ΔྖҬ • ωοτϫʔΫ • ηΩϡϦςΟ • HTTP
8. HTTP APIͱ͸
9. HTTP APIͱ͸ αʔόʔαΠυͰಈ͘HTTPΞϓϦέʔγϣϯͷͨΊͷجຊతͳίϯϙʔωϯτ • ܕ΍ΠϯλʔϑΣʔε • σϑΥϧτͷ࣮૷ ΢ΣϒΞϓϦέʔγϣϯϑϨʔϜϫʔΫͰ͸ͳ͍
10. HTTP APIͱ͸ ΞϓϦέʔγϣϯ ϦΫΤετ Ϩεϙϯε αʔό ϦΫΤετ Ϩεϙϯε ΫϥΠΞϯτ
11. HTTP APIͱ͸ ΞϓϦέʔγϣϯ ϦΫΤετ Ϩεϙϯε αʔό ϦΫΤετ Ϩεϙϯε ΫϥΠΞϯτ
12. HTTP APIͱ͸ HTTPRequestHandler HTTPRequest HTTPResponseStatus, … HTTPServing ϦΫΤετ Ϩεϙϯε ΫϥΠΞϯτ
13. HTTP APIͱ͸ public typealias HTTPRequestHandler = (HTTPRequest, HTTPResponseWriter) -> HTTPBodyProcessing public protocol HTTPServing : class { func start(port: Int, handler: @escaping HTTPRequestHandler) throws // ... }
14. αϯϓϧʹֶͿHTTP API
15. let app: HTTPRequestHandler = { (request, responseWriter) in let headers: HTTPHeaders = ["Content-Type": "text/plain"] responseWriter.writeHeader(status: .ok, headers: headers) responseWriter.writeBody("Hello, world!") return .discardBody }
16. let app: HTTPRequestHandler = { (request, responseWriter) in let headers: HTTPHeaders = ["Content-Type": "text/plain"] responseWriter.writeHeader(status: .ok, headers: headers) responseWriter.writeBody("Hello, world!") return .discardBody }
17. let app: HTTPRequestHandler = { (request, responseWriter) in let headers: HTTPHeaders = ["Content-Type": "text/plain"] responseWriter.writeHeader(status: .ok, headers: headers) responseWriter.writeBody("Hello, world!") return .discardBody }
18. let app: HTTPRequestHandler = { (request, responseWriter) in let headers: HTTPHeaders = ["Content-Type": "text/plain"] responseWriter.writeHeader(status: .ok, headers: headers) responseWriter.writeBody("Hello, world!") return .discardBody }
19. try! HTTPServer().start(port: 8080, handler: app)
20. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
21. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
22. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
23. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
24. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
25. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
26. let app: HTTPRequestHandler = { (request, responseWriter) in responseWriter.writeHeader(status: .ok) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): responseWriter.writeBody(data) { _ in finishedProcessing() } case .end: responseWriter.done() default: stop = true responseWriter.abort() } } }
27. try! HTTPServer().start(port: 8080, handler: app)
28. public typealias HTTPBodyHandler = (HTTPBodyChunk, inout Bool) -> Void public enum HTTPBodyProcessing { case discardBody case processBody(handler: HTTPBodyHandler) } public enum HTTPBodyChunk { case chunk(data: DispatchData, finishedProcessing: ()-> Void) case end // ... }
29. αϯϓϧʹֶͿHTTP API جຊతͳྲྀΕ • HTTPRequestHandlerΛ࣮૷͢Δ • HTTPRequestΛड͚औΓɺHTTPResponseWriterʹॻ͖ࠐΉ • ϦΫΤετϘσΟΛॲཧ͢Δ৔߹͸HTTPBodyHandlerΛ࣮૷͢Δ • ෳ਺ճ࣮ߦ͞ΕΔՄೳੑ͕͋Δ (Chunked Transfer)
30. HTTP APIͷݱঢ়
31. HTTP APIͷݱঢ় ਖ਼ࣜϦϦʔεલ ·ͩਖ਼ࣜϦϦʔε͸͞Ε͓ͯΒͣɺ೔ʑվળ͞Ε͍ͯΔ • https://github.com/swift-server/http • swift-server-dev@swift.org ഁյతͳมߋ͕ߦΘΕΔՄೳੑ΋͋Δ
32. HTTP APIͷݱঢ় HTTP APIʹґଘͨ͠ΞϓϦέʔγϣϯͷϏϧυํ๏ λά͕ৼΒΕ͍ͯͳ͍ͨΊɺSwift 4ͷPackage Manager͕ඞཁ let package = Package( name: "swift-http-example", dependencies: [ .package(url: "https://github.com/swift-server/http.git", .branch("develop")), ], targets: [ .target(name: "swift-http-example", dependencies: ["SwiftServerHTTP"]), ] )
33. ·ͱΊ
34. ·ͱΊ • Swift Server API͸ϙʔλϒϧͳαʔόʔαΠυSwiftΛ࣮ݱ͢ΔͨΊͷAPI • HTTP API͸HTTPΞϓϦέʔγϣϯͷͨΊͷڞ௨ΠϯλʔϑΣʔε • ΞϓϦέʔγϣϯ͸HTTPRequestHandlerΛ࣮૷ • αʔόʔ͸HTTPServingΛ࣮૷ • ೚ҙͷαʔόʔͱΞϓϦέʔγϣϯΛ૊Έ߹Θ࣮ͤͯߦՄೳ • ·ͩਖ਼ࣜϦϦʔεલͷ࢓༷Ͱ͋ΓɺML౳Ͱٞ࿦΁ͷࢀՃ͕Մೳ