Enum Ref 

pub enum Ref<T> {
    Reference(String),
    Embedded(T),
}

An object property’s value: EXACTLY ONE of a reference to a named resource (its canonical URI) or an embedded node (the value itself, carried inline — derived identity, no $id). The typed twin of the wire form’s {"$ref": uri} vs embedded-node distinction; the choice between the arms is authorial and hash-relevant, so it is explicit here, never inferred.

Variants

Reference(String)

A reference to a named resource by its canonical URI.

Embedded(T)

An embedded value, carried inline.

Implementations

impl<T> Ref<T>

pub fn to(uri: impl Into<String>) -> Self

A reference to a named resource by its canonical URI.

pub fn to_resource(target: &impl KanonakResource) -> Result<Self, CodecError>

A reference to a named resource by the instance itself — resolved through the target’s envelope id. The target must already carry its identity; an embedded (id-less) value cannot be referenced.

pub fn embed(value: T) -> Self

An embedded value, carried inline (derived identity, no $id).

pub fn embed_named(value: T, name: impl Into<String>) -> Self

where T: KanonakResource,

An embedded value with its authored dict-key name (hash-relevant).

pub fn is_reference(&self) -> bool

True when this is the reference arm.

Trait Implementations

impl<T: Clone> Clone for Ref<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Ref<T>

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

Formats the value using the given formatter.

impl<'de, T: DeserializeOwned> Deserialize<'de> for Ref<T>

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

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq> PartialEq for Ref<T>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: Serialize> Serialize for Ref<T>

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

Serialize this value into the given Serde serializer.

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