dart:io | Ensure that close() returns a Future<this> on all (Raw)?(Secure)?(Server)?Socket classes …

sdk/lib/io/socket.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;
 
 
 /**
  * [InternetAddressType] is the type an [InternetAddress]. Currently,
  * IP version 4 (IPv4) and IP version 6 (IPv6) are supported.
@@ skipping 184 matching lines @@
                                                int port,
                                                {int backlog: 0,
                                                 bool v6Only: false});
 
   /**
    * Returns the port used by this socket.
    */
   int get port;
 
   /**
-   * Closes the socket.
+   * Closes the socket. The returned future completes when the socket
+   * is fully closed and is no longer bound.
    */
-  void close();
+  Future<RawServerSocket> close();
 }
 
 
 /**
  * A [ServerSocket] represents a listening socket, and provides a
  * stream of [Socket] objects, one for each connection made to the
  * listening socket.
  *
  * See [Socket] for more info.
  */
@@ skipping 35 matching lines @@
 
   /**
    * Returns the port used by this socket.
    */
   int get port;
 
   /**
    * Closes the socket. The returned future completes when the socket
    * is fully closed and is no longer bound.
    */
-  Future close();
+  Future<ServerSocket> close();
 }
 
 /**
  * The [SocketDirection] is used as a parameter to [Socket.close] and
  * [RawSocket.close] to close a socket in the specified direction(s).
  */
 class SocketDirection {
   static const SocketDirection RECEIVE = const SocketDirection._(0);
   static const SocketDirection SEND = const SocketDirection._(1);
   static const SocketDirection BOTH = const SocketDirection._(2);
@@ skipping 94 matching lines @@
    * Returns the [InternetAddress] used to connect this socket.
    */
   InternetAddress get address;
 
   /**
    * Returns the remote host connected to by this socket.
    */
   String get remoteHost;
 
   /**
-   * Closes the socket. Calling [close] will never throw an exception
+   * Closes the socket. Returns a Future that completes with [this] when the
+   * underlying connection is completely destroyed.
+   *
+   * Calling [close] will never throw an exception
    * and calling it several times is supported. Calling [close] can result in
    * a [RawSocketEvent.READ_CLOSED] event.
    */
-  void close();
+  Future<RawSocket> close();
 
   /**
    * Shutdown the socket in the [direction]. Calling [shutdown] will never
    * throw an exception and calling it several times is supported. Calling
    * shutdown with either [SocketDirection.BOTH] or [SocketDirection.RECEIVE]
    * can result in a [RawSocketEvent.READ_CLOSED] event.
    */
   void shutdown(SocketDirection direction);
 
   /**
@@ skipping 104 matching lines @@
       } else {
         sb.write(", address = ${address.address}");
       }
     }
     if (port != null) {
       sb.write(", port = $port");
     }
     return sb.toString();
   }
 }