Struct butane_core::fkey::ForeignKey

pub struct ForeignKey<T> where
    T: DataObject,  { /* fields omitted */ }

Used to implement a relationship between models.

Initialize using From or from_pk

Examples

#[model]
struct Blog {
  ...
}
#[model]
struct Post {
  blog: ForeignKey<Blog>,
  ...
}

Implementations

impl<T: DataObject> ForeignKey<T>

pub fn from_pk(pk: T::PKType) -> Self

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

Returns a reference to the value. It must have already been loaded. If not, returns Error::ValueNotLoaded

pub fn pk(&self) -> T::PKType

Returns a reference to the primary key of the value.

pub fn load(&self, conn: &impl ConnectionMethods) -> Result<&T>

Loads the value referred to by this foreign key from the database if necessary and returns a reference to it.

Trait Implementations

impl<T> AsPrimaryKey<T> for ForeignKey<T> where
    T: DataObject, 

pub fn as_pk(&self) -> Cow<'_, T::PKType>

impl<T: DataObject> Clone for ForeignKey<T>

pub fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: DataObject> Debug for ForeignKey<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for ForeignKey<T> where
    T: DataObject,
    T::PKType: Deserialize<'de>, 

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

Deserialize this value from the given Serde deserializer.

impl<T: DataObject> Eq for ForeignKey<T>

impl<T> FieldType for ForeignKey<T> where
    T: DataObject, 

pub const SQLTYPE: SqlType

type RefType = <<T as DataObject>::PKType as FieldType>::RefType

Reference type. Used for ergonomics with String (which has reference type str). For most, it is Self

impl<T: DataObject> From<&'_ T> for ForeignKey<T>

pub fn from(obj: &T) -> Self

Performs the conversion.

impl<T: DataObject> From<T> for ForeignKey<T>

pub fn from(obj: T) -> Self

Performs the conversion.

impl<T> FromSql for ForeignKey<T> where
    T: DataObject, 

pub fn from_sql(val: SqlVal) -> Result<Self>

impl<T> IntoSql for ForeignKey<T> where
    T: DataObject, 

pub fn into_sql(self) -> SqlVal

impl<T, U> PartialEq<U> for ForeignKey<T> where
    U: AsPrimaryKey<T>,
    T: DataObject, 

pub fn eq(&self, other: &U) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T> Serialize for ForeignKey<T> where
    T: DataObject,
    T::PKType: Serialize, 

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

Serialize this value into the given Serde serializer.

impl<T> ToSql for ForeignKey<T> where
    T: DataObject, 

pub fn to_sql(&self) -> SqlVal