Generate an error for active connections when the HTTP client is shutdown

sdk/lib/io/http.dart

 // 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.
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
   static const int CONTINUE = 100;
   static const int SWITCHING_PROTOCOLS = 101;
@@ skipping 812 matching lines @@
    * for using the proxy server [:host:] on port [:port:].
    *
    * A configuration can contain several configuration elements
    * separated by semicolons, e.g.
    *
    *   "PROXY host:port; PROXY host2:port2; DIRECT"
    */
   set findProxy(String f(Uri url));
 
   /**
-   * Shutdown the HTTP client releasing all resources.
+   * Shutdown the HTTP client. If [force] is [:true:] any active
+   * connections will be terminated to immediately release all
+   * resources. If [force] is [:false:] the [:HttpClient:] will be

[Mads Ager (google), 2012/11/23 07:25:38]

Could we add a comment to make it explicit what happens with connections that
are not done when you force a client shutdown?

[Søren Gjesse, 2012/11/23 09:08:47]

It's already there, "If [force] is [:true:]..." above.

[Søren Gjesse, 2012/11/23 09:31:16]

Added more information on forced shutdown.

+   * kept alive until all active connections are done.
    */
-  void shutdown();
+  void shutdown({bool force: false});
 }
 
 
 /**
  * A [HttpClientConnection] is returned by all [HttpClient] methods
  * that initiate a connection to an HTTP server. The handlers will be
  * called as the connection state progresses.
  *
  * The setting of all handlers is optional. If [onRequest] is not set
  * the request will be send without any additional headers and an
@@ skipping 239 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);
 }