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