Add utility methods for sending non-form data in pkg/http.

pkg/http/lib/http.dart

Index: pkg/http/lib/http.dart
diff --git a/pkg/http/lib/http.dart b/pkg/http/lib/http.dart
index 752a53b4354352f49146ed7aa9366684e6cd2be5..52932a4e2dbc8a24dcff6dceae8e6f89d64e2785 100644
--- a/pkg/http/lib/http.dart
+++ b/pkg/http/lib/http.dart
@@ -23,7 +23,7 @@
 ///     import 'package:http/http.dart' as http;
 ///
 ///     var url = "http://example.com/whatsit/create";
-///     http.post(url, fields: {"name": "doodle", "color": "blue"})
+///     http.post(url, body: {"name": "doodle", "color": "blue"})
 ///         .then((response) {
 ///       print("Response status: ${response.statusCode}");
 ///       print("Response body: ${response.body}");
@@ -38,7 +38,7 @@
 ///     var client = new http.Client();
 ///     client.post(
 ///         "http://example.com/whatsit/create",
-///         fields: {"name": "doodle", "color": "blue"})
+///         body: {"name": "doodle", "color": "blue"})
 ///       .then((response) => client.get(response.bodyFields['uri']))
 ///       .then((response) => print(response.body))
 ///       .whenComplete(client.close);
@@ -68,6 +68,7 @@
 library http;
 
 import 'dart:async';
+import 'dart:convert';
 import 'dart:typed_data';
 
 import 'src/client.dart';
@@ -107,35 +108,51 @@ Future<Response> head(url, {Map<String, String> headers}) =>
 Future<Response> get(url, {Map<String, String> headers}) =>
   _withClient((client) => client.get(url, headers: headers));
 
-/// Sends an HTTP POST request with the given headers and fields to the given
-/// URL, which an be a [Uri] or a [String]. If any fields are specified, the
-/// content-type is automatically set to `"application/x-www-form-urlencoded"`.
+/// Sends an HTTP POST request with the given headers and body to the given URL,
+/// which can be a [Uri] or a [String].
 ///
-/// This automatically initializes a new [Client] and closes that client once
-/// the request is complete. If you're planning on making multiple requests to
-/// the same server, you should use a single [Client] for all of those requests.
+/// [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-is as the body of the request.

[Bob Nystrom, 2013/11/12 00:07:33]

Instead of "used as-is" how about clarifying that it's treated as a list of
bytes?

[nweiz, 2013/11/12 01:59:13]

Done.

+///
+/// 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 [UTF8].
 ///
 /// For more fine-grained control over the request, use [Request] or
 /// [StreamedRequest] instead.
-Future<Response> post(url,
-    {Map<String, String> headers,
-     Map<String, String> fields}) =>
-  _withClient((client) => client.post(url, headers: headers, fields: fields));
+Future<Response> post(url, {Map<String, String> headers, body,
+    Encoding encoding}) =>
+  _withClient((client) => client.post(url,
+      headers: headers, body: body, encoding: encoding));
 
-/// Sends an HTTP POST request with the given headers and fields to the given
-/// URL, which can be a [Uri] or a [String]. If any fields are specified, the
-/// content-type is automatically set to `"application/x-www-form-urlencoded"`.
+/// Sends an HTTP PUT request with the given headers and body to the given URL,
+/// which can be a [Uri] or a [String].
 ///
-/// This automatically initializes a new [Client] and closes that client once
-/// the request is complete. If you're planning on making multiple requests to
-/// the same server, you should use a single [Client] for all of those requests.
+/// [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-is as 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 [UTF8].
 ///
 /// For more fine-grained control over the request, use [Request] or
 /// [StreamedRequest] instead.
-Future<Response> put(url,
-    {Map<String, String> headers,
-     Map<String, String> fields}) =>
-  _withClient((client) => client.put(url, headers: headers, fields: fields));
+Future<Response> put(url, {Map<String, String> headers, body,
+    Encoding encoding}) =>
+  _withClient((client) => client.put(url,
+      headers: headers, body: body, encoding: encoding));
 
 /// Sends an HTTP DELETE request with the given headers to the given URL, which
 /// can be a [Uri] or a [String].