Swift on Server Tour 1 你的第一个 Server App 以及它背后的故事

在这一章中，我们将了解如何配置 Swift on Server 的开发环境，创建第一个 Server 上的 Hello, World. 在此之上，我们还要简单聊一聊访问 Server App 背后的一些技术细节.

配置 Swift on Server 的开发环境

得益于 Swift 开源的特性，Swift 也可以在 Linux 上进行开发，同样，在 Swift Server Workgroup 的努力下，VSCode 也可以成为一个称职的 Swift 编辑器，因此，为了让不同类型的用户都可以很好的阅读，本系列文章将使用 VSCode 作为编辑器。

安装 Swift

SSWG 发布了 swiftly 可以帮助大家在 Linux 上轻松的安装 Swift

curl -L https://swift-server.github.io/swiftly/swiftly-install.sh | bash
swiftly install latest

除此之外， Apple 的 Download Swift 也提供了不同平台的安装指南。

配置 VSCode

安装 Swift Extension for Visual Studio Code 插件即可

创建 Hello World

我创建了一个叫做 1 的文件夹，来存放本章的代码，你也可以像我一样，使用下面的命令创建

mkdir 1

作为一个 Swift 工程，我们第一件事就是创建一个 Package.swift 文件，来描述工程

// swift-tools-version:5.8
import PackageDescription

let package = Package(
    name: "HelloWorld",
    platforms: [
       .macOS(.v12)
    ],
    dependencies: [
        .package(url: "https://github.com/vapor/vapor.git", from: "4.77.0"),
    ],
    targets: [
        .executableTarget(
            name: "App",
            dependencies: [
                .product(name: "Vapor", package: "vapor")
            ]
        ),
    ]
)

随后，创建 1/Sources/App/main.swift 文件

import Vapor

let app = Application()

app.http.server.configuration.port = 8080

defer { app.shutdown() }

app.get { req async in
    "It works!"
}

try app.run()

在文件夹 1 的根目录中使用 swift run 运行代码，或者在 VSCode 的 Run & Debug 中点击执行

经过编译后，你会看到 Server 运行起来的提示

[Vapor] Server starting on http://127.0.0.1:8080

在浏览器中访问 http://127.0.0.1:8080, 此时你就会看到老朋友 It works 了

恭喜你，第一个 Server App 已经写好了！

浏览器是如何访问到 Server App 的？

要理解这个问题，我们可以从浏览器访问的地址 http://127.0.0.1:8080 入手，这个地址可以拆解成 3 部分

• http - 希望使用的协议名
• 127.0.0.1 - 希望访问的 IP 地址
• 8080 - 希望访问的 IP 地址所对应的机器的端口

当你按下回车的时候，浏览器会根据 HTTP 协议，制作出下如下内容

GET / HTTP/1.1
Host: 127.0.0.1:8080

随后这个内容会被送往 IP 地址 127.0.0.1 所代表的机器，找到 8080 这个端口，递给在这里等着的 Server App.

现在我们可以回顾一下 Server App 的代码做了什么

// 在本机的 8080 端口监听
app.http.server.configuration.port = 8080

// 如果有请求抵达，使用 GET 访问的路径 / 那么返回文字 It works!
app.get { req async in
    "It works!"
}

而事实上，我们的 Server App 传回的是像这样的内容

HTTP/1.1 200 OK
content-type: text/plain; charset=utf-8
content-length: 9

It works!

浏览器拿到这份数据后，首先通过 200 这个 HTTP 状态码得知请求成功，而 content-type 部分则告诉浏览器，传回的数据是使用 utf-8 字符编码的 text/plain（纯文本）内容长度是 9.

最终根据这些信息，浏览器决定在页面上为我们显示 It works! 这段文字

这有来有回的数据交换，便是一次最基础的 Server App 应用，在其背后便是 TCP/IP 网络协议在支撑，TCP/IP 协议非常精巧复杂，上面的 HTTP 只是 TCP/IP 四层结构中最顶端的应用层。

构建简单的 Server App 并不需要很多 TCP/IP 的知识，但随着业务增长，面临的问题逐渐复杂，了解 TCP/IP 能帮助我们解决很多问题，不过，这不在本系列文章的讨论范围了，请读者伴随着日后的业务需求，自行探索吧。

本章代码可以在 Github 上找到 https://github.com/kevinzhow/swift-on-server-tour

下章预告

在下一章中，我们开始使用 Vapor 连接数据库，完成对数据库的增删改查，并探索一下这些操作的背后是如何完成的。