Struct Relation 

pub struct Relation<P> { /* private fields */ }

One relation of a parent resource’s records.

Declared by ResourceDef::relation; the related resource must be registered on the same panel, which keys the relation by its slug:

let def: ResourceDef<PostResource> =
    ResourceDef::new().relation(Relation::has_many::<CommentResource>(Comment::fields().post_id()));

Implementations

impl<P> Relation<P>

where P: Model + IntoExpr<P> + 'static,

pub fn has_many<C>( foreign_key: Path<C::Model, impl ForeignKey<P::PrimaryKey>>, ) -> Self

where C: Resource,

Declare a has_many child resource whose foreign_key holds the owner’s primary key, a single column.

let comments: Relation<Post> = Relation::has_many::<CommentResource>(Comment::fields().post_id());

pub fn belongs_to_many<C>(via: impl Into<Path<P, List<C::Model>>>) -> Self

where C: Resource, P: Send + Sync,

Declare a many-to-many child resource whose records the owner links through via, its #[has_many(via = joins.target)] field: the owner’s linked records, which the table attaches and detaches as join rows.

let tags: Relation<Post> = Relation::belongs_to_many::<TagResource>(Post::fields().tags());

Attaching and detaching ask the owner’s policy for Update, as editing it does, and the related resource’s for View on each record; mounting refuses a join model a link cannot write.

impl<P> Relation<P>

pub fn label(self, label: impl Into<String>) -> Self

Titles the section label instead of the related resource’s plural label.

Trait Implementations

impl<P> Debug for Relation<P>

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

Formats the value using the given formatter.