轉載請附原文鏈接:http://blog.fandong.me/2017/08/20/iOS-SwiftVaporWeb23/

前言

之前一直有做Java后臺開發的興趣，可是想到要看好多的Java教程，作為一個iOS開發者，我放棄了，
后來從朋友韓云智VL那里知道了這個框架，竟是用Swift寫的，不得不說，它燃起了我的興趣。
Vapor是一個基于Swift開發的服務端框架，可以工作于iOS，Mac OS，Ubuntu。
為了配合Swift部署到服務器,我把ECS的服務器系統改為Ubuntu16.04。

Vapor 2.0 - 文檔目錄
以下文字翻譯自Vapor Docs/HTTP/Body

請求體

HTTP.Body表示的是HTTP.Message的有效載荷,并用于傳遞底層數據,在這次練習中的一些例子是JSON,HTML文本或者二進制圖像,我們來看一下具體實現

public enum Body {
    case data(Bytes)
    case chunked((ChunkStream) throws -> Void)
}

數據案例

Data Case是一個目前最常見的Body中的HTTP.Message.它只是一個字節數組,與這些字節數組關聯的序列化協議或類型通常由Content-Type請求頭定義,我們來看些例子

Application/JSON

如果我們的Content-Type請求頭包含application/json,那么底層二級制數據表示序列化的JSON

if let contentType = req.headers["Content-Type"], contentType.contains("application/json"), let bytes = req.body.bytes {
  let json = try JSON(bytes: bytes)
  print("Got JSON: \(json)")
}

Image/PNG

如果我們的Content-Type包含image/png,則底層二進制數據表示編碼的png.

if let contentType = req.headers["Content-Type"], contentType.contains("image/png"), let bytes = req.body.bytes {
  try database.save(image: bytes)
}

分塊案例

分塊案例只適用于Vapor的外發的HTTP.Message,傳統意義上,響應者的角色是在傳遞之前收集整個分塊編碼,我們可以使用它來異步發送一個正文.

let body: Body = Body.chunked(sender)
return Response(status: .ok, body: body)

我們也可以手動實現,也可以使用Vapor的內置便利的初始化器來進行對請求體進行分塊.

return Response(status: .ok) { chunker in
  for name in ["joe", "pam", "cheryl"] {
      sleep(1)
      try chunker.send(name)
  }

  try chunker.close()
}

確保在分塊離開范圍之前調用close()

BodyRepressentable

除了具體的Body類型,就像在Vapor中常見,我們也廣泛的支持BodyRepresentable.這意味著我們通常轉換的類型的對象可以互換使用,舉個栗子

return Response(body: "Hello, World!")

在上面的例子中,字符串被轉換成二進制,并且添加到了請求體中

作為練習,最好使用Hello,World!Vapor會自動設置Content-Type為合適的值

我們來看看它是如何實現的:

public protocol BodyRepresentable {
    func makeBody() -> Body
}

自定義

我們也可以在適用的情況下遵照我們自己的類型,假設我們有一個自定義的數據類型,.vpr讓我們符合我們的VPR文件類型

extension VPRFile: HTTP.BodyRepresentable {
  func makeBody() -> Body {
    // collect bytes
    return .data(bytes)
  }
}

你可能已經注意到,協議拋出,但是我們沒有實現,這在Swift中完全有效,如果你曾經手動調用過這個方法,那你將無法拋出.

現在我們可以直接在我們的Responses中包含我們的VPR文件.

drop.get("files", ":file-name") { request in
  let filename = try request.parameters.extract("file-name") as String
  let file = VPRFileManager.fetch(filename)
  return Response(status: .ok, headers: ["Content-Type": "file/vpr"], body: file)
}

作為練習,如果我們經常重復這些過程,我們可能會讓VPRFile直接遵循ResponseRepresentable

extension VPRFile: HTTP.ResponseRepresentable {
  func makeResponse() -> Response {
    return Response(
      status: .ok,
      headers: ["Content-Type": "file/vpr"],
      body: file
    )
  }
}

這是我們上面的例子

drop.get("files", ":file-name") { request in
  let filename = try request.parameters.extract("file-name") as String
  return VPRFileManager.fetch(filename)
}

我們也可以使用類型安全的路由使其更簡潔:

drop.get("files", String.self) { request, filename in
  return VPRFileManager.fetch(filename)
}