Skip to main content

Storage

Struct Storage 

Source
pub struct Storage {
    pub name: Ident,
    pub comparison: Ident,
    pub from: Conversion,
    pub into: Conversion,
    pub columns: Vec<PersistColumn>,
    pub fills: Vec<Filled>,
    pub aliases: AliasOptions,
}
Expand description

What every backend carries, whatever its own vocabulary adds.

One struct embedded in each backend rather than six fields repeated four times — the emission reads these and nothing else for most of its work, and a field that meant something different per backend would not be here.

Fields§

§name: Ident

The name of the emitted ROW type — default_row_name unless row(rename = "…") named it.

§comparison: Ident

The name of the emitted COMPARISON type — default_comparison_name unless comparison(rename = "…") named it.

Its OWN block, because a database emits two types and a bare rename could not say which.

§from: Conversion

A conversion for the WHOLE row: from BUILDS this projection, so domain → row. A write.

§into: Conversion

A conversion for the WHOLE row: into LEAVES this projection, so row → domain. A read.

When it is not Conversion::Default it replaces the field-wise body, which is what lets a PARTIAL row reach the record at all — the field-wise read can only be emitted when the row carries every field.

§columns: Vec<PersistColumn>

THIS DATABASE’s columns, in the record’s declaration order.

§The participation MASK, and what it is a mask over

The universal list is every data field the record declares less the ones wearing skip — the inversion’s own answer, and the whole list for a declaration that narrows nothing. This one is that list masked by what each field said to THIS database: a bare <db> list keeps the databases it names, and <db>(skip(default = "…")) drops the one it names.

So the databases may now DISAGREE about which columns exist, and every seat that reads a per-database fact reads this one: the row struct, the INSERT list, the SELECT, this database’s comparison and its own duplicate-name fence. The seats that must not vary with a deployment’s storage choice read the INTERSECTION instead — see RecordModel::stored_columns, where the shared query vocabulary is stated.

What a field withheld from this database still owes is the READ, and fills is where that is answered.

§fills: Vec<Filled>

What THIS DATABASE’s raise supplies for the fields its row does not carry.

§A per-database seat, where skip at the field is the record’s own

A field wearing the bare skip is a column of no database, so every raise supplies it from the one fill that word named and the answer does not vary — that stays read off the record’s own fields. This is the OTHER absence: a field that IS a column of the record’s other databases and not of this one, whose fill is therefore this database’s own.

EMPTY is the ordinary case, and is every declaration that narrows nothing. A partial absence with no fill never reaches here — it is a named refusal at the word that narrowed, because a value that round-trips out of one store and is invented out of the next is a difference only the declaration can record.

§aliases: AliasOptions

alias(…) — the namespace and the depth this database’s row-source names are minted at.

Here rather than on the four backend structs because it is the same option in all four: an alias is a name a NESTED scope calls a row source by, which every backend that nests one has. Which is also why it is per BACKEND rather than per record — see AliasOptions.

Trait Implementations§

Source§

impl Clone for Storage

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Storage

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.