Add support for proxies requiing authentication

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 908 matching lines @@
    */
   set findProxy(String f(Uri url));
 
   /**
    * Function for resolving the proxy server to be used for a HTTP
    * connection from the proxy configuration specified through
    * environment variables.
    *
    * The following environment variables are taken into account:
    *
-   *  * http_proxy
-   *  * https_proxy
-   *  * no_proxy
-   *  * HTTP_PROXY
-   *  * HTTPS_PROXY
-   *  * NO_PROXY
+   *     http_proxy
+   *     https_proxy
+   *     no_proxy
+   *     HTTP_PROXY
+   *     HTTPS_PROXY
+   *     NO_PROXY
    *
    * [:http_proxy:] and [:HTTP_PROXY:] specify the proxy server to use for
    * http:// urls. Use the format [:hostname:port:]. If no port is used a
    * default of 1080 will be used. If both are set the lower case one takes
    * precedence.
    *
    * [:https_proxy:] and [:HTTPS_PROXY:] specify the proxy server to use for
    * https:// urls. Use the format [:hostname:port:]. If no port is used a
    * default of 1080 will be used. If both are set the lower case one takes
    * precedence.
@@ skipping 11 matching lines @@
    *     client.findProxy = HttpClient.findProxyFromEnvironment;
    *
    * If you don't want to use the system environment you can use a
    * different one by wrapping the function.
    *
    *     HttpClient client = new HttpClient();
    *     client.findProxy = (url) {
    *       return HttpClient.findProxyFromEnvironment(
    *           url, {"http_proxy": ..., "no_proxy": ...});
    *     }
+   *
+   * If a proxy requires authentication it is possible to configure
+   * the username and password as well. Use the format
+   * [:username:password@hostname:port:] to include the username and
+   * password. Alternatively the API [addProxyCredentials] can be used
+   * to set credentials for proxies which require authentication.
    */
   static String findProxyFromEnvironment(Uri url,
                                          {Map<String, String> environment}) {
     return _HttpClient._findProxyFromEnvironment(url, environment);
   }
 
   /**
+   * Sets the function to be called when a proxy is requesting
+   * authentication. The proxy used and and the security realm from

[Anders Johnsen, 2013/04/15 07:07:19]

double 'and'. Rewrite first part of the sentence.

[Søren Gjesse, 2013/04/15 07:42:00]

Done.

+   * the server are passed in the arguments [host], [port] and
+   * [realm].
+   *
+   * The function returns a [Future] which should complete when the
+   * authentication has been resolved. If credentials cannot be
+   * provided the [Future] should complete with [false]. If
+   * credentials are available the function should add these using
+   * [addProxyCredentials] before completing the [Future] with the value
+   * [true].
+   *
+   * If the [Future] completes with [true] the request will be retried
+   * using the updated credentials. Otherwise response processing will
+   * continue normally.
+   */
+  set authenticateProxy(
+      Future<bool> f(String host, int port, String scheme, String realm));
+
+  /**
+   * Add credentials to be used for authorizing HTTP proxies.
+   */
+  void addProxyCredentials(String host,
+                           int port,
+                           String realm,
+                           HttpClientCredentials credentials);
+
+  /**
    * Shutdown the HTTP client. If [force] is [:false:] (the default)
    * the [:HttpClient:] will be kept alive until all active
    * connections are done. If [force] is [:true:] any active
    * connections will be closed to immediately release all
    * resources. These closed connections will receive an [:onError:]
    * callback to indicate that the client was shutdown. In both cases
    * trying to establish a new connection after calling [shutdown]
    * will throw an exception.
    */
   void close({bool force: false});
@@ skipping 282 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);
 }