官網(wǎng): http://qutheory.io
參考文章:http://www.appcoda.com/server-side-swift-vapor/
吐槽一下:1盖桥,簡書markdown不支持錨點蓖捶,所以搞不了目錄剑逃;
2,Vapor的中文文檔404了稍坯,還是讀原生英文的吧酬荞。
說明:這系列文章都是基于Vapor文檔的理解與翻譯搓劫,僅供個人學習使用。
Hello world
關于如何安裝Vapor混巧,我不打算寫了枪向,按照文檔來吧,還是建議使用Toolbox咧党,省心省力秘蛔,這個安裝好了就等于安裝好了Vapor。我使用$ brew install vapor
安裝總是失敗傍衡,最后是使用如下命令手動安裝的:
git clone git@github.com:vapor/toolbox.git
cd toolbox
swift build -c release
mv .build/release/Executable /usr/local/bin/vapor
安裝成功后深员,可以查看vapor
的所有指令:
$ vapor
會顯示:
Usage: vapor <new|build|update|run|fetch|clean|test|xcode|version|self|heroku>
假設你的xcode、swift都是更新到了最新版本就可以創(chuàng)建Hello
項目了蛙埂。
終端倦畅,cd到合適的目錄:
$ vapor new Hello
出現(xiàn)上面的圖片就證明新建
Hello
項目成功了。實際上是從github上拉取框架基礎模板绣的。如果你想使用
xcode
編輯叠赐,執(zhí)行下面的命令:
$ cd Hello
$ vapor xcode -y //-y表示立即打開xcode
運行看看?
在項目根目錄屡江,也就是Hello
目錄下:
$ vapor build
首次運行等待時間比較長燎悍,然后
$ vapor run //或: $ vapor run serve
如果是使用xcode開發(fā)則不用使用命令行運行服務器。如下圖將targets切換為app
盼理,然后cmd + R
即可運行。
然后瀏覽器打開:http://localhost:8080
會顯示如下頁面:
GUIDE
這部分介紹了Vapor框架的基礎知識俄删,我現(xiàn)在是是Swift3.1版本宏怔,如何查看?終端輸入下面的指令:
$ swift -version
輸出結果:
Apple Swift version 3.1 (swiftlang-802.0.51 clang-802.0.41)
Target: x86_64-apple-macosx10.9
關于切換swift版本畴椰,還是別折騰了臊诊,下載最新的Xcode,使用的最新的swift版本就可以了斜脂。
再次強調(diào)下抓艳,如果想往下看,先看官方文檔 GETTING STARTED
部分帚戳,先了解Vapor的安裝和運行玷或。如過遇到任何問題,歡迎留言一起探討片任。
1偏友,Droplet
舊版本中是Application
這個類,現(xiàn)在使用的是Droplet類对供,這個類管理著Vapor的很多特性位他,包括路由的注冊、server的運行、拼接middleware
等等鹅髓。
1.1舞竿,初始化Droplet
創(chuàng)建一個空的Drolet實例,找到工程目錄中的main.swift
文件(里面有默認的代碼窿冯,你可以刪掉自己寫)骗奖,首先引入Vapor
,然后直接實例化靡菇。
import Vapor
let drop = Droplet()
// your magic here
drop.run()
1.2重归,Environment
運行環(huán)境屬性,包括:development(默認), testing, production三種厦凤,分別是開發(fā)環(huán)境鼻吮、測試環(huán)境、生產(chǎn)環(huán)境较鼓。用法也很簡單椎木,就是根據(jù)不同的運行環(huán)境進行日志打印、配置參數(shù)等操作博烂,方便在開發(fā)時調(diào)試香椎、生產(chǎn)時精簡應用包。
if drop.environment == .production
...
}
通過以下指令指定運行環(huán)境:
$vapor run serve --env=production
如果使用Xcode進行開發(fā)禽篱,可以通過scheme editor傳遞運行環(huán)境的參數(shù)
Note: Debug輸出會降低應用每秒的請求量畜伐,所以生產(chǎn)環(huán)境下可以提高這方面的表現(xiàn)。
1.3躺率,Working Directory
workDir
屬性玛界,指定應用起始運行的文件夾,默認是應用的跟目錄悼吱。
可以再Droplet
初始化時設置慎框,也可以單獨設置,如下:
vapor run serve --workdir="/var/www/my-project"
啟動應用:
vapor run serve --workdir="/var/www/my-project"
1.4后添,Modifying Prperties(屬性修改)
Droplet
的屬性可以通過程序或者配置來進行更改
1.4.1 Pragrammtic(程序中修改)
Droplet
初始化之后笨枯,可以更改其屬性。
let drop = Droplet()
drop.server = MyServerType.self
上面的代碼就是采用自定義的Server
遇西,替換了默認的server馅精。Droplet
在run
的時候就會啟動自定義的server。
1.4.2 Configurable(配置項修改)
如果是在某種特定情況下更改Droplet
的屬性粱檀,可以使用addConfigrable
硫嘶。下面的例子就是實現(xiàn)在生產(chǎn)環(huán)境下打印郵件錯誤日志,但是不會在開發(fā)環(huán)境下向你的郵箱發(fā)送垃圾郵件梧税。
let drop = Droplet()
drop.addConfigurable(log: MyEmailLogger.self, name: "email")
Droplet
會繼續(xù)使用默認的日志打印沦疾,除非你修改了Config/droplet.json
文件來指定為郵件錯誤打印 . 在Config/production/droplet.json
進行如下修改后称近,這個錯誤打印只會在生產(chǎn)環(huán)境下起作用。
{
"log": "email"
}
1.4.3 Initialization(初始化修改)
Droplet
的初始化十分簡單并且提供了大多數(shù)屬性的修改哮塞,這個Xcode編程的話可以點擊Droplet查看源碼刨秆。
大多數(shù)Vapor的插件都是來自Provider
,這個可以查看Provider
的章節(jié)忆畅。
Droplet(
arguments: <#T##[String]?#>,
workDir: <#T##String?#>,
environment: <#T##Environment?#>,
config: <#T##Config?#>,
localization: <#T##Localization?#>,
log: <#T##LogProtocol?#>
)
Note: 記住初始化時使用的是默認的屬性衡未,這也就是說在你修改屬性之前要確保其他部分的代碼還沒有使用你要修改的屬性,否則會造成時而使用默認屬性家凯、時而使用修改的屬性而產(chǎn)生的混亂的結果缓醋。(沒事別瞎改,改要改完全绊诲。)
<b>總結:</b>Droplet
大概就介紹了其初始化方法送粱、Environment、workDir等屬性以及如何修改器屬性掂之。