基于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)
}