苹果宣布 Swift 这门现代编程语言开源,我们就能够预见这门优雅语言的无限可能,而 Vapor 便是实现其用于服务器端开发可能的 Web 框架之一。
上手前的准备
Vapor 用 Swift 3 进行开发,因此必须先能够安装 Swift 3 的运行环境,而 Swift 暂时还只能在 macOS 和 Ubuntu 下编译运行。而这次的上手教程,将在 macOS 下进行。
先安装 Swift 3
在 macOS 下安装 Swift 3 十分容易,去 Mac App Store 下载安装 Xcode 8,并将其运行一次便好了。
在终端运行下面这行命令进行兼容性检查,确保 Swift 3 已正确安装
curl -sL check.vapor.sh | bash
安装 Vapor Toolbox
安装 Vapor 工具十分简单,通过终端下载并运行官方提供的脚本即可自动安装
curl -sL toolbox.vapor.sh | bash
vapor --help // 确认是否安装成功
vapor self update // 升级最新版本以避免一些未知错误发生
创建 Vapor 新项目
进入存放项目的目录下,通过 Vapor Toolbox 快速创建
vapor new MyFirstVaporServer
这为我们创建了一个示例项目,文件结构基本如下
.
├── App
│ └── Controllers
│ └── Middleware
│ └── Models
│ └── main.swift
├── Public
├── Resources
│ └── Views
└── Package.swift
那么让我们先来关注 App 目录下的 main.swift
文件
Droplet 组件
let drop = Droplet()
在这个示例项目中,我们只创建了 Droplet
,这个类在 Vapor 中发挥着举足轻重的作用,接下来将不断用到它。
Routing 路由
drop.get("hello") { request in
return "Hello, world!"
}
这几行代码用 Droplet
创建了用 Get
方式访问到 /hello
的路由,并给出了返回值。
运行 Droplet
drop.run()
在 main.swift
的最后,启动 Droplet 实例。
编译运行
回到终端,对项目进行编译,并运行
vapor build
vapor run serve
此时,通过浏览器访问:http://localhost:8080/hello
,就可以看见 Vapor 和你 say Hi 了。