基于Swift的Web框架Vapor2.0文檔(翻譯)Hello,World

轉(zhuǎn)載請(qǐng)附原文鏈接:http://blog.fandong.me/2017/08/04/iOS-SwiftVaporWeb04/

前言

之前一直有做Java后臺(tái)開發(fā)的興趣,可是想到要看好多的Java教程,作為一個(gè)iOS開發(fā)者,我放棄了,
后來(lái)從朋友韓云智VL那里知道了這個(gè)框架,竟是用Swift寫的,不得不說(shuō),它燃起了我的興趣。
Vapor是一個(gè)基于Swift開發(fā)的服務(wù)端框架,可以工作于iOS,Mac OS,Ubuntu。
為了配合Swift部署到服務(wù)器,我把ECS的服務(wù)器系統(tǒng)改為Ubuntu16.04。

Vapor 2.0 - 文檔目錄
以下文字翻譯自Vapor Docs/Getting started/Hello,World

Hello,World

這個(gè)章節(jié)需要你已經(jīng)安裝了Swift3.1以及Vapor工具箱并且確認(rèn)他們正在工作

提示
如果你不想要使用工具箱,請(qǐng)移步手動(dòng)指引

新工程

讓我們開始常見(jiàn)一個(gè)叫“Hello,World的新工程”

vapor new Hello --template=api

如果你已經(jīng)使用過(guò)其他網(wǎng)絡(luò)框架之后,你會(huì)對(duì)Vapor的目錄結(jié)構(gòu)很熟悉。

Hello
├── Config
│   ├── app.json
│   ├── crypto.json
│   ├── droplet.json
│   ├── fluent.json
│   └── server.json
├── Package.pins
├── Package.swift
├── Public
├── README.md
├── Sources
│   ├── App
│   │   ├── Config+Setup.swift
│   │   ├── Controllers
│   │   │   └── PostController.swift
│   │   ├── Droplet+Setup.swift
│   │   ├── Models
│   │   │   └── Post.swift
│   │   └── Routes.swift
│   └── Run
│       └── main.swift
├── Tests
│   ├── AppTests
│   │   ├── PostControllerTests.swift
│   │   ├── RouteTests.swift
│   │   └── Utilities.swift
│   └── LinuxMain.swift
├── circle.yml
└── license

對(duì)于我們的Hello,World工程,我們將會(huì)關(guān)注Route.swift文件

Hello
└── Sources
    └── App
        └── Routes.swift

提示
vapor new這個(gè)命令會(huì)創(chuàng)建一個(gè)包含例子和描述怎么使用這個(gè)框架的新工程,如果你愿意你也可以刪除它

代碼

Droplet

在Routes.swift文件中看下面這行

func setupRoutes() throws

這是所有訪問(wèn)我們應(yīng)用程序的路由都會(huì)添加的方法

路由

build方法的范圍內(nèi),查找以下的陳述

get("plaintext"){ req in
    return "Hello,world!"
}

這行代碼創(chuàng)建了一個(gè)新的路由,這個(gè)路由會(huì)匹配所有的到/plaintext的GET請(qǐng)求
所有的路由閉包都傳遞一個(gè)包含所請(qǐng)求的URI和發(fā)送的數(shù)據(jù)等信息的請(qǐng)求的實(shí)例
這個(gè)路由只是簡(jiǎn)單的返回了一個(gè)字符串,但是任何一個(gè)可以表示響應(yīng)的都可以被返回,在指引的路由章節(jié)學(xué)習(xí)更多

提示
Xcode會(huì)自動(dòng)完成添加外部類型信息到你的閉包的輸入?yún)?shù)中,如果你愿意保持原有類型信息,在文件頂部添加import HTTP

編譯&運(yùn)行

Building

Swift最先進(jìn)的編譯器是使得Vapor變得很強(qiáng)大的重要部分,讓我們動(dòng)起來(lái),確保你在工程的根目錄,運(yùn)行下面的程序進(jìn)行編譯

vapor build

筆記
vapor build會(huì)在后臺(tái)運(yùn)行swift build

Swift包管理器會(huì)在第一時(shí)間從git上下載相關(guān)聯(lián)的依賴,接下來(lái)一起編譯和鏈接這些依賴
當(dāng)完成的時(shí)候你會(huì)看到Building Project[Done]

提示
如果你看到unable to execute command: Killed這條消息,你需要增加你的交換空間的大小,這只有在你運(yùn)行在一個(gè)有限的內(nèi)存空間的機(jī)器上才會(huì)出現(xiàn)

Release

在release模式下編譯會(huì)消耗更多的時(shí)間,但是提升了體驗(yàn)

vapor build --release

Serving

運(yùn)行如下命令啟動(dòng)這個(gè)服務(wù)

vapor run serve

你應(yīng)該會(huì)看到Server starting....這條消息
你現(xiàn)在可以在瀏覽器訪問(wèn)localhost:8080/plaintext或者運(yùn)行

curl localhost:8080/plaintext

筆記
指定一個(gè)端口號(hào)需要管理員權(quán)限,你可以通過(guò)運(yùn)行sudo vapor run來(lái)獲取權(quán)限,如果你決定運(yùn)行在80之外的其他端口,請(qǐng)確保你的瀏覽器也按照這個(gè)端口進(jìn)行訪問(wèn)

Hello,World

你應(yīng)該可以在你的瀏覽器窗口中看到如下的輸出

Hello,world!

成功
到現(xiàn)在,你喜歡上Vapor了嗎?點(diǎn)擊下面的按鈕來(lái)star這個(gè)倉(cāng)庫(kù)幫助發(fā)揚(yáng)光大

Github

生產(chǎn)環(huán)境

在生產(chǎn)環(huán)境運(yùn)行服務(wù)會(huì)增強(qiáng)他的安全性和體驗(yàn)

vapor run serve --env=production

再生產(chǎn)環(huán)境,debug消息會(huì)靜默,所以錯(cuò)誤可以通過(guò)查看日志來(lái)發(fā)現(xiàn)

警告
如果你是在--releaseflag標(biāo)記下編譯的,確保你也在vapor run的時(shí)候添加上此flag,vapor run serve --env=production --release

更多關(guān)于部署代碼的更多信息,請(qǐng)移步部署(Deploy)章節(jié)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

推薦閱讀更多精彩內(nèi)容

  • 轉(zhuǎn)載請(qǐng)附原文鏈接:http://blog.fandong.me/2017/08/06/iOS-SwiftVapor...
    范小兵閱讀 472評(píng)論 0 0
  • 簡(jiǎn)介 Vapor[https://vapor.codes/] 是一個(gè)基于純 Swift 構(gòu)建出的 Web 開發(fā)框架...
    isaced閱讀 2,654評(píng)論 6 10
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見(jiàn)模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,981評(píng)論 19 139
  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫(kù)、插件、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 12,251評(píng)論 4 61
  • 盡己力,聽天命。無(wú)愧于心,不惑于情。順勢(shì)而為,隨遇而安。知錯(cuò)就改,迷途知返。在喜歡自己的人身上用心,在不喜歡自己的...
    嵐風(fēng)的葉子閱讀 326評(píng)論 0 0