Class FrameReader
- Namespace
- KernLab.Cell
- Assembly
- KernLab.Cell.dll
帧读器——分帧(总体设计 §3.1:Cell 拥有;[长度 4B 大端][帧体],上限校验在此一次做完)。
★ 读路径硬解析纪律(§3.6/D5):字节级协议错误(超限前缀/帧中途流断)=结构化协议错误事件+计数+终止, 绝不静默跳过——静默丢帧把协议错误伪装成"对端没反应",排查成本最高。
★ 帧体以池化连续缓冲交付(管道段→池一次拷贝);帧体解码零拷贝契约由
CellFrameCodec.TryDecode(ReadOnlySpan<byte>, out CellFrame)(ReadOnlySpan 原位可解)承责——
shm 档以槽直读满足同契约,通道 API 不变。
public sealed class FrameReader
- Inheritance
-
FrameReader
- Inherited Members
Constructors
FrameReader(PipeReader, int)
构造。
public FrameReader(PipeReader input, int maxFrameLength = 4194304)
Parameters
inputPipeReader载体读半边(Input)。
maxFrameLengthint帧长上限(协商上限 ≤ MaxFrameLength)。
Properties
FramesRead
已读帧数(单调——§9 计数面)。
public long FramesRead { get; }
Property Value
ProtocolErrorCount
协议错误计数(单调——§9 计数面;可配置断连阈值的观察口,阈值策略归通道 C2)。
public long ProtocolErrorCount { get; }
Property Value
Methods
CompleteAsync()
关闭读半边(终态收场——通道断开时由上层调用)。
public ValueTask CompleteAsync()
Returns
ReadFrameAsync(CancellationToken)
读下一完整帧体。帧间流结束=null(对端正常收场);字节级协议错误=事件+计数后抛 CellTransportException(分帧已破,连接不可续——绝不静默)。
public ValueTask<PooledFrame?> ReadFrameAsync(CancellationToken cancellationToken = default)
Parameters
cancellationTokenCancellationToken
Returns
Events
ProtocolError
字节级协议错误事件(超限前缀/帧中途流断——报告后流终止;D5 必报告)。
public event EventHandler<CellProtocolErrorEventArgs>? ProtocolError