Route Groups¶

Grouping routes together makes it easy to add common prefixes, middleware, or hosts to multiple routes.

Route groups have two different forms: Group and Grouped.

Group (without the "ed" at the end) takes a closure that is passed a RouteBuilder.

drop.group("v1") { v1 in
    v1.get("users") { request in
        // get the users
    }
}

Grouped returns a RouteBuilder that you can pass around.

let v1 = drop.grouped("v1")
v1.get("users") { request in
    // get the users
}

You can add middleware to a group of routes. This is especially useful for authentication.

drop.group(AuthMiddleware()) { authorized in 
    authorized.get("token") { request in
        // has been authorized
    }
}

You can limit the host for a group of routes.

drop.group(host: "vapor.codes") { vapor in
    vapor.get { request in
        // only responds to requests to vapor.codes
    }
}

Groups can be chained together.

drop.grouped(host: "vapor.codes").grouped(AuthMiddleware()).group("v1") { authedSecureV1 in
    // add routes here
}