Struct Related 

pub struct Related<T: Model> { /* private fields */ }

A related single object (many-to-one or one-to-one).

This wrapper can be in one of three states:

• Empty: no relationship (fk_value is None)
• Unloaded: has FK value but not fetched yet (fk_value is Some, loaded unset)
• Loaded: the object has been fetched and cached (loaded set)

Implementations

impl<T: Model> Related<T>

pub const fn empty() -> Self

Create an empty relationship (null FK, not loaded).

pub fn from_fk(fk: impl Into<Value>) -> Self

Create from a foreign key value (not yet loaded).

pub fn loaded(obj: T) -> Self

Create with an already-loaded object.

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

Get the loaded object (None if not loaded or loaded as null).

pub fn is_loaded(&self) -> bool

Check if the relationship has been loaded (including loaded-null).

pub fn is_empty(&self) -> bool

Check if the relationship is empty (null FK).

pub fn fk(&self) -> Option<&Value>

Get the foreign key value (if present).

pub fn set_loaded(&self, obj: Option<T>) -> Result<(), Option<T>>

Set the loaded object (internal use by query system).

Trait Implementations

impl<T: Model + Clone> Clone for Related<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Model + Debug> Debug for Related<T>

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

Formats the value using the given formatter.

impl<T: Model> Default for Related<T>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T> Deserialize<'de> for Related<T>

where T: Model + Deserialize<'de>,

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for Related<T>

where T: Model + Serialize,

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.