Add handling of the HTTP header "Host"

runtime/bin/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.
  */
 interface HttpStatus {
   static final int CONTINUE = 100;
   static final int SWITCHING_PROTOCOLS = 101;
@@ skipping 166 matching lines @@
   String reasonPhrase;
 
   /**
    * Sets a header on the response. NOTE: If the same header name is
    * set more than once only the last value will be part of the
    * response.
    */
   void setHeader(String name, String value);
 
   /**
+   * Returns the response headers.
+   */
+  Map<String, String> get headers();
+
+  /**
    * Returns the output stream for the response. This is used to write
    * the response data. When all response data has been written close
    * the stream to indicate the end of the response.
    *
    * When this is accessed for the first time the response header is
    * send. Calling any methods that will change the header after
    * having retrieved the output stream will throw an exception.
    */
   OutputStream get outputStream();
 
   /**
    * Write string data to the response. The string characters will be
    * encoded using UFT-8. This is a temporary convenience method as
    * long as the OutputStream interface does not have a writeString
    * method.
    */
   bool writeString(String string);
 }
 
 
 /**
  * HTTP client factory.
  */
 interface HttpClient default _HttpClient {
+  static final int DEFAULT_HTTP_PORT = 80;
+
   HttpClient();
 
   /**
    * Opens a HTTP connection. The returned [HttpClientConnection] is
-   * used to register handlers for asynchronous events on a Http
-   * connection.
+   * used to register callbacks for asynchronous events on the HTTP
+   * connection. The "Host" header for the request will be set to the
+   * value [host]:[port]. This can be overridden through the
+   * HttpClientRequest interface before the request is sent. NOTE if
+   * [host] is an IP address this will still be set in the "Host"
+   * header.
    */
   HttpClientConnection open(String method, String host, int port, String path);
 
   /**
-   * Opens a HTTP connection using the GET method.
+   * Opens a HTTP connection using the GET method. See [open] for details.
    */
   HttpClientConnection get(String host, int port, String path);
 
   /**
-   * Opens a HTTP connection using the POST method.
+   * Opens a HTTP connection using the POST method. See [open] for details.
    */
   HttpClientConnection post(String host, int port, String path);
 
   /**
    * Shutdown the HTTP client releasing all resources.
    */
   void shutdown();
 }
 
 
@@ skipping 39 matching lines @@
    * which is also the default.
    */
   int contentLength;
 
   /**
    * Gets and sets the keep alive state of the connection.
    */
   bool keepAlive;
 
   /**
+   * Gets and sets the " host part of the "Host" header for the
+   * connection. By default this will be set to the value of the host
+   * used when initiating the connection.
+   */
+  String host;
+
+  /**
+   * Gets and sets the port part of the "Host" header for the
+   * connection. By default this will be set to the value of the port
+   * used when initiating the connection.
+   */
+  int port;
+
+  /**
    * Sets a header on the request. NOTE: If the same header name is
    * set more than once only the last value set will be part of the
    * request.
    */
   void setHeader(String name, String value);
 
   /**
+   * Returns the request headers.
+   */
+  Map<String, String> get headers();
+
+  /**
    * Returns the output stream for the request. This is used to write
    * the request data. When all request data has been written close
    * the stream to indicate the end of the request.
    *
    * When this is accessed for the first time the request header is
    * send. Calling any methods that will change the header after
    * having retrieved the output stream will throw an exception.
    */
   OutputStream get outputStream();
 
@@ skipping 28 matching lines @@
   int get contentLength();
 
   /**
    * Returns the keep alive state of the connection.
    */
   bool get keepAlive();
 
   /**
    * Returns the response headers.
    */
-  Map get headers();
+  Map<String, String> get headers();
 
   /**
    * Returns the input stream for the response. This is used to read
    * the response data.
    */
   InputStream get inputStream();
 }
 
 
 class HttpException implements Exception {
   const HttpException([String this.message = ""]);
   String toString() => "HttpException: $message";
   final String message;
 }