开始
首先要创建一个项目。操作系统的环境是 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
在 main.swift 中引入其他文件:
import PerfectLib import PerfectHTTP import PerfectHTTPServer
如下
mkdir webroot touch webroot/hello.txt swift package generate-xcodeproj
// 生成一个 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
的内容了。
路由处理
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) }