Vapor:基于Swift的类似于Laravel的服务端框架

发布时间：2020-12-14 07:16:49 所属栏目：百科来源：网络整理

导读：Quick Start Installing Swift 好像最新的OSX系统是自带Swift的，不过笔者本机的版本是2.1.1，而Vapor的要求是2.2以上版本，因此还是要来Swift.org官网来更新一波的。首先需要在这嘎达下载下安装文件，然后进行配置。 OSX 默认的OSX系统上的Swift安装的地址

Quick Start

Installing Swift

好像最新的OSX系统是自带Swift的，不过笔者本机的版本是2.1.1，而Vapor的要求是2.2以上版本，因此还是要来Swift.org官网来更新一波的。首先需要在这嘎达下载下安装文件，然后进行配置。

OSX

默认的OSX系统上的Swift安装的地址为：/Library/Developer/Toolchains。可以使用如下配置来使得可执行文件能够全局通用

$ export PATH=/Library/Developer/Toolchains/swift-latest.xctoolchain/usr/bin:"${PATH}"

Linux

首先需要安装下clang

$ sudo apt-get install clang

如果没有把Swift的工具链安装在系统根目录下，可以使用如下方式来讲Swift可执行命令设置为全局可用：

$ export PATH=/path/to/Swift/usr/bin:"${PATH}"

可以使用--version 参数来检查安装的Swift版本是否正确：

$ swift --version
Apple Swift version 2.2-dev (LLVM ...,Clang ...,Swift ...)

HelloWorld

最简单的基于Vapor的架构就是如下

Sources/
- main.swift
Pakcage.swift

其中Package.swift的内容如下：

import PackageDescription

let package = Package(
    name: "VaporApp",dependencies: [
        .Package(url: "https://github.com/qutheory/vapor.git",majorVersion: 0),.Package(url: "https://github.com/qutheory/vapor-stencil.git",majorVersion: 0)
    ]
)

而main.swift的内容为：

import Vapor

let server = Server()
server.run()

使用swift build进行编译，然后运行.build/debug/VaporApp即可得到如下输出结果：

Server has started on port 80

Clone

sudo apt-get install git
git clone git@github.com:qutheory/vapor-example.git

Compile

cd vapor-example
swift build --configuration release

Automatic Startup

如果需要整改网站自启动，则需要将如下配置放置到init目录下，/etc/init/vapor-example.conf

description "Vapor Example"

start on startup

exec /home/<USERNAME>/vapor-example/.build/release/VaporApp --port=80 --workDir=/home/<USERNAME>/vapor-example

这样已经可以执行自启动了：

sudo start vapor-example

API Overview

Server

如果需要创建一个服务器：

main.swift

import Vapor

let server = Server()
server.run()

也可以自定义需要启动的端口

server.run(port: 8080)

如果有时候端口不能监听，请确定你的端口是处于开启状态，可以使用apt-get ufw来进行简单的端口管理。

Routing

Vapor中的路由返回跟Lavarel中非常类似：

main.swift

Route.get("welcome") { request in
    return "Hello"
}

//...start server

这样所有关于 http://example.com/welcome 的请求都会返回响应： "Hello"。

JSON

返回JSON数据

Route.get("version") { request in
    return ["version": "1.0"]
}

所有对于 http://example.com/version 请求的返回都是简单的字典类： {"version": "1.0"} 以及 Content-Type: application/json.

Views

也可以返回HTML界面

Route.get("/") { request in
    return View(path: "index.html")
}

或者使用Stencil Stencil 模板。
index.stencil

<html>
    <h1>{{ message }}</h1>
</html>

Route.get("/") { request in
    return View(path: "index.stencil",context: ["message": "Hello"])
}

如果添加了 VaporStencil 依赖,只需要将视图文件放置到Resources 目录下即可。

Stencil

如果需要添加 VaporStencil,将如下依赖添加到 Package.swift.

Package.swift

.Package(url: "https://github.com/qutheory/vapor-stencil.git",majorVersion: 0)

Then set the StencilRenderer() on your View.renderers for whatever file extensions you would like to be rendered as Stencil templates.

main.swift

import VaporStencil

//set the stencil renderer
//for all .stencil files
View.renderers[".stencil"] = StencilRenderer()

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!