Router class

A shelf Router routes requests to handlers based on HTTP verb and route pattern.

import 'package:shelf_router/shelf_router.dart';
import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart' as io;

var app = Router();

// Route pattern parameters can be specified <paramName>
app.get('/users/<userName>/whoami', (Request request) async {
  // The matched values can be read with params(request, param)
  var userName = request.params['userName'];
  return Response.ok('You are ${userName}');
});

// The matched value can also be taken as parameter, if the handler given
// doesn't implement Handler, it's assumed to take all parameters in the
// order they appear in the route pattern.
app.get('/users/<userName>/say-hello', (Request request, String userName) async {
  assert(userName == request.params['userName']);
  return Response.ok('Hello ${userName}');
});

// It is possible to have multiple parameters, and if desired a custom
// regular expression can be specified with <paramName|REGEXP>, where
// REGEXP is a regular expression (leaving out ^ and $).
// If no regular expression is specified `[^/]+` will be used.
app.get('/users/<userName>/messages/<msgId|\d+>', (Request request) async {
  var msgId = int.parse(request.params['msgId']!);
  return Response.ok(message.getById(msgId));
});

var server = await io.serve(app, 'localhost', 8080);

If multiple routes match the same request, the handler for the first route is called. If no route matches a request, a Response.notFound will be returned instead. The default matcher can be overridden with the notFoundHandler constructor parameter.