初探 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)
}