| Index: mojo/public/dart/third_party/shelf/lib/src/middleware.dart
|
| diff --git a/mojo/public/dart/third_party/shelf/lib/src/middleware.dart b/mojo/public/dart/third_party/shelf/lib/src/middleware.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..1d503d0845c9d173a11410f493587a24b960da11
|
| --- /dev/null
|
| +++ b/mojo/public/dart/third_party/shelf/lib/src/middleware.dart
|
| @@ -0,0 +1,76 @@
|
| +// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
|
| +// for details. All rights reserved. Use of this source code is governed by a
|
| +// BSD-style license that can be found in the LICENSE file.
|
| +
|
| +library shelf.middleware;
|
| +
|
| +import 'dart:async';
|
| +
|
| +import 'request.dart';
|
| +import 'response.dart';
|
| +import 'handler.dart';
|
| +import 'hijack_exception.dart';
|
| +
|
| +/// A function which creates a new [Handler] by wrapping a [Handler].
|
| +///
|
| +/// You can extend the functions of a [Handler] by wrapping it in
|
| +/// [Middleware] that can intercept and process a request before it it sent
|
| +/// to a handler, a response after it is sent by a handler, or both.
|
| +///
|
| +/// Because [Middleware] consumes a [Handler] and returns a new
|
| +/// [Handler], multiple [Middleware] instances can be composed
|
| +/// together to offer rich functionality.
|
| +///
|
| +/// Common uses for middleware include caching, logging, and authentication.
|
| +///
|
| +/// Middleware that captures exceptions should be sure to pass
|
| +/// [HijackException]s on without modification.
|
| +///
|
| +/// A simple [Middleware] can be created using [createMiddleware].
|
| +typedef Handler Middleware(Handler innerHandler);
|
| +
|
| +/// Creates a [Middleware] using the provided functions.
|
| +///
|
| +/// If provided, [requestHandler] receives a [Request]. It can respond to
|
| +/// the request by returning a [Response] or [Future<Response>].
|
| +/// [requestHandler] can also return `null` for some or all requests in which
|
| +/// case the request is sent to the inner [Handler].
|
| +///
|
| +/// If provided, [responseHandler] is called with the [Response] generated
|
| +/// by the inner [Handler]. Responses generated by [requestHandler] are not
|
| +/// sent to [responseHandler].
|
| +///
|
| +/// [responseHandler] should return either a [Response] or
|
| +/// [Future<Response>]. It may return the response parameter it receives or
|
| +/// create a new response object.
|
| +///
|
| +/// If provided, [errorHandler] receives errors thrown by the inner handler. It
|
| +/// does not receive errors thrown by [requestHandler] or [responseHandler], nor
|
| +/// does it receive [HijackException]s. It can either return a new response or
|
| +/// throw an error.
|
| +Middleware createMiddleware({requestHandler(Request request),
|
| + responseHandler(Response response),
|
| + errorHandler(error, StackTrace stackTrace)}) {
|
| + if (requestHandler == null) requestHandler = (request) => null;
|
| +
|
| + if (responseHandler == null) responseHandler = (response) => response;
|
| +
|
| + var onError = null;
|
| + if (errorHandler != null) {
|
| + onError = (error, stackTrace) {
|
| + if (error is HijackException) throw error;
|
| + return errorHandler(error, stackTrace);
|
| + };
|
| + }
|
| +
|
| + return (Handler innerHandler) {
|
| + return (request) {
|
| + return new Future.sync(() => requestHandler(request)).then((response) {
|
| + if (response != null) return response;
|
| +
|
| + return new Future.sync(() => innerHandler(request)).then(
|
| + (response) => responseHandler(response), onError: onError);
|
| + });
|
| + };
|
| + };
|
| +}
|
|
|