Struct Draft

pub struct Draft {
    pub base: Arc<NodePool>,
    pub inner: NodePoolInner,
    pub patches: Vector<Patch>,
    pub current_path: Vector<String>,
    pub skip_record: bool,
    pub begin: bool,
}

草稿修改上下文，用于安全地修改节点池

跟踪以下信息：

• 基础版本节点池
• 当前修改的中间状态
• 生成的修改补丁
• 当前操作路径（用于嵌套数据结构）

Fields

base: Arc<NodePool>

inner: NodePoolInner

patches: Vector<Patch>

current_path: Vector<String>

skip_record: bool

begin: bool

Implementations

impl Draft

pub fn new(base: Arc<NodePool>) -> Self

创建基于现有节点池的草稿

参数

• base - 基础版本节点池的引用

pub fn enter_map(&mut self, key: &str) -> &mut Self

进入嵌套路径（用于记录结构化修改）

参数

• key - Map 类型的字段名称

示例

draft.enter_map("content").enter_list(0);

pub fn enter_list(&mut self, index: usize) -> &mut Self

进入嵌套路径（List类型索引）

pub fn exit(&mut self) -> &mut Self

退出当前路径层级

pub fn update_attr( &mut self, id: &NodeId, new_values: HashMap<String, Value>, ) -> Result<(), PoolError>

提交属性修改并记录补丁

参数

• id - 目标节点ID
• new_values - 新属性集合

错误

当节点不存在时返回 PoolError::NodeNotFound

pub fn remove_mark(&mut self, id: &NodeId, mark: Mark) -> Result<(), PoolError>

从节点中移除指定标记

参数

• id - 目标节点ID
• mark - 要移除的标记

错误

当节点不存在时返回 PoolError::NodeNotFound

pub fn add_mark( &mut self, id: &NodeId, marks: &Vec<Mark>, ) -> Result<(), PoolError>

为节点添加标记

参数

• id - 目标节点ID
• marks - 要添加的标记列表

错误

当节点不存在时返回 PoolError::NodeNotFound

pub fn sort_children<F: FnMut(&(NodeId, &Arc<Node>), &(NodeId, &Arc<Node>)) -> Ordering>( &mut self, parent_id: &NodeId, compare: F, ) -> Result<(), PoolError>

对节点的子节点进行排序

参数

• parent_id - 父节点ID
• compare - 排序比较函数

错误

当父节点不存在时返回 PoolError::ParentNotFound

pub fn add_node( &mut self, parent_id: &NodeId, nodes: &Vec<Node>, ) -> Result<(), PoolError>

添加子节点

参数

• parent_id - 父节点ID
• nodes - 要添加的子节点列表

pub fn replace_node( &mut self, node_id: NodeId, nodes: &Vec<Node>, ) -> Result<(), PoolError>

pub fn move_node( &mut self, source_parent_id: &NodeId, target_parent_id: &NodeId, node_id: &NodeId, position: Option<usize>, ) -> Result<(), PoolError>

移动节点

pub fn get_node(&self, id: &NodeId) -> Option<&Arc<Node>>

pub fn children(&self, parent_id: &NodeId) -> Option<&Vector<NodeId>>

pub fn remove_node( &mut self, parent_id: &NodeId, nodes: Vec<NodeId>, ) -> Result<(), PoolError>

移除子节点

参数

• parent_id - 父节点ID
• nodes - 要移除的子节点ID列表

错误

当父节点不存在时返回 PoolError::ParentNotFound 当尝试删除根节点时返回 PoolError::CannotRemoveRoot 当要删除的节点不是父节点的直接子节点时返回 PoolError::InvalidParenting

pub fn apply_patches(&mut self, patches: &Vec<Patch>) -> Result<(), PoolError>

应用补丁集合并更新节点池

参数

• patches - 要应用的补丁集合

注意

应用过程中会临时禁用补丁记录

pub fn reverse_patches(&mut self, patches: Vec<Patch>) -> Result<(), PoolError>

翻转补丁集合并应用到节点池

pub fn commit(&self) -> StepResult

提交修改，生成新 NodePool 和补丁列表

Trait Implementations

impl Clone for Draft

fn clone(&self) -> Draft

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Draft

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

Formats the value using the given formatter.