一步一步在 Prefect Swift 服务器上编写第一个接口 (二)

链接： 一步一步在 Prefect Swift 服务器上编写第一个接口 (一)

目录

1. 准备材料

1. Perfect 官网
2. 官方代码仓库 Perfect GitHub
3. 模拟网络请求工具 postman
4. 《文章一》中的空白项目

2. 了解空白项目文件目录结构并在 Xocde 中运行项目代码

① 使用SPM软件包管理器初始化的空白项目

下图为文章一中，我们利用SPM软件包管理器初始化的空白项目

此时如果想使用 Xcode 打开项目，需要打开终端
进入到项目根目录

$ swift package generate-xcodeproj
generated: ./Swift-Perfect.xcodeproj

项目根目录会创建出供Xcode 编辑项目使用的Swift-Perfect.xcodeproj文件

② 使用 Xcode 打开 Swift-Perfect.xcodeproj

编译项目选择 Swift-Perfect, 编译设备选择 My Mac

在”Library Search Paths“检索项目软件库中增加
$(PROJECT_DIR) 选择 Recursive


为了使服务器能够访问工程文件夹下的目录,请选择菜单命令 “Product > Scheme > Edit Scheme…” 然后设置工作目录 “Use Custom Working Directory” 为项目文件夹。

备注：因为项目中如果添加新的文件或者增加新的第三方库，需要重新创建 Swift-Perfect.xcodeproj 文件，对 .xcodeproj 的更改会丢失，只要重新创建了 .xcodeproj 就需要重新配置，所以后期会经常重复上面前两个步骤

配置完成后，点击 Xcode Run 或 command+R 编译运行项目。
Xcode 控制台输出

3. 创建 httpServer 服务器

① 创建并开启 httpServer

打开 main.swift , 编辑代码如下

import PerfectLib
import PerfectHTTP
import PerfectHTTPServer

var HTTPport = 8180
var confData: [String:[[String:Any]]] = [
    "servers": [
        [
            "name":"estate_score_swift_server",
            "port":HTTPport,
            "routes":[],
            "filters":[]
        ]
    ]
]

do {
    // Launch the servers based on the configuration data.
    try HTTPServer.launch(configurationData: confData)
} catch {
    // fatal error launching one of the servers
        fatalError("\(error)")
}

点击运行 -> 出现弹框提示 -> 允许

Xcode 控制台输出如下

打开浏览器输入 0.0.0.0:8180

因为还没有 web 文件，所以提示 找不到文件。不过已经可以证明 httpServer 已经创建并启动成功了。

② 增加拦截器和路由

项目默认使用 Swift Package Manager 做三方管理
查看 Package.swift 文件

添加如下代码

.package(url: "https://github.com/SwiftORM/Postgres-Storm.git", "3.0.0"..<"4.0.0")

dependencies: ["PerfectHTTPServer",
               "PostgresStORM"]

编辑好后，进入终端
清理 .build 文件夹缓存的三方文件

$ swift package clean

重新下载编译项目，此处为了下载 Postgres-Storm 及 其他相关依赖项

$ swift build

正如上文所说，刚才增加了 Postgres-Storm 三方库，所以需要重新生成 .xcodeproj

$ swift package generate-xcodeproj

在”Library Search Paths“检索项目软件库中增加
$(PROJECT_DIR) 选择 Recursive

创建 Routes.swift 文件，编辑代码如下

import PerfectHTTP
import StORM

class Handlers {

    // Basic "main" handler - simply outputs "Hello, world!"
    static func main(data: [String:Any]) throws -> RequestHandler {
        return {
            request, response in
            let scoreArray: [String: Any] = ["status": "200",
                                             "message": "hello, world!"]
            let jsonString = try? scoreArray.jsonEncodedString()
            response.setBody(string: jsonString ?? "")
            response.completed()
        }
    }
}

创建 Filters.swift 文件，编辑代码如下

import PerfectHTTPServer

func filters() -> [[String: Any]] {

    var filters: [[String: Any]] = [[String: Any]]()
    filters.append(["type":"response","priority":"high","name":PerfectHTTPServer.HTTPFilter.contentCompression])

    return filters
}

创建 Routes.swift 文件，编辑代码如下

import PerfectHTTPServer

func mainRoutes() -> [[String: Any]] {

    var routes: [[String: Any]] = [[String: Any]]()

    // Handler for home page
    routes.append(["method":"post", "uri":"/", "handler":Handlers.main])

    return routes
}

编辑 main.swift , 增加如下代码

// Load Filters
confData["servers"]?[0]["filters"] = filters()

// Load Routes
confData["servers"]?[0]["routes"] = mainRoutes()

按 command+b 编译代码会发现项目文件报错。这是因为 工程文件没有刚才创建的三个文件路径，需要我们在终端重新生成工程文件

$ swift package generate-xcodeproj

在”Library Search Paths“检索项目软件库中增加
$(PROJECT_DIR) 选择 Recursive

再次按 command+b 编译代码，编译成功！

4. 使用 postman 验证

按 command+r 运行项目，Xcode 控制台输出如下图，证明项目运行成功

下载 postman 并打开，如图步骤进行验证

一个超级简单的 api 接口就实现了

请求地址	http://0.0.0.0:8180
请求参数	–
返回参数	status : 状态码 message: 消息

5. Demo 地址

链接 Demo 01

6. 后面我们会继续拓展这个项目

1. 实现与 PostgreSQL 数据库的链接和查询
2. 解析具有参数的网络请求