初探 Perfect : Swift 服務端編程

開始

首先要建立一個項目。操做系統的環境是 mac OS。在安裝了 Xcode 8 以後會有 Swift 的編譯器了，這裏咱們的環境是 mac OS, 因此 Linux 環境要本身去安裝 Swift 相關的環境，經過命令能夠查看 Swift 的版本:

swift

swift 3.0 以後默認是安裝了 Swift Package Manager 的, 一個相似於 CocoaPods 的管理依賴的工具, 可是 Swift Package Manager 是跨平臺的,能夠在 Linux 環境下使用， CocoaPods 不是。

經過 Swift Package Manager 生成一個項目:

swift package init --type executable

--type executable 的意思是生成一個可執行文件的工程，由於不加的話默認是生成一個 libary。這個命令乾的事情，就是生成一個工程。生成的項目主要有下面這些文件

• main.swift

• Package.swift

main.swift 沒什麼好說的，就相似程序的入口。Package.swift 是管理依賴的。

編譯

能夠經過下面的命令編譯項目:

swift build

在當前的文件夾下就生成了編譯後的可執行文件了。

寫代碼

能夠經過編譯器來寫代碼，可是爲了得到一些便利，能夠經過 Xcode 來碼代碼，Swift Package Manager 爲咱們提供了一個命令來生成 Xcode 項目:

swift package generate-xcodeproj

就會在點前的目錄爲咱們建立一個 Xcode 項目並生成相應的 target。咱們要引入對 Perfect 的依賴，去到咱們生成的代碼的 Package.swift 文件中，添加相關代碼以下:

import PackageDescription

let package = Package(
    name: "hello-perfect",
    dependencies: [
    .Package(url: "https://github.com/PerfectlySoft/Perfect-HTTPServer.git", majorVersion: 2)
]
)

而後咱們經過下面的命令進行更新，就相似於 pod update:

swift package update

再經過:

swift package generate-xcodeproj

生成 Xcode 項目，同步文件目錄。

在 main.swift 中引入其餘文件:

import PerfectLib
import PerfectHTTP
import PerfectHTTPServer

以下

經過生成相關文件:

mkdir webroot
touch webroot/hello.txt
swift package generate-xcodeproj

在 main.swift , 添加下面的代碼:

// 生成一個 HTTPServer
let server = HTTPServer()
// 監聽 8990 端口
server.serverPort = 8990
// 設置根目錄
server.documentRoot = "webroot"

do {
    // 啓動服務
    try server.start()
} catch {
    print(error)
}

cmd + R, 編譯運行，而後咱們在瀏覽器中輸入 http://localhost:8990/hello.txt 就能看的 hello.txt 的內容了。

路由處理

在 main.swift 中繼續添加下面代碼:

var routers = Routes()
routers.add(method: .get, uri: "/") {
    req, res in
    res.setBody(string: "Hello Swift 服務端").completed()
}
server.addRoutes(routers)

而後訪問 http://localhost:8990/ 就能看到

JSON

經過下面的方式返回 JSON:

func jsonMessage(message: String, response: HTTPResponse) {
    do {
        try response.setBody(json: ["message": message]).setHeader(.contentType, value: "application/json").completed()
    } catch {
        print(error)
    }
}
routers.add(uri: "/profile") {
    req, res in
    jsonMessage(message: "PHP 是最好的語言", response: res)
}

其餘用法:

routers.add(method: .get, uri: "/age/{age}") {
    req, res in
    guard let age = req.urlVariables["age"] else {
        return
    }
    
    jsonMessage(message: "歲數 " + age, response: res)
}

routers.add(method: .post, uri: "post") {
    req, res in
    guard let name = req.param(name: "name") else {
        return
    }
    
    jsonMessage(message: "最好的語言是 " + name, response: res)
}