一个 TCP 连接。
一个 套接字连接 将一个 本地 套接字连接到一个 远程 套接字。数据(作为 Uint8List)通过本地套接字接收并通过 read 方法提供,可以通过 write 方法发送到远程套接字。
此类 Stream 接口提供了有关某些更改已发生的事件通知,例如数据变得可用(RawSocketEvent.read)或远程端停止监听(RawSocketEvent.closed)。
- 实现类型
- 实现者
属性
- address → InternetAddress
- 用于连接此套接字的 InternetAddress。无设置器
-
first → Future<
RawSocketEvent> - 此流的第一个元素。无设置器继承
- hashCode → int
- 此对象的哈希码。无设置器继承
- isBroadcast → bool
- 此流是否是广播流。无设置器继承
-
isEmpty → Future<
bool> - 此流是否包含任何元素。无设置器继承
-
last → Future<
RawSocketEvent> - 此流的最后一个元素。无设置器继承
-
length → Future<
int> - 此流中的元素数量。无设置器继承
- port → int
- 此套接字使用的端口号。无设置器
- readEventsEnabled ↔ bool
- 设置或获取,如果 RawSocket 应该监听 RawSocketEvent.read 事件。默认为
true
。获取器/设置器对 - remoteAddress → InternetAddress
- 通过此套接字连接的远程 InternetAddress。无设置器
- remotePort → int
- 此套接字连接的远程端口。无设置器
- runtimeType → Type
- 对象的运行时类型的表示。无设置器继承
-
single → Future<
RawSocketEvent> - 此流的单个元素。无设置器继承
- writeEventsEnabled ↔ bool
- 设置或获取,是否使 RawSocket 监听 RawSocketEvent.write 事件。默认为
true
。这是一个一次性监听器,需要再次将 writeEventsEnabled 设置为 true 才能接收另一个写入事件。获取器/设置器对
方法
-
any(
bool test(RawSocketEvent element)) → Future< bool> - 检查是否接受此流提供的任何元素。继承
-
asBroadcastStream(
{void onListen(StreamSubscription< RawSocketEvent> subscription)?, void onCancel(StreamSubscription<RawSocketEvent> subscription)?}) → Stream<RawSocketEvent> - 返回一个多订阅流,它产生与此相同的事件。继承
-
asyncExpand<
E> (Stream< E> ? convert(RawSocketEvent event)) → Stream<E> - 将每个元素转换为异步事件序列。继承
-
asyncMap<
E> (FutureOr< E> convert(RawSocketEvent event)) → Stream<E> - 创建一个新的流,其中每个数据事件都会异步映射到一个新的事件。继承
-
available(
) → int - 可读的接收且未读取的字节数。
-
cast<
R> () → Stream< R> - 将此流适配为
Stream<R>
。继承 -
close(
) → Future< RawSocket> - 关闭套接字。
-
contains(
Object? needle) → Future< bool> - 返回是否在流提供的数据元素中发生
needle
。继承 -
distinct(
[bool equals(RawSocketEvent previous, RawSocketEvent next)?]) → Stream< RawSocketEvent> - 如果数据事件与上一个数据事件相等,则跳过数据事件。继承
-
drain<
E> ([E? futureValue]) → Future< E> - 丢弃此流上的所有数据,但会在完成或发生错误时发出信号。继承
-
elementAt(
int index) → Future< RawSocketEvent> - 返回此流的第
index
个数据事件的值。继承 -
every(
bool test(RawSocketEvent element)) → Future< bool> - 检查是否所有由该流提供的元素都接受
test
。继承 -
expand<
S> (Iterable< S> convert(RawSocketEvent element)) → Stream<S> - 将此流的每个元素转换为元素序列。继承
-
firstWhere(
bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future< RawSocketEvent> - 查找符合
test
的此流的第一个元素。继承 -
fold<
S> (S initialValue, S combine(S previous, RawSocketEvent element)) → Future< S> - 通过重复应用
combine
来组合一系列值。继承 -
forEach(
void action(RawSocketEvent element)) → Future< void> - 对此流的每个元素执行
action
。继承 -
getRawOption(
RawSocketOption option) → Uint8List - 读取关于 RawSocket 的底层信息。
-
handleError(
Function onError, {bool test(dynamic error)?}) → Stream< RawSocketEvent> - 创建一个包装流,该流拦截来自此流的一些错误。继承
-
join(
[String separator = ""]) → Future< String> - 将元素的字面量表示形式组合成一个字符串。继承
-
lastWhere(
bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future< RawSocketEvent> - 查找在此流中匹配
test
的最后一个元素。继承 -
listen(
void onData(RawSocketEvent event)?, {Function? onError, void onDone()?, bool? cancelOnError}) → StreamSubscription< RawSocketEvent> - 向此流添加一个订阅。继承
-
map<
S> (S convert(RawSocketEvent event)) → Stream< S> - 将此流的每个元素转换为一个新的流事件。继承
-
noSuchMethod(
Invocation invocation) → dynamic - 当访问不存在的方法或属性时被调用。继承
-
pipe(
StreamConsumer< RawSocketEvent> streamConsumer) → Future - 将此流的每个事件导入到
streamConsumer
。继承 -
read(
[int? len]) → Uint8List? - 从套接字中读取最多
len
个字节。 -
readMessage(
[int? count]) → SocketMessage? - 从套接字中读取最多
count
字节的消息。 -
reduce(
RawSocketEvent combine(RawSocketEvent previous, RawSocketEvent element)) → Future< RawSocketEvent> - 通过重复应用
combine
来组合一系列值。继承 -
sendMessage(
List< SocketControlMessage> controlMessages, List<int> data, [int offset = 0, int? count]) → int - 将套接字控制消息和数据字节写入套接字。
-
setOption(
SocketOption option, bool enabled) → bool - 自定义 RawSocket。
-
setRawOption(
RawSocketOption option) → void - 自定义 RawSocket。
-
shutdown(
SocketDirection direction) → void - 在
direction
方向上关闭套接字。 -
singleWhere(
bool test(RawSocketEvent element), {RawSocketEvent orElse()?}) → Future< RawSocketEvent> - 查找与此流中匹配
test
的单个元素。继承 -
skip(
int count) → Stream< RawSocketEvent> - 跳过该流中的前
count
个数据事件。继承 -
skipWhile(
bool test(RawSocketEvent element)) → Stream< RawSocketEvent> - 在事件通过
test
匹配时跳过该流中的数据事件。继承 -
take(
int count) → Stream< RawSocketEvent> - 提供该流的前
count
个数据事件,最多。继承 -
takeWhile(
bool test(RawSocketEvent element)) → Stream< RawSocketEvent> - 在
test
成功时传递数据事件。继承 -
timeout(
Duration timeLimit, {void onTimeout(EventSink< RawSocketEvent> sink)?}) → Stream<RawSocketEvent> - 创建一个具有与该流相同事件的新的流。继承
-
toList(
) → Future< List< RawSocketEvent> > - 将此流的全部元素收集到List中。继承
-
toSet(
) → Future< Set< RawSocketEvent> > - 将此流的数据收集到Set中。继承
-
toString(
) → String - 该对象的字符串表示。继承
-
transform<
S> (StreamTransformer< RawSocketEvent, S> streamTransformer) → Stream<S> - 将
streamTransformer
应用到此流。继承 -
where(
bool test(RawSocketEvent event)) → Stream< RawSocketEvent> - 从此流创建一个新的流,丢弃一些元素。继承
-
write(
List< int> buffer, [int offset = 0, int? count]) → int - 将缓冲区中从
offset
缓冲区偏移量开始的最多count
字节写入套接字。
运算符
-
operator ==(
Object other) → bool - 相等运算符。继承
静态方法
-
connect(
dynamic host, int port, {dynamic sourceAddress, int sourcePort = 0, Duration? timeout}) → Future< RawSocket> - 创建到主机和端口的新的套接字连接。
-
startConnect(
dynamic host, int port, {dynamic sourceAddress, int sourcePort = 0}) → Future< ConnectionTask< RawSocket> > - 类似于 connect,但返回一个 Future,当不再需要 RawSocket 时可以取消该 ConnectionTask。