基于Swift的Web框架Vapor2.0文档(翻译)Routing-Parameters

转载请附原文链接:http://blog.fandong.me/2017/08/09/iOS-SwiftVaporWeb10/

前言

之前一直有做Java后台开发的兴趣,可是想到要看好多的Java教程,作为一个iOS开发者,我放弃了,
后来从朋友韩云智VL那里知道了这个框架,竟是用Swift写的,不得不说,它燃起了我的兴趣。
Vapor是一个基于Swift开发的服务端框架,可以工作于iOS,Mac OS,Ubuntu。
为了配合Swift部署到服务器,我把ECS的服务器系统改为Ubuntu16.04。

Vapor 2.0 - 文档目录
以下文字翻译自Vapor Docs/Routing/Parameters

路由参数

传统的Web框架通过使用路由参数名称和类型的字符串为路由留出错误控件,Vapor提取了Swift闭包的优势提供更安全和更直观的访问路由参数的方法.

也可以看看
路由参数是指URL路径的一部分(例如:/users/:id)对于查询参数(例如:?foo=bar),请查阅请求查询参数

类型安全

要创建一个类型安全的路由,只需要用一个类型替换你路径中的一部分

drop.get("users",Int.parameter){ req in
    let userId = try req.parameters.next(Int.self)
    return "You requester User #\(userId)"
}

这将创建一个匹配路径users/:id的路由,其中:id是一个Int类型,这是手动设置路由参数的样子

drop.get("users",":id"){ request in
    guard let userId = request.parameters["id"]?.int else{
        throw Abort.badRequest
    }
    return "You requested User #\(userId)"
}

这里你可以看到类型安全路由保存了~3行代码,并且还可以防止运行时错误,如拼写错误:id

可参数化

任何遵循可参数化的都可以被用作参数,默认情况下所有的Vapor Models都符合
使用这一点,我们之前关于用户的例子可以进一步简化

drop.get("users",User.parameter){ req in
    let user = try req.parameters.next(User.self)
    return "You requested \(user.name)"
}

这里提供的标识符将自动用于查找用户,举个例子,如果/users/5被请求,会去找一个具有标识符5的用户,如果找到了,则请求成功并且调用关闭,如果没有找到,则抛出未找到的错误
这里展示的是手动查找模型的方法

drop.get("users",Int.parameters){ req in
    let userId = try req.parameters.next(Int.self)
    guard let user = try User.find(userId) else{
        throw Abort.notFound
    }
    return "You requested \(user.name)"
}

协议

你可以符合自己的可参数化的类型

import Routing

extension Foo:Parameterizable {
    ///This unique slug is used to identify
    ///the parameter in ther router
    static var uniqueSlug: String{
        return "foo"
    }
    static func make(for parameter : String) throws -> Foo{
        ///custom lookup logic here
        ///the parameter string contains the infomation
        ///parsed from the URL.
        ...
    }
}

现在你可以使用这个类型进行类型安全的路由

drop.get("users","nickname",Foo.parameter) { req in
    let foo = try req.parameters.next(Foo.self)
}

类型安全参数也适用于

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

推荐阅读更多精彩内容