Struct SubmitAgent

pub struct SubmitAgent { /* private fields */ }

提交代理（SubmitAgent）是用户通过 ZeroCopyHandle::reserve_writer 成功预留空间后获得的对象。 它代表一个已确认的预留，包含预留 ID、偏移量和大小。 用户必须将此 Agent 转换为 SingleAgent 或 ChunkAgent 来实际提交数据， 或者直接 Drop 它以取消预留（这会通知 Manager 预留失败）。

注意： 直接 Drop SubmitAgent 会隐式地通知 Manager 该预留失败。 如果想成功提交数据，必须调用 into_single_agent 或 into_chunk_agent。

Implementations

impl SubmitAgent

pub fn id(&self) -> ReservationId

获取预留 ID

pub fn offset(&self) -> AbsoluteOffset

获取预留的起始偏移量

pub fn size(&self) -> usize

获取预留的大小

pub fn into_single_agent(self) -> SingleAgent

将 SubmitAgent 转换为 SingleAgent，用于单次提交所有数据。 转换后，原 SubmitAgent 被消费，其 Drop 实现不会再发送失败通知。 如果转换后的 SingleAgent 被 Drop 而未成功提交数据，则由 SingleAgent 的 Drop 实现负责通知 Manager 失败。

pub fn into_chunk_agent(self) -> ChunkAgent

将 SubmitAgent 转换为 ChunkAgent，用于分块提交数据。 转换后，原 SubmitAgent 被消费，其 Drop 实现不会再发送失败通知。 如果转换后的 ChunkAgent 被 Drop 而未成功提交数据，则由 ChunkAgent 的 Drop 实现负责通知 Manager 失败。

Trait Implementations

impl Debug for SubmitAgent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for SubmitAgent

SubmitAgent 的 Drop 实现。 如果 Agent 没有被消费 (即没有调用 into_single_agent 或 into_chunk_agent) 就被 Drop， 则向 Manager 发送预留失败的通知。

fn drop(&mut self)

Executes the destructor for this type.