Introduction of Swift HTTP APIs

Transcript

1. Introduction of Swift HTTP APIs Shun Takebayashi
2. History of Server-Side Swift
3. History of Server-Side Swift (Dec 2015) • Apple open-sourced Swift
4. History of Server-Side Swift ( - Mid 2016) • App frameworks • Perfect • Kitura • No standard APIs • Third-party API specifications • Nest • OpenSwift / S4
5. The Ecosystem of Web Development with Swift Shun Takebayashi takebayashi https://speakerdeck.com/takebayashi/the-ecosystem-of-web-development-with-swift
6. History of Server-Side Swift (Oct 2016) • Apple announces Server APIs Work Group • Working on 3 layers: • Base networking • Security / Encryption • HTTP / WebSocket
7. ͜Ε͔Β͸͡ΊΔ αʔόʔαΠυ Swift Tokyo Server Side Swift Meetup #7 @ Speee Lounge - 2017.5.26 https://speakerdeck.com/jp_pancake/korekarahazimerusabasaido-swift
8. What are HTTP APIs?
9. HTTP APIs are NOT… • Web application frameworks • Stable specification
10. HTTP APIs are… • Low-level types and interfaces • Still under discussion
11. Exploring HTTP APIs
12. https://github.com/swift-server/http/blob/develop/API.md
13. Types in HTTP APIs • HTTPRequest • HTTPResponse • HTTPResponseWriter • HTTPBodyHandler • HTTPBodyProcessing • HTTPBodyChunk • etc…
14. Interfaces in HTTP APIs typealias WebApp = (HTTPRequest, HTTPResponseWriter) -> HTTPBodyProcessing
15. Interfaces in HTTP APIs enum HTTPBodyProcessing { case discardBody case processBody(handler: HTTPBodyHandler) } typealias HTTPBodyHandler = (HTTPBodyChunk, inout Bool) -> Void
16. Sample App let myApp = { (req: HTTPRequest, res: HTTPResponseWriter ) -> HTTPBodyProcessing in res.writeResponse(HTTPResponse( httpVersion: req.httpVersion, status: .ok, transferEncoding: .chunked, headers: HTTPHeaders([("Content-Type", "text/plain")]) )) return .processBody { (chunk, stop) in switch chunk { case .chunk(let data, let finishedProcessing): res.writeBody(data: data) { _ in finishedProcessing() } case .end: res.done() default: stop = true res.abort() } } }
17. Implementations
18. BlueSocketHTTP • Prototype implementation of HTTP APIs • Based on IBM BlueSocket https://github.com/swift-server/http/tree/develop/Sources/BlueSocketHTTP
19. Deploying with BlueSocketHTTP import HTTP import BlueSocketHTTP let server = BlueSocketSimpleServer() do { try server.start(port: 8080, webapp: myApp) }
20. Summary
21. Swift HTTP APIs are… • Low-level types and functions • for handling/responding to requests • Unstable, but prototype implementations are available • You can try with BlueSocketHTTP
22. Happy Server-Side Swift