Table of Contents

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

input PipeReader

载体读半边(Input)。

maxFrameLength int

帧长上限(协商上限 ≤ MaxFrameLength)。

Properties

FramesRead

已读帧数(单调——§9 计数面)。

public long FramesRead { get; }

Property Value

long

ProtocolErrorCount

协议错误计数(单调——§9 计数面;可配置断连阈值的观察口,阈值策略归通道 C2)。

public long ProtocolErrorCount { get; }

Property Value

long

Methods

CompleteAsync()

关闭读半边(终态收场——通道断开时由上层调用)。

public ValueTask CompleteAsync()

Returns

ValueTask

ReadFrameAsync(CancellationToken)

读下一完整帧体。帧间流结束=null(对端正常收场);字节级协议错误=事件+计数后抛 CellTransportException(分帧已破,连接不可续——绝不静默)。

public ValueTask<PooledFrame?> ReadFrameAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

Returns

ValueTask<PooledFrame?>

Events

ProtocolError

字节级协议错误事件(超限前缀/帧中途流断——报告后流终止;D5 必报告)。

public event EventHandler<CellProtocolErrorEventArgs>? ProtocolError

Event Type

EventHandler<CellProtocolErrorEventArgs>