轉載請附原文鏈接:http://blog.fandong.me/2017/08/04/iOS-SwiftVaporWeb04/
前言
之前一直有做Java后臺開發(fā)的興趣,可是想到要看好多的Java教程,作為一個iOS開發(fā)者,我放棄了,
后來從朋友韓云智VL那里知道了這個框架,竟是用Swift寫的,不得不說,它燃起了我的興趣。
Vapor是一個基于Swift開發(fā)的服務端框架,可以工作于iOS,Mac OS,Ubuntu。
為了配合Swift部署到服務器,我把ECS的服務器系統(tǒng)改為Ubuntu16.04。
Vapor 2.0 - 文檔目錄
以下文字翻譯自Vapor Docs/Getting started/Hello,World
Hello,World
這個章節(jié)需要你已經(jīng)安裝了Swift3.1以及Vapor工具箱并且確認他們正在工作
提示
如果你不想要使用工具箱,請移步手動指引
新工程
讓我們開始常見一個叫“Hello,World的新工程”
vapor new Hello --template=api
如果你已經(jīng)使用過其他網(wǎng)絡框架之后,你會對Vapor的目錄結構很熟悉。
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
對于我們的Hello,World工程,我們將會關注Route.swift
文件
Hello
└── Sources
└── App
└── Routes.swift
提示
vapor new
這個命令會創(chuàng)建一個包含例子和描述怎么使用這個框架的新工程,如果你愿意你也可以刪除它
代碼
Droplet
在Routes.swift文件中看下面這行
func setupRoutes() throws
這是所有訪問我們應用程序的路由都會添加的方法
路由
在build
方法的范圍內(nèi),查找以下的陳述
get("plaintext"){ req in
return "Hello,world!"
}
這行代碼創(chuàng)建了一個新的路由,這個路由會匹配所有的到/plaintext的GET請求
所有的路由閉包都傳遞一個包含所請求的URI和發(fā)送的數(shù)據(jù)等信息的請求的實例
這個路由只是簡單的返回了一個字符串,但是任何一個可以表示響應的都可以被返回,在指引的路由章節(jié)學習更多
提示
Xcode會自動完成添加外部類型信息到你的閉包的輸入?yún)?shù)中,如果你愿意保持原有類型信息,在文件頂部添加import HTTP
編譯&運行
Building
Swift最先進的編譯器是使得Vapor變得很強大的重要部分,讓我們動起來,確保你在工程的根目錄,運行下面的程序進行編譯
vapor build
筆記
vapor build
會在后臺運行swift build
Swift包管理器會在第一時間從git上下載相關聯(lián)的依賴,接下來一起編譯和鏈接這些依賴
當完成的時候你會看到Building Project[Done]
提示
如果你看到unable to execute command: Killed
這條消息,你需要增加你的交換空間的大小,這只有在你運行在一個有限的內(nèi)存空間的機器上才會出現(xiàn)
Release
在release模式下編譯會消耗更多的時間,但是提升了體驗
vapor build --release
Serving
運行如下命令啟動這個服務
vapor run serve
你應該會看到Server starting....
這條消息
你現(xiàn)在可以在瀏覽器訪問localhost:8080/plaintext
或者運行
curl localhost:8080/plaintext
筆記
指定一個端口號需要管理員權限,你可以通過運行sudo vapor run
來獲取權限,如果你決定運行在80之外的其他端口,請確保你的瀏覽器也按照這個端口進行訪問
Hello,World
你應該可以在你的瀏覽器窗口中看到如下的輸出
Hello,world!
成功
到現(xiàn)在,你喜歡上Vapor了嗎?點擊下面的按鈕來star這個倉庫幫助發(fā)揚光大
生產(chǎn)環(huán)境
在生產(chǎn)環(huán)境運行服務會增強他的安全性和體驗
vapor run serve --env=production
再生產(chǎn)環(huán)境,debug消息會靜默,所以錯誤可以通過查看日志來發(fā)現(xiàn)
警告
如果你是在--release
flag標記下編譯的,確保你也在vapor run
的時候添加上此flag,vapor run serve --env=production --release
更多關于部署代碼的更多信息,請移步部署(Deploy)章節(jié)