Swift Web 開發(fā)之 Vapor - 路由（二）

2019-11-06 06:47:32

字體：大中小

供稿：網(wǎng)友

上篇文章帶大家基本了解了一下開始一個 Vapor 項目的流程，本篇緊接著來說說在所有 Web 框架中都最關(guān)鍵的 “路由”，因為 “路由” 模塊在 Web 項目中擔任很重要的角色，所以很多語言的 Web 框架都把 “路由” 抽離到框架層，從而減少開發(fā)者的工作量，一個設(shè)計得易用強大的 “路由” 系統(tǒng)也會給相應(yīng)給框架增添不少色彩。

Web 開發(fā)中的路由這個概念簡單來說就是 URL 路徑到具體處理函數(shù)之間的映射，只有設(shè)定好了路由，訪問者才能在瀏覽器根據(jù)相關(guān) URL 規(guī)則進行頁面跳轉(zhuǎn)和訪問，Vapor 對路由做了很多實用性設(shè)計，包括路由的構(gòu)建、路由組、類型安全的路由參數(shù)、路由集合等等，希望看完本篇文章你能用 Vapor 寫出一些簡單的路由，我們先來看看 Vapor 最簡單的路由注冊。

Droplet

注冊路由之前我們需要知道 Droplet 這個類，每個程序都應(yīng)該有一個它的實例，控制著整個程序的生命周期，之后我們會通過 droplet 來注冊路由，添加 PRovider，添加中間件 (middleware) 等等。 droplet 的初始化很簡單，一個空程序看起來就像這樣：

import Vaporlet drop = Droplet()// your magic heredrop.run()

注冊路由

注冊一個最基本的路由通過對全局 Droplet 對象調(diào)用一個方法，指定路徑和一個閉包來接收操作處理。

drop.get("welcome") { request in return "Hello"}

我們通過調(diào)用 get() 方法來注冊了一個路徑為 /welcome 的路由，并返回了 “Hello” 這個字符串到瀏覽器，當然我們除了 get 還可以其他的標準 HTTP 方法，比如 post、 put、 patch、 delete、options。

另外我們還可以使用 add() 方法來注冊路由，以接收第一個參數(shù) Method 作為 HTTP 方法來動態(tài)注冊路由，Method 是一個枚舉，包含了上述所列的 HTTP 標準方法，代碼看起來是這樣：

drop.add(.trace, "welcome") { request in return "Hello"}

可能你會想明明上面已經(jīng)提供了對應(yīng)的方法來注冊路由，為什么還要多一個 add() 方法來注冊路由？因為這個方法可以動態(tài)注冊，并且支持一些其他不常見的方法（比如 trace）。

另外有一種關(guān)于多級路徑的寫法，直接使用參數(shù)分割，而不是在一個 String 參數(shù)中用 / 分開，官方推薦是這種寫法，因為可以更容易寫出類型安全的路由參數(shù)。

drop.get("foo", "bar", "baz") { request in return "You requested /foo/bar/baz"}

如果想在 URL 路由中使用通配符怎么辦？

app.get("anything", "*") { request in return "Matches anything after /anything"}

像這個例子因為用了 * 尾隨參數(shù)，可以匹配到如下所有路徑：

/anything/anything/foo/anything/foo/bar/anything/foo/bar/baz

Request

每個路由的閉包都會有一個 Request 參數(shù)，用來獲得每一個訪問請求的相關(guān)內(nèi)容，比如 URL 參數(shù)、HTTP Header、HTTP Body 等等，而且 Vapor 都已經(jīng)為你封裝好了很方便的接口來獲取這些內(nèi)容，甚至直接解析 JSON。

詳細使用可以參考官方文檔 Request 一節(jié)。

路由參數(shù)

Vapor 提倡使用類型安全的路由參數(shù)來接收數(shù)據(jù)，我們可以在路由方法中使用 Swift 類型來指定參數(shù)類型，Vapor 會在內(nèi)部解析并將參數(shù)返回給閉包以供使用，非常方便。

drop.get("users", Int.self) { request, userId in return "You requested User #/(userId)"}

Swift 中處處有協(xié)議，路由參數(shù)也是如此，我們所見例子中的 Int 其實就是 Vapor 給實現(xiàn)了 StringInitializable 協(xié)議，當然 String 也已經(jīng)默認實現(xiàn)。

public protocol StringInitializable { init?(from string: String) throws}

Response

每個路由的閉包中可以返回三種類型的內(nèi)容，Response、ResponseRepresentable、throw，你可以你可以返回自己所需的 HTTP 狀態(tài)碼、URL 重定向、JSON等，基本涵蓋日常所需的請求返回。

Response

Response 是 Vapor 中 HTTP 模塊中定義的基于 Message 的類，有很多構(gòu)造方法方便我們自定義 response 返回：

// 重定向Response(redirect: "http://vapor.codes")// JSONResponse(status: .ok, json: JSON(["hello":"world"]))// StringResponse(body: "hello")

ResponseRepresentable

ResponseRepresentable 是一個協(xié)議，任何遵循這個協(xié)議的對象均可在路由中返回，就像之前例子中我們直接返回了字符串，就是因為 Vapor 默認給 String 實現(xiàn)了 ResponseRepresentable 協(xié)議，讓我們可以方便的在閉包中直接返回字符串，類似的還有 JSON、Model 對象。