Add the shared flag to HttpServer as well

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 205 matching lines @@
    * version 6 only.
    *
    * If [port] has the value [:0:] an ephemeral port will
    * be chosen by the system. The actual port used can be retrieved
    * using the [:port:] getter.
    *
    * The optional argument [backlog] can be used to specify the listen
    * backlog for the underlying OS listen setup. If [backlog] has the
    * value of [:0:] (the default) a reasonable value will be chosen by
    * the system.
+   *
+   * The optional argument [shared] specify whether additional binds
+   * to the same `address`, `port` and `v6Only` combination is
+   * possible from the same Dart process. If `shared` is `true` and
+   * additional binds are preformed, then the incoming (accepted)

[kustermann, 2015/02/17 11:30:56]

preformed -> performed

[Søren Gjesse, 2015/02/17 12:53:11]

Done.

+   * connections will be distributed between that set
+   * `RawServerSocket`s. One way of using this is to have number of
+   * isolates between which incoming connections are distributed.
    */
   external static Future<RawServerSocket> bind(address,
                                                int port,
                                                {int backlog: 0,
                                                 bool v6Only: false,
                                                 bool shared: false});
 
   /**
    * Returns the port used by this socket.
    */
   int get port;
 
   /**
    * Returns the address used by this socket.
    */
   InternetAddress get address;
 
   /**
    * Closes the socket. The returned future completes when the socket
    * is fully closed and is no longer bound.
    */
   Future<RawServerSocket> close();
 
   /**
    * Get the [RawServerSocketReference].
    *
-   * WARNING: This feature is *highly experimental* and currently only works on
-   * Linux. The API is most likely going to change in the near future.
+   * WARNING: This feature is *highly experimental* and currently only
+   * works on Linux. The API will be removed in Dart 1.10. Use the
+   * `shared` optional argument on the `bind` method instead.
    *
    * The returned [RawServerSocketReference] can be used to create other
    * [RawServerSocket]s listening on the same port,
    * using [RawServerSocketReference.create].
    * Incoming connections on the port will be distributed fairly between the
    * active server sockets.
    * The [RawServerSocketReference] can be distributed to other isolates through
    * a [RawSendPort].
    */
+
+  @Deprecated('This will be removed in Dart 1.10. '
+              'Use the `shared` optional argument on the `bind` method instead.')

[kustermann, 2015/02/17 11:30:56]

long line.

[Søren Gjesse, 2015/02/17 12:53:11]

Done.

   RawServerSocketReference get reference;
 }
 
 
 /**
  * A [RawServerSocketReference].
  *
  * WARNING: This class is used with [RawServerSocket.reference] which is highly
  * experimental.
  */
+@Deprecated('This will be removed in Dart 1.10.')
 abstract class RawServerSocketReference {
   /**
    * Create a new [RawServerSocket], from this reference.
    */
   Future<RawServerSocket> create();
 }
 
 
 /**
  * A [ServerSocket] represents a listening socket, and provides a
@@ skipping 25 matching lines @@
    * version 6 only.
    *
    * If [port] has the value [:0:] an ephemeral port will be chosen by
    * the system. The actual port used can be retrieved using the
    * [port] getter.
    *
    * The optional argument [backlog] can be used to specify the listen
    * backlog for the underlying OS listen setup. If [backlog] has the
    * value of [:0:] (the default) a reasonable value will be chosen by
    * the system.
+   *
+   * The optional argument [shared] specify whether additional binds
+   * to the same `address`, `port` and `v6Only` combination is
+   * possible from the same Dart process. If `shared` is `true` and
+   * additional binds are preformed, then the incoming (incoming)

[kustermann, 2015/02/17 11:30:56]

ditto

[Søren Gjesse, 2015/02/17 12:53:11]

Done.

+   * connections will be distributed between that set
+   * `ServerSocket`s. One way of using this is to have number of
+   * isolates between which incoming connections are distributed.
    */
   external static Future<ServerSocket> bind(address,
                                             int port,
                                             {int backlog: 0,
                                              bool v6Only: false,
                                              bool shared: false});
 
   /**
    * Returns the port used by this socket.
    */
   int get port;
 
   /**
    * Returns the address used by this socket.
    */
   InternetAddress get address;
 
   /**
    * Closes the socket. The returned future completes when the socket
    * is fully closed and is no longer bound.
    */
   Future<ServerSocket> close();
 
   /**
    * Get the [ServerSocketReference].
    *
-   * WARNING: This feature is *highly experimental* and currently only works on
-   * Linux. The API is most likely going to change in the near future.
+   * WARNING: This feature is *highly experimental* and currently only
+   * works on Linux. The API will be removed in Dart 1.10. Use the
+   * `shared` optional argument on the `bind` method instead.
    *
    * The returned [ServerSocketReference] can be used to create other
    * [ServerSocket]s listening on the same port,
    * using [ServerSocketReference.create].
    * Incoming connections on the port will be distributed fairly between the
    * active server sockets.
    * The [ServerSocketReference] can be distributed to other isolates through a
    * [SendPort].
    */
+  @Deprecated('This will be removed in Dart 1.10. '
+              'Use the `shared` optional argument on the `bind` method instead.')

[kustermann, 2015/02/17 11:30:56]

long line

[Søren Gjesse, 2015/02/17 12:53:11]

Done.

   ServerSocketReference get reference;
 }
 
 
 /**
  * A [ServerSocketReference].
  *
  * WARNING: This class is used with [ServerSocket.reference] which is highly
  * experimental.
  */
+@Deprecated('This will be removed in Dart 1.10.')
 abstract class ServerSocketReference {
   /**
    * Create a new [ServerSocket], from this reference.
    */
   Future<ServerSocket> create();
 }
 
 
 /**
  * The [SocketDirection] is used as a parameter to [Socket.close] and
@@ skipping 377 matching lines @@
     }
     if (address != null) {
       sb.write(", address = ${address.host}");
     }
     if (port != null) {
       sb.write(", port = $port");
     }
     return sb.toString();
   }
 }