Index: pkg/http/lib/src/base_client.dart |
diff --git a/pkg/http/lib/src/base_client.dart b/pkg/http/lib/src/base_client.dart |
deleted file mode 100644 |
index da38e705000680f1a0ccab648f6dd14392034fed..0000000000000000000000000000000000000000 |
--- a/pkg/http/lib/src/base_client.dart |
+++ /dev/null |
@@ -1,169 +0,0 @@ |
-// Copyright (c) 2012, 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 base_client; |
- |
-import 'dart:async'; |
-import 'dart:convert'; |
-import 'dart:typed_data'; |
- |
-import 'base_request.dart'; |
-import 'client.dart'; |
-import 'exception.dart'; |
-import 'request.dart'; |
-import 'response.dart'; |
-import 'streamed_response.dart'; |
-import 'utils.dart'; |
- |
-/// The abstract base class for an HTTP client. This is a mixin-style class; |
-/// subclasses only need to implement [send] and maybe [close], and then they |
-/// get various convenience methods for free. |
-abstract class BaseClient implements Client { |
- /// Sends an HTTP HEAD request with the given headers to the given URL, which |
- /// can be a [Uri] or a [String]. |
- /// |
- /// For more fine-grained control over the request, use [send] instead. |
- Future<Response> head(url, {Map<String, String> headers}) => |
- _sendUnstreamed("HEAD", url, headers); |
- |
- /// Sends an HTTP GET request with the given headers to the given URL, which |
- /// can be a [Uri] or a [String]. |
- /// |
- /// For more fine-grained control over the request, use [send] instead. |
- Future<Response> get(url, {Map<String, String> headers}) => |
- _sendUnstreamed("GET", url, headers); |
- |
- /// Sends an HTTP POST request with the given headers and body to the given |
- /// URL, which can be a [Uri] or a [String]. |
- /// |
- /// [body] sets the body of the request. It can be a [String], a [List<int>] |
- /// or a [Map<String, String>]. If it's a String, it's encoded using |
- /// [encoding] and used as the body of the request. The content-type of the |
- /// request will default to "text/plain". |
- /// |
- /// If [body] is a List, it's used as a list of bytes for the body of the |
- /// request. |
- /// |
- /// If [body] is a Map, it's encoded as form fields using [encoding]. The |
- /// content-type of the request will be set to |
- /// `"application/x-www-form-urlencoded"`; this cannot be overridden. |
- /// |
- /// [encoding] defaults to UTF-8. |
- /// |
- /// For more fine-grained control over the request, use [send] instead. |
- Future<Response> post(url, {Map<String, String> headers, body, |
- Encoding encoding}) => |
- _sendUnstreamed("POST", url, headers, body, encoding); |
- |
- /// Sends an HTTP PUT request with the given headers and body to the given |
- /// URL, which can be a [Uri] or a [String]. |
- /// |
- /// [body] sets the body of the request. It can be a [String], a [List<int>] |
- /// or a [Map<String, String>]. If it's a String, it's encoded using |
- /// [encoding] and used as the body of the request. The content-type of the |
- /// request will default to "text/plain". |
- /// |
- /// If [body] is a List, it's used as a list of bytes for the body of the |
- /// request. |
- /// |
- /// If [body] is a Map, it's encoded as form fields using [encoding]. The |
- /// content-type of the request will be set to |
- /// `"application/x-www-form-urlencoded"`; this cannot be overridden. |
- /// |
- /// [encoding] defaults to UTF-8. |
- /// |
- /// For more fine-grained control over the request, use [send] instead. |
- Future<Response> put(url, {Map<String, String> headers, body, |
- Encoding encoding}) => |
- _sendUnstreamed("PUT", url, headers, body, encoding); |
- |
- /// Sends an HTTP DELETE request with the given headers to the given URL, |
- /// which can be a [Uri] or a [String]. |
- /// |
- /// For more fine-grained control over the request, use [send] instead. |
- Future<Response> delete(url, {Map<String, String> headers}) => |
- _sendUnstreamed("DELETE", url, headers); |
- |
- /// Sends an HTTP GET request with the given headers to the given URL, which |
- /// can be a [Uri] or a [String], and returns a Future that completes to the |
- /// body of the response as a String. |
- /// |
- /// The Future will emit a [ClientException] if the response doesn't have a |
- /// success status code. |
- /// |
- /// For more fine-grained control over the request and response, use [send] or |
- /// [get] instead. |
- Future<String> read(url, {Map<String, String> headers}) { |
- return get(url, headers: headers).then((response) { |
- _checkResponseSuccess(url, response); |
- return response.body; |
- }); |
- } |
- |
- /// Sends an HTTP GET request with the given headers to the given URL, which |
- /// can be a [Uri] or a [String], and returns a Future that completes to the |
- /// body of the response as a list of bytes. |
- /// |
- /// The Future will emit an [ClientException] if the response doesn't have a |
- /// success status code. |
- /// |
- /// For more fine-grained control over the request and response, use [send] or |
- /// [get] instead. |
- Future<Uint8List> readBytes(url, {Map<String, String> headers}) { |
- return get(url, headers: headers).then((response) { |
- _checkResponseSuccess(url, response); |
- return response.bodyBytes; |
- }); |
- } |
- |
- /// Sends an HTTP request and asynchronously returns the response. |
- /// |
- /// Implementers should call [BaseRequest.finalize] to get the body of the |
- /// request as a [ByteStream]. They shouldn't make any assumptions about the |
- /// state of the stream; it could have data written to it asynchronously at a |
- /// later point, or it could already be closed when it's returned. Any |
- /// internal HTTP errors should be wrapped as [ClientException]s. |
- Future<StreamedResponse> send(BaseRequest request); |
- |
- /// Sends a non-streaming [Request] and returns a non-streaming [Response]. |
- Future<Response> _sendUnstreamed(String method, url, |
- Map<String, String> headers, [body, Encoding encoding]) { |
- return syncFuture(() { |
- if (url is String) url = Uri.parse(url); |
- var request = new Request(method, url); |
- |
- if (headers != null) request.headers.addAll(headers); |
- if (encoding != null) request.encoding = encoding; |
- if (body != null) { |
- if (body is String) { |
- request.body = body; |
- } else if (body is List) { |
- request.bodyBytes = body; |
- } else if (body is Map) { |
- request.bodyFields = body; |
- } else { |
- throw new ArgumentError('Invalid request body "$body".'); |
- } |
- } |
- |
- return send(request); |
- }).then(Response.fromStream); |
- } |
- |
- /// Throws an error if [response] is not successful. |
- void _checkResponseSuccess(url, Response response) { |
- if (response.statusCode < 400) return; |
- var message = "Request to $url failed with status ${response.statusCode}"; |
- if (response.reasonPhrase != null) { |
- message = "$message: ${response.reasonPhrase}"; |
- } |
- if (url is String) url = Uri.parse(url); |
- throw new ClientException("$message.", url); |
- } |
- |
- /// Closes the client and cleans up any resources associated with it. It's |
- /// important to close each client when it's done being used; failing to do so |
- /// can cause the Dart process to hang. |
- void close() {} |
-} |