Basics

In Vapor the default Router is the TrieRouter. You can implement custom routers by implementing one conformant to the Router protocol.

let router = try app.make(Router.self)

There are two APIs available, one is supplied by the Routing library and a set of helpers is available in Vapor itself.

Registering a route using Routing

The on function on a AsyncRouter registers a route to the provided path. The following registers a GET /hello/world route.

It responds with "Hello world!" using futures.

router.on(.get, to: "hello", "world") { request in
  return Future(try Response(body: "Hello world!"))
}

The .get represents the Method you want to use. to: "hello", "world" registers the path /hello/world.

For variable path components you can use parameters.

The trailing closure receives a Request. The route can throw errors and needs to return a Future<ResponseRepresentable> conforming type.

In Vapor we add support for routes using the .get, .put, .post, .patch and .delete shorthands.

For variable path components you can use parameters here, too.

Vapor has an added benefit here in that you can return the Response itself in addition to Future<ResponseRepresentable> or Future<Response>.

drop.get("components", "in", "path") { request in
  return Response(status: .ok)
}