Struct ActiveModel 

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

A smart wrapper around a Model tracking modified columns dynamically.

Used to perform targeted, minimal UPDATE or INSERT queries that only persist the columns that have actually changed.

Fields

inner: M

The underlying model instance.

Implementations

impl<M: Model> ActiveModel<M>

pub fn new_insert(model: M) -> Self

Create a new ActiveModel for an entity that hasn’t been saved yet.

pub fn from_model(model: M) -> Self

Wrap an existing model into an ActiveModel state tracker for updates.

pub fn set<T: ToSql>(&mut self, column: &'static str, value: T)

Flag a column as modified and stage its value for an upcoming transaction.

pub fn has_changes(&self) -> bool

Returns whether any columns have been modified.

pub fn changed_columns(&self) -> Vec<&'static str>

Returns the list of changed column names.

pub fn is_new(&self) -> bool

Evaluates whether the underlying model has not been persisted yet.

pub fn save(&mut self, executor: &mut impl Executor) -> OrmResult<()>

Intelligently issues an INSERT or UPDATE depending on is_new() state.

Validates the model before persisting.

pub fn insert(&mut self, executor: &mut impl Executor) -> OrmResult<()>

Executes a minimal INSERT using only tracked changes.

Validates the model before persisting.

pub fn update(&mut self, executor: &mut impl Executor) -> OrmResult<()>

Executes a focused UPDATE persisting only the changed columns.

Validates the model before persisting. No-op if nothing has changed.

Trait Implementations

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

fn from(model: M) -> Self

Converts to this type from the input type.