Support auto-drain of HttpRequest data.

sdk/lib/io/http.dart

 // Copyright (c) 2013, 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.
 
 part of dart.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 703 matching lines @@
 
   /**
    * Gets information about the client connection. Returns [null] if the socket
    * is not available.
    */
   HttpConnectionInfo get connectionInfo;
 
   /**
    * Gets the [HttpResponse] object, used for sending back the response to the
    * client.
+   *
+   * If the [contentLength] of the body isn't 0, and the body isn't being read,
+   * any write calls on the [HttpResponse] will automatically drain the request
+   * body.
    */
   HttpResponse get response;
 }
 
 
 /**
  * An [HttpResponse] represents the headers and data to be returned to
  * a client in response to an HTTP request.
  *
  * This object has a number of properties for setting up the HTTP
@@ skipping 636 matching lines @@
 class RedirectLimitExceededException extends RedirectException {
   const RedirectLimitExceededException(List<RedirectInfo> redirects)
       : super("Redirect limit exceeded", redirects);
 }
 
 
 class RedirectLoopException extends RedirectException {
   const RedirectLoopException(List<RedirectInfo> redirects)
       : super("Redirect loop detected", redirects);
 }