Interface ICellPackBuilder
pack 装配面(容器侧引导器在 Configure(ICellPackBuilder) 时交付; 装载点键=Invoke 帧分派键,数据面词汇权归使用方——CodecId 随点声明,§3.1)。
public interface ICellPackBuilder
Properties
CallbackBridge
回调桥(§6.4——pack 经此调用宿主服务;容器不认识任何具体服务)。
ICellCallbackBridge CallbackBridge { get; }
Property Value
Notifications
通知出口(双向通知设计稿 §2.1——免应答推送 C→H;即时返回、满则丢最旧、永不阻塞业务路径)。
ICellNotificationEgress Notifications { get; }
Property Value
Telemetry
遥测出口(§6.4——best-effort 永不阻塞调用路径)。
ICellTelemetryEgress Telemetry { get; }
Property Value
Methods
DeclareResource(CellResourceDeclaration)
声明 pack 资源档(§6.3——供宿主侧 spec 翻译 OS 执法;可多次调用取并集)。
void DeclareResource(CellResourceDeclaration resource)
Parameters
resourceCellResourceDeclaration
RegisterNotificationHandler(string, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask>)
注册通知 handler(双向通知设计稿 §2.3——NotifyFrame 按此键分派;key 词汇=站点键同形; 重复 key=装配错误,与 RegisterSite(string, ushort, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>>) 同口)。
void RegisterNotificationHandler(string key, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask> handler)
Parameters
keystring通知键(NotifyFrame.Key,UTF-8 线内 ≤256B——使用方自定义串)。
handlerFunc<ReadOnlyMemory<byte>, CancellationToken, ValueTask>通知处理器:payload 为独立副本(已脱离池化帧); 应快速返回——串行分派下慢 handler=后续通知在队列溢出丢弃(计数可见);重活转投自有任务; cancellationToken 在容器 drain/关停时置位(尽力通知,不强求处理完)。handler 抛出经取证面记录,分派继续。
RegisterSite(string, ushort, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>>)
注册装载点(§6.3——Invoke 帧按此键分派;重复键=装配错误,容器启动失败)。
void RegisterSite(string key, ushort codecId, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>> handler)
Parameters
keystring装载点键(Invoke.SiteKey,UTF-8 线内 ≤256B)。
codecIdushort装载点声明的载荷编解码(CellCodecIds——声明即检查)。
handlerFunc<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>>调用处理器(payload 进、result 出——业务语义全在使用方)。
RegisterStreamingSite(string, ushort, Func<PipeReader, PipeWriter, CancellationToken, ValueTask>)
注册流式装载点(§6.3 分块流式——ChunkBegin 帧按此键分派;大体载荷内存有界通路;重复键=装配错误)。
void RegisterStreamingSite(string key, ushort codecId, Func<PipeReader, PipeWriter, CancellationToken, ValueTask> handler)
Parameters
keystring装载点键(ChunkBegin.SiteKey,UTF-8 线内 ≤256B;与 RegisterSite(string, ushort, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>>) 键空间互斥)。
codecIdushort装载点声明的载荷编解码(CellCodecIds)。
handlerFunc<PipeReader, PipeWriter, CancellationToken, ValueTask>流式处理器:请求体
PipeReader流式读(读到流结束=体尽); 响应写PipeWriter(运行时泵成 ChunkData 流);handler 抛出=ChunkEnd(InvocationThrew)。