Enum oas_common::reference::Reference

pub enum Reference<T: Clone> {
    Id(String),
    Resolved(Record<T>),
}

A reference is an enum that can be in two states: It either holds an ID to a record, or a loaded record.

Variants

Id(String)

Resolved(Record<T>)

Implementations

impl<T: TypedValue> Reference<T>

pub fn id(&self) -> &str

Get the target id of the reference.

pub fn guid(&self) -> &str

pub fn record(&self) -> Option<&Record<T>>

Get the loaded record if the reference is resolved.

pub fn record_mut(&mut self) -> Option<&mut Record<T>>

Get a mutable reference to the loaded record if the reference is resolved.

pub fn into_record(self) -> Option<Record<T>>

Get the loaded record if the reference is resolved, while consuming the reference.

pub fn extract_record(&mut self) -> Option<Record<T>>

Extract the loaded record if the reference is resolved, while converting the reference to only hold an id.

pub fn resolved(&self) -> bool

Check if the reference is resolved and contains a loaded record.

pub async fn resolve<R: Resolver>(
    &mut self,
    resolver: &R
) -> Result<(), ResolveError>

Resolve this reference with a Resolver if the reference is not yet in the resolved state.

The Resolver trait is implemented on data stores.

pub async fn force_resolve<R: Resolver>(
    &mut self,
    resolver: &R
) -> Result<(), ResolveError>

Resolve the record, even if the reference is already in the resolved state.

pub async fn into_resolved<R: Resolver>(
    self,
    resolver: &R
) -> Result<Self, ResolveError>

Resolve the record while consuming self, and return a new reference in the resolved state.

pub fn set_resolved(&mut self, record: Record<T>)

Set the record to the resolved state while passing in the target record.

Trait Implementations

impl<T: Clone + Clone> Clone for Reference<T>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for Reference<T>

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

Formats the value using the given formatter.

impl<'de, T: Clone> Deserialize<'de> for Reference<T>where
    T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: TypedValue> From<ResolveError> for Reference<T>

fn from(err: ResolveError) -> Self

Converts to this type from the input type.

impl<T: Clone + JsonSchema> JsonSchema for Reference<T>

fn schema_name() -> String

The name of the generated JSON Schema.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl<T: Clone> Serialize for Reference<T>where
    T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.