Start adding TLS (SSL) sockets to dart:io.

runtime/bin/tls_socket.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.
 
-interface ServerSocket default _ServerSocket {
+interface TlsSocket extends Socket, Hashable default _TlsSocket {
   /**
-   * Constructs a new server socket, binds it to a given address and port,
-   * and listens on it.
-   */
-  ServerSocket(String bindAddress, int port, int backlog);
-
-  /**
-   * The connection handler gets called when there is a new incoming
-   * connection on the socket.
-   */
-  void set onConnection(void callback(Socket connection));
-
-  /**
-   * The error handler gets called when a socket error occurs.
-   */
-  void set onError(void callback(e));
-
-  /**
-   * Returns the port used by this socket.
-   */
-  int get port();
-
-  /**
-   * Closes the socket.
-   */
-  void close();
-}
-
-
-interface Socket extends Hashable default _Socket {
-  /**
-   * Constructs a new socket and initiate connecting it to the given
+   * Constructs a new secure socket and connect it to the given
    * host on the given port. The returned socket is not yet connected
    * but ready for registration of callbacks.
    */
-  Socket(String host, int port);
+  TlsSocket(String host, int port);
 

[Søren Gjesse, 2012/07/31 09:07:15]

As TlsSocket extends Socket is there any need to duplicate all the methods here
as well?

[Bill Hesse, 2012/08/08 17:00:05]

No there is not.  Fixed.

   /**
    * Returns the number of received and non-read bytes in the socket that
    * can be read.
    */
   int available();
 
   /**
    * Reads up to [count] bytes of data from the socket and stores them into
    * buffer after buffer offset [offset]. The number of successfully read
    * bytes is returned. This function is non-blocking and will only read data
@@ skipping 14 matching lines @@
    * succeeded.
    */
   void set onConnect(void callback());
 
   /**
    * The data handler gets called when data becomes available at the socket.
    */
   void set onData(void callback());
 
   /**
-   * The write handler gets called once when the socket becomes
-   * available for writing. Then the handler is automatically reset to null.
-   * This handler is mainly used when writeList has reported an incomplete
-   * write, to schedule writing the remaining data to the socket.
+   * The write handler gets called when the socket becomes available for
+   * writing.
    */
   void set onWrite(void callback());
 
   /**
    * The close handler gets called when a the last byte have been read
    * from a socket. At this point the socket might still be open for
    * writing for sending more data.
    */
   void set onClosed(void callback());
 
   /**
    * The error handler gets called when a socket error occurs.
    */
   void set onError(void callback(e));
 
   /**
    * Returns input stream to the socket.
+   * Not yet implemented.
    */
   InputStream get inputStream();
 
   /**
    * Returns output stream of the socket.
+   * Not yet implemented.
    */
   OutputStream get outputStream();
 
   /**
    * Returns the port used by this socket.
    */
   int get port();
 
   /**
    * Returns the remote port connected to by this socket.
    */
   int get remotePort();
 
   /**
    * Returns the remote host connected to by this socket.
    */
   String get remoteHost();
 
   /**
    * Closes the socket. Calling [close] will never throw an exception
    * and calling it several times is supported. If [halfClose] is true
    * the socket will only be closed for writing and it might still be
    * possible to read data. Calling [close] will not trigger a call to
    * [onClosed].
    */
-  void close([bool halfClose]);
+  void close([bool halfClose = false]);
 
   /**
    * Socket is hashable.
    */
   int hashCode();
 }
-
-
-class SocketIOException implements Exception {
-  const SocketIOException([String this.message = "",
-                           OSError this.osError = null]);
-  String toString() {
-    StringBuffer sb = new StringBuffer();
-    sb.add("SocketIOException");
-    if (!message.isEmpty()) {
-      sb.add(": $message");
-      if (osError != null) {
-        sb.add(" ($osError)");
-      }
-    } else if (osError != null) {
-      sb.add(": $osError");
-    }
-    return sb.toString();
-  }
-  final String message;
-  final OSError osError;
-}