Struct MutationBuilder

pub struct MutationBuilder<E: Entity> { /* private fields */ }

A mutation builder for the model entity.

Examples

use crate::model::{User, UserColumn};
use zino_orm::{MutationBuilder, QueryBuilder, Schema};

let query = QueryBuilder::<User>::new()
    .primary_key("01936dc6-e48c-7d22-8e69-b29f85682fac")
    .and_not_in(UserColumn::Status, ["Deleted", "Locked"])
    .build();
let mut mutation = MutationBuilder::<User>::new()
    .set(UserColumn::Status, "Active")
    .set_now(UserColumn::UpdatedAt)
    .inc_one(UserColumn::Version)
    .build();
let ctx = User::update_one(&query, &mut mutation).await?;

Implementations

impl<E: Entity> MutationBuilder<E>

pub fn new() -> Self

Creates a new instance.

pub fn set(self, col: E::Column, value: impl IntoSqlValue) -> Self

Sets the value of a column.

pub fn set_if_not_null(self, col: E::Column, value: impl IntoSqlValue) -> Self

Sets the value of a column if the value is not null.

pub fn set_if_some<T: IntoSqlValue>( self, col: E::Column, value: Option<T>, ) -> Self

Sets the value of a column if the value is not none.

pub fn set_null(self, col: E::Column) -> Self

Sets the value of a column to null.

pub fn set_now(self, col: E::Column) -> Self

Sets the value of a column to the current date time.

pub fn inc(self, col: E::Column, value: impl IntoSqlValue) -> Self

Increments the value of a column.

pub fn inc_one(self, col: E::Column) -> Self

Increments the value of a column by 1.

pub fn mul(self, col: E::Column, value: impl IntoSqlValue) -> Self

Multiplies the value of a column by a number.

pub fn min(self, col: E::Column, value: impl IntoSqlValue) -> Self

Updates the value of a column to a specified value if the specified value is less than the current value of the column.

pub fn max(self, col: E::Column, value: impl IntoSqlValue) -> Self

Updates the value of a column to a specified value if the specified value is greater than the current value of the column.

pub fn build(self) -> Mutation

Builds the model mutation.

Trait Implementations

impl<E: Clone + Entity> Clone for MutationBuilder<E>

fn clone(&self) -> MutationBuilder<E>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<E: Debug + Entity> Debug for MutationBuilder<E>

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

Formats the value using the given formatter.

impl<E: Entity> Default for MutationBuilder<E>

fn default() -> Self

Returns the “default value” for a type.