前言
對(duì)于Swift開發(fā)者來(lái)說也許大家也聽說過SwiftWeb服務(wù)開發(fā),我自己也是個(gè)愛折騰的人下面記錄了我折騰SwiftWeb最終弄出來(lái)的東西(Demo)崭添。
github: https://github.com/SwiftFS/SwiftFSChina
效果圖 http://swiftfs.org/
框架選擇
總所周知,在swiftWeb服務(wù)器框架比較出名的是Perfect,Vapor,Kitura,我花了2天對(duì)比最終選擇了主(http)框架選擇了perfecr原因如下:
1.首先忽略了Kitura，原因是雖然IMB是一個(gè)很出名的公司叛氨，但他的SwiftWeb框架組件并不豐富呼渣，沒有slack棘伴。
2.在vapor和perfect中，vapor最大的優(yōu)勢(shì)是社區(qū)活躍度非常高屁置，slack加入人數(shù)也是最多的,開發(fā)人員也是對(duì)外的,而且經(jīng)常文檔寫的非常好焊夸，而他出的項(xiàng)目也非常的人性化如：他有一個(gè)vapor cli可以非常輕松的在linux下安裝swift環(huán)境,leaf模板也是非常強(qiáng)大。不足的地方我感覺就是功能沒perfect強(qiáng)大了蓝角。當(dāng)然這個(gè)項(xiàng)目也集成了他的幾個(gè)子package
3.perfect據(jù)我了解主開發(fā)人員比較少（可以到github上看到）而且他的團(tuán)隊(duì)是公司性質(zhì)的阱穗，全部項(xiàng)目幾個(gè)人一手包辦，羨慕他們這些技術(shù)牛人使鹅。perfect的優(yōu)勢(shì)是他家出的產(chǎn)品非常強(qiáng)大如：用swift玩轉(zhuǎn)tensorflow揪阶，swift版kafka,swift版ZooKeeper,而且perfect公司還弄了個(gè)用swift開發(fā)android的,具體可以自己谷歌。
web功能也是比較豐富的例如:
1.session的處理 perfect 分別集成了 mysql,postgressql,redis并徘，
2.可以自己添加過濾器
3.后面文章也會(huì)提及
不足的地方就是雖然有中文文檔但文檔并不人性化遣钳，有點(diǎn)亂，幾個(gè)模板項(xiàng)目運(yùn)行都有問題
ps:這里不討論性能那個(gè)快那個(gè)慢麦乞，在框架不成熟的情況比這些沒意義蕴茴。
模塊選擇
這個(gè)項(xiàng)目用到的模塊要有 數(shù)據(jù)庫(kù)連接,網(wǎng)頁(yè)模板,日志,加密,session,redis,json...
下面列舉用到的相應(yīng)package 順帶吐槽一下。
1.數(shù)據(jù)庫(kù)用的是mysql,這里本來(lái)是應(yīng)該用perfect家提供的mysql鏈接庫(kù)的和orm的姐直，但是在實(shí)踐中發(fā)現(xiàn)該框架并沒有支持連接池技術(shù)倦淀。而且沒有時(shí)間的認(rèn)證，我沒有選擇ORM框架声畏。無(wú)可厚非這東西并不成熟,這并不是rails, hibernat撞叽。最終選擇mysql-swift
2.日志功能直接使用perfect提供的，perfect提供了比較全面的日志方案
3.session 處理的perfect是提供比較好的方案插龄，像上面提及的 它家提供了mysql,postgressql,redis解決方案愿棋，便于以后做集群方案處理。但是因?yàn)閙ysql-session與mysql-swiftpackage會(huì)沖突的原因均牢，最后選擇用redis作為session存儲(chǔ)方案
4.模板的話糠雨，本來(lái)是用Perfect-Mustache的,但考慮到Mustache模板邏輯處理能力太弱了也不便于開發(fā)，最后對(duì)比leaf和stencil,最后選擇stencil,這里介紹一下stencil模板徘跪，stencil非常強(qiáng)大甘邀，start數(shù)也很多，支持繼承垮庐，支持自定義語(yǔ)法松邪，大家可以了解一下。
5.加密技術(shù)用到bcrypt package由vapor提供
6.OAuth2 這里用perfect提供的
7.模型轉(zhuǎn)->JSON處理 因?yàn)槭莝wift3的關(guān)系(swift4官方會(huì)提供方法)這里選擇了阿里的handyjson,但是handyjson并不能在linux下運(yùn)行哨查，所以要修改他的源碼逗抑，可以用handyjson的好處是支持自定添加轉(zhuǎn)換類型,可以將Date和各種自定義類型進(jìn)行轉(zhuǎn)換處理
在linux上運(yùn)行
直接使用vapor 提供的 vapor cli 然后使用它安裝swift配置環(huán)境 下載本項(xiàng)目他會(huì)提示你所需要的包你只需要 按照其提示即可，如果報(bào)了 #<uuid/uuid>的錯(cuò)誤 需要安裝uuid相關(guān)庫(kù).
代碼分析：
創(chuàng)建一個(gè)filter 用于驗(yàn)證用戶
configuration/Filter.swift
filters.append(["type":"request","priority":"high","name":CheckLogin])
filter/CheckLogin
//檢查有沒登錄
public func CheckLogin(data: [String:Any]) throws -> HTTPRequestFilter {
return checklogin()
}
struct checklogin:HTTPRequestFilter {
func is_login(req:HTTPRequest) -> [String:Any]? {
guard req.session != nil else {
return nil
}
guard let user:[String:Any] = req.session!.data["user"] as? [String : Any] else{
return nil
}
return user
}
func filter(request: HTTPRequest, response: HTTPResponse, callback: (HTTPRequestFilterResult) -> ()) {
guard let st = request.header(HTTPRequestHeader.Name.accept) else{
callback(.execute(request, response))
return
}
guard st.components(separatedBy: "text/html").count > 1 else {
callback(.execute(request, response))
return
}
let requestPath = request.path
var in_white_list = false
var islogin = false //已經(jīng)登錄
if requestPath == "http://" {
in_white_list = true
}else{
for address in whitelist{
if address.components(separatedBy: requestPath).count > 1
{
in_white_list = true
break
}
}
}
//判斷是否登錄
let user = is_login(req: request)
if (user != nil) {
if user?["username"] != nil && user?["userid"] != nil && (user!["username"] as? String != "") && (user!["userid"] as? Int != 0){
islogin = true
}
}
//域?qū)ο? PageHandlers處理
let dic:[String:Any] = [ "login":islogin
,"username":user?["username"] ?? ""
,"userid":user?["userid"] ?? 0
,"create_time":user?["create_time"] ?? ""]
if in_white_list {
request.scratchPad["locals"] = dic
callback(.continue(request, response))
}else{
if islogin {
request.scratchPad["locals"] = dic
request.session!.data.updateValue(true, forKey: "login")
callback(.continue(request, response))
}else{
if let st = request.header(HTTPRequestHeader.Name.accept){
//如果是接口請(qǐng)求
if st.components(separatedBy: "application/json").count > 1 {
callback(.execute(request, response))
do{
try response.setBody(json: ["success":false,"msg":"該操作需要先登錄"])
response.completed()
}catch{
Log.error(message: "\(error)")
}
}else{
response.redirect(path: "/login")
}
}
}
}
}
}
使用sctencil 作為模板
原理 使用responet.setbody 輸出http
extension HTTPResponse {
public func render(template: String, context: [String: Any] = [String: Any]()) {
//設(shè)置路徑
let fsLoader = FileSystemLoader(paths: ["webroot/views"])
let environment = Environment(loader: fsLoader)
do{
let stencil = try environment.renderTemplate(name: "\(template)"+".html", context: context)
self.setBody(string: stencil)
self.completed()
}catch{
Log.error(message: "\(error)")
}
}
}
因?yàn)槭?html 文件 所以在xcode上編輯有顏色，強(qiáng)烈推薦sctencil
上傳圖片
static func avatar(data:[String:Any]) throws -> RequestHandler{
return {
req,res in
do{
let fileDir = Dir(Dir.workingDir.path + "webroot/avatar")
do {
try fileDir.create()
} catch {
Log.error(message: "\(error)")
}
let upload = uploads[0]
let thisFile = File(upload.tmpFileName)
let date = NSDate()
let timeInterval = date.timeIntervalSince1970
let hashName = "\(timeInterval.hashValue)"
var type:String?
let typeArray = upload.contentType.components(separatedBy: "/")
guard typeArray.count >= 2 else {
try res.setBody(json: ["success":false,"msg":"獲取類型出錯(cuò)"])
res.completed()
return
}
type = typeArray[1]
let picName = hashName + "." + type!
let _ = try thisFile.moveTo(path: fileDir.path + picName, overWrite: true)
let judge = try UserServer.update_avatar(avatar: picName, userid: user_id)
guard judge != false else {
try res.setBody(json: ["success":false,"msg":"上傳失敗"])
res.completed()
return
}
try res.setBody(json: ["success":true,"originFilename":upload.tmpFileName,"filename":picName])
res.completed()
}catch{
Log.error(message: "\(error)")
}
}
}
后記
對(duì)swiftWeb有興趣的小伙伴們可以加入qq群:514517311
