Chromium Code Reviews| Index: sdk/lib/io/socket.dart |
| diff --git a/sdk/lib/io/socket.dart b/sdk/lib/io/socket.dart |
| index 08f973e695c476a2a18b60fe195518f2140de251..50fc24e17ee3c3456adb726e1c7be5edf6ebdd4d 100644 |
| --- a/sdk/lib/io/socket.dart |
| +++ b/sdk/lib/io/socket.dart |
| @@ -223,6 +223,14 @@ abstract class RawServerSocket implements Stream<RawSocket> { |
| * 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, |
| @@ -249,8 +257,9 @@ abstract class RawServerSocket implements Stream<RawSocket> { |
| /** |
| * 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, |
| @@ -260,6 +269,9 @@ abstract class RawServerSocket implements Stream<RawSocket> { |
| * 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; |
| } |
| @@ -270,6 +282,7 @@ abstract class RawServerSocket implements Stream<RawSocket> { |
| * 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. |
| @@ -315,6 +328,14 @@ abstract class ServerSocket implements Stream<Socket> { |
| * 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, |
| @@ -341,8 +362,9 @@ abstract class ServerSocket implements Stream<Socket> { |
| /** |
| * 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, |
| @@ -352,6 +374,8 @@ abstract class ServerSocket implements Stream<Socket> { |
| * 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; |
| } |
| @@ -362,6 +386,7 @@ abstract class ServerSocket implements Stream<Socket> { |
| * 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. |