はじめての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 • [email protected] ഁյతͳมߋ͕ߦΘΕΔՄೳੑ΋͋Δ

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౳Ͱٞ࿦΁ͷࢀՃ͕Մೳ