Vapor文檔學習一 :Droplet

圖片源于網(wǎng)絡

官網(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

Hello.png

出現(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即可運行。

切換targets

然后瀏覽器打開:http://localhost:8080
會顯示如下頁面:

It works

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馅精。Dropletrun的時候就會啟動自定義的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等屬性以及如何修改器屬性掂之。

最后編輯于
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末抗俄,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子世舰,更是在濱河造成了極大的恐慌动雹,老刑警劉巖,帶你破解...
    沈念sama閱讀 212,454評論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件跟压,死亡現(xiàn)場離奇詭異胰蝠,居然都是意外死亡,警方通過查閱死者的電腦和手機震蒋,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,553評論 3 385
  • 文/潘曉璐 我一進店門姊氓,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人喷好,你說我怎么就攤上這事《刘危” “怎么了梗搅?”我有些...
    開封第一講書人閱讀 157,921評論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長效览。 經(jīng)常有香客問我无切,道長,這世上最難降的妖魔是什么丐枉? 我笑而不...
    開封第一講書人閱讀 56,648評論 1 284
  • 正文 為了忘掉前任哆键,我火速辦了婚禮,結果婚禮上瘦锹,老公的妹妹穿的比我還像新娘籍嘹。我一直安慰自己闪盔,他們只是感情好,可當我...
    茶點故事閱讀 65,770評論 6 386
  • 文/花漫 我一把揭開白布辱士。 她就那樣靜靜地躺著泪掀,像睡著了一般。 火紅的嫁衣襯著肌膚如雪颂碘。 梳的紋絲不亂的頭發(fā)上异赫,一...
    開封第一講書人閱讀 49,950評論 1 291
  • 那天,我揣著相機與錄音头岔,去河邊找鬼塔拳。 笑死,一個胖子當著我的面吹牛峡竣,可吹牛的內(nèi)容都是我干的靠抑。 我是一名探鬼主播,決...
    沈念sama閱讀 39,090評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼澎胡,長吁一口氣:“原來是場噩夢啊……” “哼孕荠!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起攻谁,我...
    開封第一講書人閱讀 37,817評論 0 268
  • 序言:老撾萬榮一對情侶失蹤稚伍,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后戚宦,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體个曙,經(jīng)...
    沈念sama閱讀 44,275評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,592評論 2 327
  • 正文 我和宋清朗相戀三年受楼,在試婚紗的時候發(fā)現(xiàn)自己被綠了垦搬。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,724評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡艳汽,死狀恐怖猴贰,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情河狐,我是刑警寧澤米绕,帶...
    沈念sama閱讀 34,409評論 4 333
  • 正文 年R本政府宣布,位于F島的核電站馋艺,受9級特大地震影響栅干,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜捐祠,卻給世界環(huán)境...
    茶點故事閱讀 40,052評論 3 316
  • 文/蒙蒙 一碱鳞、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧踱蛀,春花似錦窿给、人聲如沸贵白。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,815評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽戒洼。三九已至,卻和暖如春允华,著一層夾襖步出監(jiān)牢的瞬間圈浇,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,043評論 1 266
  • 我被黑心中介騙來泰國打工靴寂, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留磷蜀,地道東北人。 一個月前我還...
    沈念sama閱讀 46,503評論 2 361
  • 正文 我出身青樓百炬,卻偏偏與公主長得像褐隆,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子剖踊,可洞房花燭夜當晚...
    茶點故事閱讀 43,627評論 2 350

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

  • 發(fā)現(xiàn) 關注 消息 iOS 第三方庫庶弃、插件、知名博客總結 作者大灰狼的小綿羊哥哥關注 2017.06.26 09:4...
    肇東周閱讀 12,066評論 4 62
  • 腳本合集 通過鍵盤給定兩個數(shù)字 德澈,輸出其中較大的值 !/bin/bash if [ $1 -gt $2 ];the...
    魏鎮(zhèn)坪閱讀 1,646評論 0 3
  • 王家大院位于西安長安區(qū)翠華山水泥廠向東500米歇攻,是集農(nóng)家美食、特色住宿和戶外休閑為一體的農(nóng)家樂梆造。 特色美食:土雞缴守、...
    西安百曉生閱讀 1,031評論 0 0
  • 高一分班,我和Y同學分到一個班镇辉。有一天發(fā)本子我不小心把Y同學的本子發(fā)到了他同桌那屡穗,他同桌把本子扔給他,我才知道他...
    txdyc_28456閱讀 291評論 1 1