Table of Contents

Interface ICellPackBuilder

Namespace
KernLab.Cell.Contracts
Assembly
KernLab.Cell.Contracts.dll

pack 装配面(容器侧引导器在 Configure(ICellPackBuilder) 时交付; 装载点键=Invoke 帧分派键,数据面词汇权归使用方——CodecId 随点声明,§3.1)。

public interface ICellPackBuilder

Properties

CallbackBridge

回调桥(§6.4——pack 经此调用宿主服务;容器不认识任何具体服务)。

ICellCallbackBridge CallbackBridge { get; }

Property Value

ICellCallbackBridge

Notifications

通知出口(双向通知设计稿 §2.1——免应答推送 C→H;即时返回、满则丢最旧、永不阻塞业务路径)。

ICellNotificationEgress Notifications { get; }

Property Value

ICellNotificationEgress

Telemetry

遥测出口(§6.4——best-effort 永不阻塞调用路径)。

ICellTelemetryEgress Telemetry { get; }

Property Value

ICellTelemetryEgress

Methods

DeclareResource(CellResourceDeclaration)

声明 pack 资源档(§6.3——供宿主侧 spec 翻译 OS 执法;可多次调用取并集)。

void DeclareResource(CellResourceDeclaration resource)

Parameters

resource CellResourceDeclaration

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

key string

通知键(NotifyFrame.Key,UTF-8 线内 ≤256B——使用方自定义串)。

handler Func<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

key string

装载点键(Invoke.SiteKey,UTF-8 线内 ≤256B)。

codecId ushort

装载点声明的载荷编解码(CellCodecIds——声明即检查)。

handler Func<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

key string

装载点键(ChunkBegin.SiteKey,UTF-8 线内 ≤256B;与 RegisterSite(string, ushort, Func<ReadOnlyMemory<byte>, CancellationToken, ValueTask<ReadOnlyMemory<byte>>>) 键空间互斥)。

codecId ushort

装载点声明的载荷编解码(CellCodecIds)。

handler Func<PipeReader, PipeWriter, CancellationToken, ValueTask>

流式处理器:请求体 PipeReader 流式读(读到流结束=体尽); 响应写 PipeWriter(运行时泵成 ChunkData 流);handler 抛出=ChunkEnd(InvocationThrew)。