Struct ActiveModel 

pub struct ActiveModel<M: Model> { /* private fields */ }

通用 ActiveModel 包装器

为任意 Model 类型提供 dirty tracking：

• 从 Model 创建时，所有字段初始为 Unchanged
• 从 Default 创建时（新建记录），所有字段初始为 NotSet

业务模型通过 set() 方法标记变更字段， 然后传给 update / save 执行持久化。

示例

let user = User::find_by_id(1, &mut conn).await?;
let mut active = ActiveModel::from_model(user);
active.set("email", "new@example.com".into()); // ActiveValue::Set
update(&mut conn, active).await?;

Implementations

impl<M: Model> ActiveModel<M>

pub fn from_model(model: M) -> Self

从已有模型创建 ActiveModel（所有字段初始为 Unchanged）

适用于“加载 → 修改部分字段 → 更新“的工作流。

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

设置一个字段的值（标记为 Set）

示例

active.set("name", ActiveValue::Set("Alice".into()));
// 或简写（利用 From 自动转换）：
active.set("name", "Alice".into());

pub fn unset(&mut self, field: &str)

将字段标记为 Unchanged（从变更集中移除）

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

获取某个字段的当前状态

pub fn changed_fields(&self) -> Vec<(&str, &Value)>

获取所有变更字段列表（仅 Set 状态）

pub fn as_mut_model(&mut self) -> &mut M

获取底层模型的可变引用

pub fn as_model(&self) -> &M

获取底层模型的不可变引用

pub fn into_model(self) -> M

消耗包装器，返回底层模型

Trait Implementations

impl<M: Model> ActiveModelTrait for ActiveModel<M>

where M::PrimaryKey: Into<Value>,

fn table_name(&self) -> &str

获取表名

fn pk_value(&self) -> Option<Value>

获取主键值（用于 WHERE 条件）

fn for_each_changed<F>(&self, f: F)

where F: FnMut(&str, &ActiveValue<Value>),

遍历所有已设置（Set）的字段

impl<M: Clone + Model> Clone for ActiveModel<M>

fn clone(&self) -> ActiveModel<M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M: Debug + Model> Debug for ActiveModel<M>

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

Formats the value using the given formatter.