Vapor文档学习一 :Droplet

图片源于网络

官网: 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都是更新到了最新版本就可以创建Hello项目了。
终端,cd到合适的目录:

$ vapor new Hello

Hello.png

出现上面的图片就证明新建Hello项目成功了。实际上是从github上拉取框架基础模板。
如果你想使用xcode编辑,执行下面的命令:

$ cd Hello
$ vapor xcode -y   //-y表示立即打开xcode

运行看看?
在项目根目录,也就是Hello目录下:

$ vapor build

首次运行等待时间比较长,然后

$ vapor run  //或:  $ vapor run serve

如果是使用xcode开发则不用使用命令行运行服务器。如下图将targets切换为app,然后cmd + R即可运行。

切换targets

然后浏览器打开:http://localhost:8080
会显示如下页面:

It works

GUIDE

这部分介绍了Vapor框架的基础知识,我现在是是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版本就可以了。
再次强调下,如果想往下看,先看官方文档 GETTING STARTED部分,先了解Vapor的安装和运行。如过遇到任何问题,欢迎留言一起探讨。

1,Droplet

旧版本中是Application这个类,现在使用的是Droplet类,这个类管理着Vapor的很多特性,包括路由的注册、server的运行、拼接middleware等等。

1.1,初始化Droplet

创建一个空的Drolet实例,找到工程目录中的main.swift文件(里面有默认的代码,你可以删掉自己写),首先引入Vapor,然后直接实例化。

import Vapor
let drop = Droplet()
// your magic here
drop.run()
1.2,Environment

运行环境属性,包括:development(默认), testing, production三种,分别是开发环境、测试环境、生产环境。用法也很简单,就是根据不同的运行环境进行日志打印、配置参数等操作,方便在开发时调试、生产时精简应用包。

if drop.environment == .production
       ...
}

通过以下指令指定运行环境:

$vapor run serve --env=production

如果使用Xcode进行开发,可以通过scheme editor传递运行环境的参数

Note: Debug输出会降低应用每秒的请求量,所以生产环境下可以提高这方面的表现。

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。下面的例子就是实现在生产环境下打印邮件错误日志,但是不会在开发环境下向你的邮箱发送垃圾邮件。

let drop = Droplet()
drop.addConfigurable(log: MyEmailLogger.self, name: "email")

Droplet会继续使用默认的日志打印,除非你修改了Config/droplet.json文件来指定为邮件错误打印 . 在Config/production/droplet.json进行如下修改后,这个错误打印只会在生产环境下起作用。

{
    "log": "email"
}
1.4.3 Initialization(初始化修改)

Droplet的初始化十分简单并且提供了大多数属性的修改,这个Xcode编程的话可以点击Droplet查看源码。
大多数Vapor的插件都是来自Provider,这个可以查看Provider的章节。

Droplet(
       arguments: <#T##[String]?#>,
       workDir: <#T##String?#>, 
       environment: <#T##Environment?#>, 
       config: <#T##Config?#>, 
       localization: <#T##Localization?#>, 
       log: <#T##LogProtocol?#>
)

Note: 记住初始化时使用的是默认的属性,这也就是说在你修改属性之前要确保其他部分的代码还没有使用你要修改的属性,否则会造成时而使用默认属性、时而使用修改的属性而产生的混乱的结果。(没事别瞎改,改要改完全。)

<b>总结:</b>Droplet大概就介绍了其初始化方法、Environment、workDir等属性以及如何修改器属性。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 161,192评论 4 369
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 68,186评论 1 303
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 110,844评论 0 252
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,471评论 0 217
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,876评论 3 294
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,891评论 1 224
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 32,068评论 2 317
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,791评论 0 205
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,539评论 1 249
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,772评论 2 253
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,250评论 1 265
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,577评论 3 260
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,244评论 3 241
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,146评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,949评论 0 201
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,995评论 2 285
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,812评论 2 276

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,633评论 4 59
  • 脚本合集 通过键盘给定两个数字 ,输出其中较大的值 !/bin/bash if [ $1 -gt $2 ];the...
    魏镇坪阅读 1,620评论 0 3
  • 王家大院位于西安长安区翠华山水泥厂向东500米,是集农家美食、特色住宿和户外休闲为一体的农家乐。 特色美食:土鸡、...
    西安百晓生阅读 937评论 0 0
  • 高一分班,我和Y同学分到一个班。有一天发本子我不小心把Y同学的本子发到了他同桌那,他同桌把本子扔给他,我才知道他...
    txdyc_28456阅读 279评论 1 1