开始
首先要创建一个项目。操作系统的环境是 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)
}
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。