Add option to HttpClient to turn of auto uncompression

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 1219 matching lines @@
    * Increasing this number may lower performance and take up unwanted
    * system resources.
    *
    * To disable, set to `null`.
    *
    * Default is `null`.
    */
   int maxConnectionsPerHost;
 
   /**
+   * Get and set whether the body of a response will be automatically
+   * uncompressed.
+   *
+   * If the client want to process the body then getting the already

[Anders Johnsen, 2014/07/04 10:56:39]

This sentence is a bit hard to read.

[Søren Gjesse, 2014/07/04 11:14:01]

Rephrased.

+   * uncompressed is convenient. However in some situations
+   * (e.g. implementing a transparent proxy) keeping the uncompressed
+   * stream is required.
+   *
+   * NOTE: When automatic un-compression is turned on the value of the

[Anders Johnsen, 2014/07/04 10:56:39]

Maybe state that 'No headers are modified', to be clear we never modify any of
the incoming headers, only the content.

[Søren Gjesse, 2014/07/04 11:14:01]

Done.

+   * header `Content-Length` will reflect the length of the original
+   * compressed body. Likewise the header `Content-Encoding` will also
+   * have the original value indicating compression.
+   *
+   * NOTE: Automatic un-compression is only supported when the

[Anders Johnsen, 2014/07/04 10:56:39]

supported -> performed/done
when -> if

[Søren Gjesse, 2014/07/04 11:14:01]

Done.

+   * `Content-Encoding` used is `gzip`.

[Anders Johnsen, 2014/07/04 10:56:39]

used -> header

[Søren Gjesse, 2014/07/04 11:14:01]

Done.

+   *
+   * This value affects all responses produced by this client after the
+   * value is changed.
+   *
+   * To disable, set to `false`.
+   *
+   * Default is `true`.
+   */
+  bool autoUncompress;
+
+  /**
    * Set and get the default value of the `User-Agent` header for all requests
    * generated by this [HttpClient]. The default value is
    * `Dart/<version> (dart:io)`.
    *
    * If the userAgent is set to `null`, no default `User-Agent` header will be
    * added to each request.
    */
   String userAgent;
 
   factory HttpClient() => new _HttpClient();
@@ skipping 675 matching lines @@
 class RedirectException implements HttpException {
   final String message;
   final List<RedirectInfo> redirects;
 
   const RedirectException(this.message, this.redirects);
 
   String toString() => "RedirectException: $message";
 
   Uri get uri => redirects.last.location;
 }