Struct ChangeTracker 

pub struct ChangeTracker { /* private fields */ }

变更跟踪器

管理多个实体的状态，提供批量变更检测和变更集生成。

Implementations

impl ChangeTracker

pub fn new() -> Self

pub fn track( &mut self, table: &str, id: &str, current: HashMap<String, Value>, state: EntityState, )

跟踪实体

如果状态为 Unchanged，会保存当前值作为原始值快照。 如果状态为 Modified，会保留之前的原始值快照。

pub fn mark_added( &mut self, table: &str, id: &str, entity: HashMap<String, Value>, )

标记为新增

pub fn mark_unchanged( &mut self, table: &str, id: &str, entity: HashMap<String, Value>, )

标记为未变更（从数据库加载后调用）

pub fn update(&mut self, table: &str, id: &str, entity: HashMap<String, Value>)

标记为已修改

pub fn mark_deleted(&mut self, table: &str, id: &str)

标记为已删除

pub fn detach(&mut self, table: &str, id: &str)

分离实体（停止跟踪）

pub fn detect_changes(&mut self)

自动检测变更

遍历所有 Unchanged 实体，如果 current 与 original 不同，自动转为 Modified。

pub fn get_pending_changes(&self) -> Vec<&EntityEntry>

获取所有待提交的变更

pub fn get_pending_changes_by_table(&self) -> HashMap<String, Vec<&EntityEntry>>

按表分组获取待提交的变更

pub fn entry(&self, table: &str, id: &str) -> Option<&EntityEntry>

获取条目

pub fn count(&self) -> usize

跟踪的实体数量

pub fn pending_count(&self) -> usize

待提交的变更数量

pub fn accept_changes(&mut self)

清除所有跟踪状态（SaveChanges 成功后调用）

pub fn build_sql_operations(&self) -> Vec<(String, Vec<Value>)>

将待提交的变更转换为 SQL 语句列表（生产接线点）

这是 ChangeTracker 与 SQL 生成的集成点。 生成的 SQL 使用参数化占位符 ?，参数通过返回值一并给出。

Trait Implementations

impl Default for ChangeTracker

fn default() -> Self

Returns the “default value” for a type.