Add the ability to get info of a Http connection, e.g. host and port.

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 537 matching lines @@
    * Returns the input stream for the request. This is used to read
    * the request data.
    */
   InputStream get inputStream();
 
   /**
    * Returns the HTTP protocol version used in the request. This will
    * be "1.0" or "1.1".
    */
   String get protocolVersion();
+
+  /**
+   * Get information about the client connection. Returns [null] if the socket
+   * isn't available.
+   */
+  HttpConnectionInfo get connectionInfo();
 }
 
 
 /**
  * HTTP response to be send back to the client.
  */
 interface HttpResponse default _HttpResponse {
   /**
    * Gets and sets the content length of the response. If the size of
    * the response is not known in advance set the content length to
@@ skipping 44 matching lines @@
 
   /**
    * Detach the underlying socket from the HTTP server. When the
    * socket is detached the HTTP server will no longer perform any
    * operations on it.
    *
    * This is normally used when a HTTP upgrade request is received
    * and the communication should continue with a different protocol.
    */
   DetachedSocket detachSocket();
+
+  /**
+   * Get information about the client connection. Returns [null] if the socket
+   * isn't available.
+   */
+  HttpConnectionInfo get connectionInfo();
 }
 
 
 /**
  * HTTP client factory. The [HttpClient] handles all the sockets associated
  * with the [HttpClientConnection]s and when the endpoint supports it, it will
  * try to reuse opened sockets for several requests to support HTTP 1.1
  * persistent connections. This means that sockets will be kept open for some
  * time after a requests have completed, unless HTTP procedures indicate that it
  * must be closed as part of completing the request. Use [:HttpClient.shutdown:]
@@ skipping 117 matching lines @@
 
   /**
    * Detach the underlying socket from the HTTP client. When the
    * socket is detached the HTTP client will no longer perform any
    * operations on it.
    *
    * This is normally used when a HTTP upgrade is negotiated and the
    * communication should continue with a different protocol.
    */
   DetachedSocket detachSocket();
+
+  /**
+   * Get information about the client connection. Returns [null] if the socket
+   * isn't available.
+   */
+  HttpConnectionInfo get connectionInfo();
 }
 
 
 /**
  * HTTP request for a client connection.
  */
 interface HttpClientRequest default _HttpClientRequest {
   /**
    * Gets and sets the content length of the request. If the size of
    * the request is not known in advance set content length to -1,
@@ skipping 73 matching lines @@
    */
   List<Cookie> get cookies();
 
   /**
    * Returns the input stream for the response. This is used to read
    * the response data.
    */
   InputStream get inputStream();
 }
 
+/**
+ * Connection information.
+ */
+interface HttpConnectionInfo {
+  String get remoteHost();
+  int get remotePort();
+  int get localPort();
+}
+
 
 /**
  * Redirect information.
  */
 interface RedirectInfo {
   /**
    * Returns the status code used for the redirect.
    */
   int get statusCode();
 
@@ skipping 39 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);
 }