Initial web socket server implementation

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 365 matching lines @@
   /**
    * 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();
+
+  /**
+   * When the HTTP protocol is upgraded use this method to get the
+   * underlying socket used for the communication. After calling
+   * [protocolUpgrade] the socket is fully detached from the HTTP
+   * server.
+   */
+  Socket protocolUpgrade();

[Anders Johnsen, 2012/04/24 12:20:47]

Further comment that this can be done after the HTTP Upgrade header have been
seen.

[Mads Ager (google), 2012/04/25 10:41:55]

The name makes it sound like this is requesting a protocol upgrade. Can we
rename to something like upgradedSocket? Or maybe just disconnectSocket?

[Søren Gjesse, 2012/04/25 13:57:14]

Done.

[Søren Gjesse, 2012/04/25 13:57:14]

Changed name to detachSocket.

 }
 
 
 /**
  * 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 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);
 
+  //WebSocketConnection openWebSocket(protocols, String host, int port, String path);

[Anders Johnsen, 2012/04/24 12:20:47]

Did you mean to include this?

[Søren Gjesse, 2012/04/25 13:57:14]

No, removed.

+
   /**
    * Opens a HTTP connection. The returned [HttpClientConnection] is
    * used to register callbacks for asynchronous events on the HTTP
    * connection. The "Host" header for the request will be set based
    * the host and port specified in [url]. This can be overridden
    * through the HttpClientRequest interface before the request is
    * sent. NOTE if the host is specified as an IP address this will
    * still be set in the "Host" header.
    */
   HttpClientConnection openUrl(String method, Uri url);
@@ skipping 117 matching lines @@
    */
   InputStream get inputStream();
 }
 
 
 class HttpException implements Exception {
   const HttpException([String this.message = ""]);
   String toString() => "HttpException: $message";
   final String message;
 }