ResourceController class abstract

Controller for operating on an HTTP Resource.

ResourceControllers provide a means to organize the logic for all operations on an HTTP resource. They also provide conveniences for handling these operations.

This class must be subclassed. Its instance methods handle operations on an HTTP resource. For example, the following are operations: 'GET /employees', 'GET /employees/:id' and 'POST /employees'. An instance method is assigned to handle one of these operations. For example:

    class EmployeeController extends ResourceController {
       Future<Response> createEmployee(...) async => Response.ok(null);

Instance methods must have Operation annotation to respond to a request (see also Operation.get,, Operation.put and Operation.delete). These methods are called operation methods. Operation methods also take a variable list of path variables. An operation method is called if the incoming request's method and present path variables match the operation annotation.

For example, the route /employees/[:id] contains an optional route variable named id. A subclass can implement two operation methods, one for when id was present and the other for when it was not:

    class EmployeeController extends ResourceController {
       // This method gets invoked when the path is '/employees'
       Future<Response> getEmployees() async {
        return Response.ok(employees);

       // This method gets invoked when the path is '/employees/id'
       Future<Response> getEmployees(@Bind.path("id") int id) async {
        return Response.ok(employees[id]);

If there isn't an operation method for a request, an 405 Method Not Allowed error response is sent to the client and no operation methods are called.

For operation methods to correctly function, a request must have previously been handled by a Router to parse path variables.

Values from a request may be bound to operation method parameters. Parameters must be annotated with Bind.path, Bind.query, Bind.header, or Bind.body. For example, the following binds an optional query string parameter 'name' to the 'name' argument:

    class EmployeeController extends ResourceController {
      Future<Response> getEmployees({@Bind.query("name") String name}) async {
        if (name == null) {
          return Response.ok(employees);

        return Response.ok(employees.where((e) => == name).toList());

Bindings will automatically parse values into other types and validate that requests have the desired values. See Bind for all possible bindings and for more details.

To access the request directly, use request. Note that the Request.body of request will be decoded prior to invoking an operation method.

Implemented types




acceptedContentTypes List<ContentType?>
Types of content this ResourceController will accept.
getter/setter pair
hashCode int
The hash code for this object.
no setterinherited
logger Logger
An instance of the 'liquidart' logger.
no setterinherited
nextController Controller?
Receives requests that this controller does not respond to.
no setterinherited
pathVariables Map<String, String>
Parameters parsed from the URI of the request, if any exist.
no setter
policy CORSPolicy?
The CORS policy of this controller.
getter/setter pairinherited
recycledState Null
Returns state information that is reused across instances of this type.
no setteroverride
request Request?
The request being processed by this ResourceController.
getter/setter pair
responseContentType ContentType
The default content type of responses from this ResourceController.
getter/setter pair
runtimeType Type
A representation of the runtime type of the object.
no setterinherited


applyCORSHeadersIfNecessary(Request req, Response resp) → void
didAddToChannel() → void
Lifecycle callback, invoked after added to channel, but before any requests are served.
didDecodeRequestBody(RequestBody body) → void
Callback to indicate when a request body has been processed.
documentComponents(APIDocumentContext context) → void
Tells this object to add its components to context.
documentOperationDescription(APIDocumentContext context, Operation operation) String?
Returns a documented description for operation.
documentOperationParameters(APIDocumentContext context, Operation operation) List<APIParameter?>
Returns a documented list of APIParameter for operation.
documentOperationRequestBody(APIDocumentContext context, Operation operation) APIRequestBody?
Returns a documented request body for operation.
documentOperationResponses(APIDocumentContext context, Operation operation) Map<String, APIResponse>
Returns a map of possible responses for operation.
documentOperations(APIDocumentContext context, String route, APIPath path) Map<String, APIOperation>
Tells this object to return all APIOperations it handles.
documentOperationSummary(APIDocumentContext context, Operation operation) String?
Returns a documented summary for operation.
documentOperationTags(APIDocumentContext context, Operation operation) List<String>
Returns a list of tags for operation.
documentPaths(APIDocumentContext context) Map<String, APIPath>
Tells this object to return all APIPaths it handles.
handle(Request request) FutureOr<RequestOrResponse>
The primary request handling method of this object.
handleError(Request request, dynamic caughtValue, StackTrace trace) Future
Sends an HTTP response for a request that yields an exception or error.
Links a controller to the receiver to form a request channel.
linkFunction(FutureOr<RequestOrResponse?> handle(Request request)) Linkable
Links a function controller to the receiver to form a request channel.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
receive(Request req) Future
Delivers req to this instance to be processed.
restore(Null state) → void
Provides a new instance of this type with the recycledState of this type.
toString() String
A string representation of this object.
willDecodeRequestBody(RequestBody body) → void
Callback invoked prior to decoding a request body.
willProcessRequest(Request req) FutureOr<RequestOrResponse>
Executed prior to handling a request, but after the request has been set.
willSendResponse(Response response) → void
Executed prior to Response being sent.


operator ==(Object other) bool
The equality operator.