Route Collections

路由集合允许将多个路由和路由组组织在不同的文件或模块中。

Example

---

以下是v1API部分的路由集合示例:

import Vapor
import HTTP
import Routing

class V1Collection: RouteCollection {
    typealias Wrapped = HTTP.Responder
    func build<B: RouteBuilder where B.Value == Wrapped>(_ builder: B) {
        let v1 = builder.grouped("v1")
        let users = v1.grouped("users")
        let articles = v1.grouped("articles")

        users.get { request in
            return "Requested all users."
        }

        articles.get(Article.self) { request, article in
            return "Requested \(article.name)"
        }
    }
}

这个类可以放在任何文件中，可以将它添加到vapor或甚至添加到另一个路由组中。

let v1 = V1Collection()
drop.collection(v1)

然后Droplet将build(_:)方法传递给路由集合，并添加各种路由。

Breakdown

---

我们逐一分解路由集合，来了解它们到底生发了什么。

typealias Wrapped = HTTP.Responder

这限制了路由集合只添加HTTP响应。虽然底层路由器能够路由任何类型，但Vapor只针对HTTP响应者。如果在vapor要使用这个路由集合，首先它的包裹类型需要匹配。

func build<B: RouteBuilder where B.Value == Wrapped>(_ builder: B) {

这个方法接收一个路由构造器并通过接收Wrapped来验证路由构造器，如上一行所定义，HTTP.Responders。vapor的Droplet和Vapor创建的任何路由组都是只接受HTTP响应的RouteBuilders。

let v1 = builder.grouped("v1")

从上面代码看出，照常可以通过builder来创建路由。builder:B同样像Droplet或路由组一样工作。任何在Droplet和路由组上工作的方法都可以在这个builder上工作。

Empty Initializable

---

如果有空的init方法，可以将EmptyInitializable添加到路由集合。这允许通过其类型名称添加路线集合。

class V1Collection: RouteCollection, EmptyInitializable {
    init() { }
    ...

现在我们可以添加到集合而不初始化它。

drop.collection(V1Collection.self)

---

继续学习vapor学习教程-目录