| Index: pkg/shelf/lib/src/middleware.dart
|
| diff --git a/pkg/shelf/lib/src/middleware.dart b/pkg/shelf/lib/src/middleware.dart
|
| deleted file mode 100644
|
| index b81b70d7ed85e384723920702690573dc66e0281..0000000000000000000000000000000000000000
|
| --- a/pkg/shelf/lib/src/middleware.dart
|
| +++ /dev/null
|
| @@ -1,75 +0,0 @@
|
| -// 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 'request.dart';
|
| -import 'response.dart';
|
| -import 'handler.dart';
|
| -import 'hijack_exception.dart';
|
| -import 'util.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 syncFuture(() => requestHandler(request)).then((response) {
|
| - if (response != null) return response;
|
| -
|
| - return syncFuture(() => innerHandler(request))
|
| - .then((response) => responseHandler(response), onError: onError);
|
| - });
|
| - };
|
| - };
|
| -}
|
|
|