Perfect官方文档以及参考的文章:(侵权可联系本人删除)
《Perfect官方文档》
《Swift3.0服务端开发(一) 完整示例概述及Perfect环境搭建与配置(服务端+iOS端》
《服务端写Swift体验 (Perfect框架)》
《Swift3.0用Perfect和MySQL搭自己的服务器》
一、根据官方模版项目搭建本地服务器(这一步跟官方文档一样)
创建Swift软件包
mkdir MyAwesomeProject
cd MyAwesomeProject
为了加快项目进度,最简单的方法就是把这个项目目录转化为git repo(代码资源文件夹):
git init
touch README.html
git add README.html
git commit -m "Initial commit"
现在请在您的git repo根目录下面创建一个Package.swift文件。这个文件是SPM(Swift软件包管理器)编译项目时必须要用到的文件:
touch Package.swift
在touch Package.swift文件中写以下代码:
import PackageDescription
let versions = Version(0,0,0)..<Version(10,0,0)
let urls = [
"https://github.com/PerfectlySoft/Perfect-HTTPServer.git", //HTTP服务
"https://github.com/PerfectlySoft/Perfect-MySQL.git", //MySQL服务
"https://github.com/PerfectlySoft/Perfect-Mustache.git" //Mustache
]
let package = Package(
name: "PerfectDemoProject",
targets: [],
dependencies: urls.map { .Package(url: $0, versions: versions) }
)
接下来请创建一个名为Sources的文件夹用于保存源程序,然后在这个源程序文件夹下面创建一个main.swift文件:
mkdir Sources
echo 'print("您好!")' >> Sources/main.swift
image.png
这个时候可能会报错:
image.png没找到mysql.h文件,这是因为文件路径变了。
⚠️注意:此时可以先忽略这个错误,继续下一步
在终端命令行内输入
swift package generate-xcodeproj
image.png
然后打开产生的文件“PerfectTemplate.xcodeproj”,在”Library Search Paths“检索项目软件库中增加(不单单是编译目标):
$(PROJECT_DIR) - Recursive
image.png
运行,定位到报错信息:
image.png把这个路径修改成你实际上mysql.h文件的路径,我这边的路径是:
/usr/local/mysql-5.6.37-macos10.12-x86_64/include/mysql.h
运行,不报错。
在main.swift文件中,写入以下代码,搭建http服务器,这是路由器部分,这里端口号设置为8088:
import PerfectLib
import PerfectHTTP
import PerfectHTTPServer
open class NetworkServerManager {
fileprivate var server: HTTPServer
internal init(root: String, port: UInt16) {
server = HTTPServer.init() //创建HTTPServer服务器
var routes = Routes.init(baseUri: "/api") //创建路由器
configure(routes: &routes) //注册路由
server.addRoutes(routes) //路由添加进服务
server.serverPort = port //端口
server.documentRoot = root //根目录
server.setResponseFilters([(Filter404(), .high)]) //404过滤
}
//MARK: 开启服务
open func startServer() {
do {
print("启动HTTP服务器")
try server.start()
} catch PerfectError.networkError(let err, let msg) {
print("网络出现错误:\(err) \(msg)")
} catch {
print("网络未知错误")
}
}
//MARK: 注册路由
fileprivate func configure(routes: inout Routes) {
// 添加接口,请求方式,路径
routes.add(method: .get, uri: "/home") { (request, response) in
response.setHeader( .contentType, value: "text/json;charset=utf-8") //响应头
let result = ["name":"Grabin","date":"2017-10-20"]
let jsonString = self.baseResponseBodyJSONData(status: 200, message: "成功", data: result)
response.setBody(string: jsonString)
response.completed()
}
routes.add(method: .get, uri: "/text") { (request, response) in
response.setHeader( .contentType, value: "text/json;charset=utf-8") //响应头
let result = "你好,你现在来到了Grabin搭建的Swift服务器..."
response.setBody(string: result)
response.completed()
}
}
//MARK: 通用响应格式
func baseResponseBodyJSONData(status: Int, message: String, data: Any!) -> String {
var result = Dictionary<String, Any>()
result.updateValue(status, forKey: "status")
result.updateValue(message, forKey: "message")
if (data != nil) {
result.updateValue(data, forKey: "data")
}else{
result.updateValue("", forKey: "data")
}
guard let jsonString = try? result.jsonEncodedString() else {
return ""
}
return jsonString
}
//MARK: 404过滤
struct Filter404: HTTPResponseFilter {
func filterBody(response: HTTPResponse, callback: (HTTPResponseFilterResult) -> ()) {
callback(.continue)
}
func filterHeaders(response: HTTPResponse, callback: (HTTPResponseFilterResult) -> ()) {
if case .notFound = response.status {
response.setHeader( .contentType, value: "text/json;charset=utf-8") //响应头
response.setBody(string: "404 文件\(response.request.path)不存在。")
response.setHeader(.contentLength, value: "\(response.bodyBytes.count)")
callback(.done)
} else {
callback(.continue)
}
}
}
}
//HTTP服务
let networkServer = NetworkServerManager(root: "webroot", port: 8088)
networkServer.startServer()
这段代码在注册路由时,添加了两个get请求接口:
image.png运行之后Xcode打印出:
image.png这个时候可以在浏览器输入(或者点击下面链接),可以看到效果:
http://localhost:8088/api/text
http://localhost:8088/api/home
image.png
当然,在同一个局域网内用手机也是可以访问此服务器的(把地址换成自己电脑的ip就可以):
IMG_3912.PNG这个时候就已经搭建好一个服务器了。
网友评论