Struct Record 

pub struct Record { /* private fields */ }

A dynamic record: an entity name, an optional id, and its attributes.

Implementations

impl Record

pub fn new(entity: impl Into<String>) -> Self

An empty record for entity, with no id (the shape of a create).

pub fn with_id(entity: impl Into<String>, id: i64) -> Self

An empty record for an existing row (the shape of an update).

pub fn entity(&self) -> &str

The entity this record belongs to: a fixed table or a runtime content type.

pub fn id(&self) -> Option<i64>

The primary key, None until a create returns one.

pub fn set_id(&mut self, id: i64)

Records the id a create returned.

pub fn set( &mut self, key: impl Into<String>, value: impl Into<AttrValue>, ) -> &mut Self

Sets an attribute, replacing any previous value. Chainable.

pub fn get(&self, key: &str) -> Option<&AttrValue>

An attribute, or None when the key is absent. An attribute that is present and null returns Some(AttrValue::Null), which is a different thing: absent means “not part of this write”, null means “write NULL”.

pub fn remove(&mut self, key: &str) -> Option<AttrValue>

Removes an attribute, returning it.

pub fn contains(&self, key: &str) -> bool

Whether the key is present, null or not.

pub fn iter(&self) -> impl Iterator<Item = (&str, &AttrValue)>

The attributes, in key order.

pub fn len(&self) -> usize

How many attributes are set.

pub fn is_empty(&self) -> bool

Whether no attribute is set.

pub fn text(&self, key: &str) -> Option<&str>

The text at key, when it holds AttrValue::Text.

pub fn int(&self, key: &str) -> Option<i64>

The integer at key.

pub fn float(&self, key: &str) -> Option<f64>

The float at key.

pub fn bool(&self, key: &str) -> Option<bool>

The boolean at key.

pub fn datetime(&self, key: &str) -> Option<DateTime<Utc>>

The instant at key.

pub fn json(&self, key: &str) -> Option<&Value>

The JSON at key.

pub fn set_original(&mut self, previous: Record)

Records the row as it stood before this write, read inside the same transaction. The pipeline sets it on an update when the persister can supply one.

pub fn has_original(&self) -> bool

Whether a pre-write snapshot is available. A create never has one, and neither does an update whose persister does not supply one.

pub fn original(&self, key: &str) -> Option<&AttrValue>

The pre-write value at key.

pub fn changed(&self, key: &str) -> bool

Whether this write changes key. Always false without a snapshot, so a change-based listener should check Record::has_original first rather than read “unchanged” into its absence.

The comparison is text-level today: a snapshot is read back as text, so a listener that re-types an unchanged value (a date parsed into a AttrValue::DateTime) reads as changed. Fine for stamping, not yet sufficient for a per-attribute diff.

pub fn deserialize<T: DeserializeOwned>(&self) -> Result<T, Error>

Reads the attributes into a struct, for code that would rather work with types than a bag. Attributes the target does not name are ignored.

pub fn from_text_map( entity: impl Into<String>, data: &HashMap<String, String>, ) -> Self

Builds a record from an all-text submission, the shape the form write path uses today. Every value arrives as AttrValue::Text, because a string carries no type; typed values come from field types and listeners.

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

The record as an all-text map, for a storage layer that binds strings. A null attribute becomes an empty string, matching that path’s existing “empty means none” contract.

Trait Implementations

impl Clone for Record

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Record

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

Formats the value using the given formatter.

impl Default for Record

fn default() -> Self

Returns the “default value” for a type.