Enum ActiveValue 

pub enum ActiveValue<T> {
    Set(T),
    Unchanged,
    NotSet,
}

字段值的三态表示

类比 SeaORM 的 ActiveValue / Rails 的 ActiveModel::Attribute：

变体	含义	UPDATE 行为
Set(v)	用户显式设置了新值	包含在 SET 子句
Unchanged	字段存在但未被修改	不包含在 SET 子句
NotSet	字段尚未被赋值（新建模型默认状态）	不包含在 SET 子句

示例

use sz_orm_core::active_model::ActiveValue;
use sz_orm_core::Value;

// 设置一个字段
let av: ActiveValue<Value> = ActiveValue::Set(Value::String("Alice".into()));
assert!(av.is_set());

// 从任意 Into<Value> 类型自动转换
let av: ActiveValue<Value> = "hello".into();
assert_eq!(av.into_value(), Some(Value::String("hello".into())));

// NotSet 是默认值
let av: ActiveValue<Value> = ActiveValue::default();
assert!(av.is_not_set());

Variants

Set(T)

用户显式设置了新值

Unchanged

字段存在但未被修改（用于从 DB 加载后的模型）

NotSet

字段尚未被赋值（用于新建模型）

Implementations

impl<T> ActiveValue<T>

pub fn is_set(&self) -> bool

判断是否为 Set 变体

pub fn is_unchanged(&self) -> bool

判断是否为 Unchanged 变体

pub fn is_not_set(&self) -> bool

判断是否为 NotSet 变体

pub fn into_value(self) -> Option<T>

取出 Set 中的值，其他变体返回 None

pub fn as_value(&self) -> Option<&T>

借用 Set 中的值，其他变体返回 None

Trait Implementations

impl<T: Clone> Clone for ActiveValue<T>

fn clone(&self) -> ActiveValue<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ActiveValue<T>

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

Formats the value using the given formatter.

impl<T> Default for ActiveValue<T>

fn default() -> ActiveValue<T>

Returns the “default value” for a type.

impl<T: Into<Value>> From<T> for ActiveValue<Value>

从任意 Into<Value> 类型自动转换为 ActiveValue<Value>

这使得 active.set("name", "Alice") 可以自动将 "Alice" 转为 ActiveValue::Set(Value::String(...))。

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: PartialEq> PartialEq for ActiveValue<T>

fn eq(&self, other: &ActiveValue<T>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for ActiveValue<T>