轉(zhuǎn)載請(qǐng)附原文鏈接:http://blog.fandong.me/2017/08/04/iOS-SwiftVaporWeb04/
前言
之前一直有做Java后臺(tái)開(kāi)發(fā)的興趣,可是想到要看好多的Java教程尚揣,作為一個(gè)iOS開(kāi)發(fā)者呜呐,我放棄了趁仙,
后來(lái)從朋友韓云智VL那里知道了這個(gè)框架物臂,竟是用Swift寫的骄蝇,不得不說(shuō)靡努,它燃起了我的興趣扭仁。
Vapor是一個(gè)基于Swift開(kāi)發(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)指引
新工程
讓我們開(kāi)始常見(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)光大
生產(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)
警告
如果你是在--release
flag標(biāo)記下編譯的捣染,確保你也在vapor run
的時(shí)候添加上此flag,vapor run serve --env=production --release
更多關(guān)于部署代碼的更多信息停巷,請(qǐng)移步部署(Deploy)章節(jié)