Deprecate WebSocketChannel.

lib/src/web_socket/channel.dart

 // Copyright (c) 2016, 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.
 
 import 'dart:async';
 
 import 'package:async/async.dart';
 import 'package:crypto/crypto.dart';
 import 'package:stream_channel/stream_channel.dart';
 
 import '../copy/web_socket_impl.dart';
 
-/// A [StreamChannel] implementation of the WebSocket protocol.
+/// This class is deprecated.
 ///
-/// This is not specific to `dart:io` or to any particular HTTP API. Because of
-/// that, it doesn't handle the initial [WebSocket handshake][]. This needs to
-/// be handled manually by the user of the code. Once that's been done, [new
-/// WebSocketChannel] can be called with the underlying socket and it will
-/// handle the remainder of the protocol.
+/// Use the [`web_socket_channel`][web_socket_channel] package instead.
 ///
-/// [WebSocket handshake]: https://tools.ietf.org/html/rfc6455#section-4
+/// [web_socket_channel]: https://pub.dartlang.org/packages/web_socket_channel
+@Deprecated("Will be removed in 3.0.0.")
 class WebSocketChannel extends StreamChannelMixin {
   /// The underlying web socket.
   ///
   /// This is essentially a copy of `dart:io`'s WebSocket implementation, with
   /// the IO-specific pieces factored out.
   final WebSocketImpl _webSocket;
 
   /// The interval for sending ping signals.
   ///
   /// If a ping message is not answered by a pong message from the peer, the
@@ skipping 60 matching lines @@
   /// If this is a WebSocket server, [serverSide] should be `true` (the
   /// default); if it's a client, [serverSide] should be `false`.
   ///
   /// [WebSocket handshake]: https://tools.ietf.org/html/rfc6455#section-4
   WebSocketChannel(StreamChannel<List<int>> channel,
         {String protocol, bool serverSide: true})
       : _webSocket = new WebSocketImpl.fromSocket(
           channel.stream, channel.sink, protocol, serverSide);
 }
 
-/// The sink exposed by a [CompatibleWebSocket].
+/// This class is deprecated.
 ///
-/// This is like a normal [StreamSink], except that it supports extra arguments
-/// to [close].
+/// Use the [`web_socket_channel`][web_socket_channel] package instead.
+///
+/// [web_socket_channel]: https://pub.dartlang.org/packages/web_socket_channel
+@Deprecated("Will be removed in 3.0.0.")
 class WebSocketSink extends DelegatingStreamSink {
   final WebSocketImpl _webSocket;
 
   WebSocketSink._(WebSocketImpl webSocket)
       : super(webSocket),
         _webSocket = webSocket;
 
   /// Closes the web socket connection.
   ///
   /// [closeCode] and [closeReason] are the [close code][] and [reason][] sent
   /// to the remote peer, respectively. If they are omitted, the peer will see
   /// a "no status received" code with no reason.
   ///
   /// [close code]: https://tools.ietf.org/html/rfc6455#section-7.1.5
   /// [reason]: https://tools.ietf.org/html/rfc6455#section-7.1.6
   Future close([int closeCode, String closeReason]) =>
       _webSocket.close(closeCode, closeReason);
 }