Struct DirtyTracker 

pub struct DirtyTracker { /* private fields */ }

脏字段追踪器

通过维护「原始值快照」与「当前值」两份 HashMap，比较得到脏字段集合。

设计要点

• 快照机制：new() 时将所有字段视为「原始值」
• 修改追踪：set() 修改字段时，仅写入 current，不动 original
• 脏字段判定：original[field] != current[field] 则该字段为脏
• 新字段处理：set() 一个 original 中不存在的字段时，自动视为脏字段 （等价于 original[field] = Null）
• mark_clean：写入成功后调用，将 original 同步为 current
• rollback：写入失败时调用 rollback()，将 current 还原为 original

Implementations

impl DirtyTracker

pub fn new(initial: HashMap<String, Value>) -> Self

创建脏字段追踪器，传入初始字段值作为快照

pub fn empty() -> Self

创建空追踪器

pub fn set(&mut self, field: impl Into<String>, value: Value)

设置字段值（修改 current，不动 original）

若字段原本不存在（original 中无），则视为新增脏字段。

pub fn set_many(&mut self, fields: HashMap<String, Value>)

批量设置字段值

pub fn get(&self, field: &str) -> Option<&Value>

获取当前值

pub fn get_original(&self, field: &str) -> Option<&Value>

获取原始值（写入失败时可用于回滚业务层）

pub fn current(&self) -> &HashMap<String, Value>

获取所有字段的当前值（克隆）

pub fn original(&self) -> &HashMap<String, Value>

获取所有字段的原始值（克隆）

pub fn is_dirty(&self) -> bool

是否存在脏字段

pub fn is_field_dirty(&self, field: &str) -> bool

判断指定字段是否为脏

pub fn get_dirty_fields(&self) -> Vec<String>

获取所有脏字段名（按字段名字典序排列，保证测试稳定）

pub fn get_dirty_attributes(&self) -> HashMap<String, Value>

获取脏字段及其当前值

pub fn mark_clean(&mut self)

标记所有字段为干净（写入成功后调用）

将 original 同步为 current，下一次 is_dirty() 返回 false。

pub fn rollback(&mut self)

回滚：将 current 还原为 original（写入失败时调用）

pub fn clear(&mut self)

重置追踪器，丢弃所有数据

Trait Implementations

impl Clone for DirtyTracker

fn clone(&self) -> DirtyTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirtyTracker

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

Formats the value using the given formatter.