Struct RelationManager 

pub struct RelationManager<'db, S: Schema, M: RelationModel<Schema = S>> { /* private fields */ }

Schema-bound, model-branded manager for exact relation operations. Exact reads and writes exclude subtypes; methods return client input/schema-validation, database/transaction/close, or hydration/model-validation errors as applicable.

Implementations

impl<'db, S, M> RelationManager<'db, S, M>

where S: Schema, M: RelationModel<Schema = S> + CompleteModel,

pub fn filter(&self) -> Result<ProjectedRelationFilter<'db, S, M>>

Start one empty immutable canonical filter for this exact relation model.

pub fn where_<V>( &self, field: FieldToken<M, V>, operator: ProjectedManagerComparison, value: &V, ) -> Result<ProjectedRelationFilter<'db, S, M>>

where V: Model<Schema = S> + QueryValued,

Start a canonical filter with one exact generated field comparison.

pub fn add_hook(&mut self, hook: Arc<dyn LifecycleHook>) -> &mut Self

Register one generated-model lifecycle hook on this manager. Pre-hooks run in registration order and post-hooks in reverse order.

pub async fn insert(&self, input: M::Create) -> Result<M>

Inserts one exact relation with its complete active role players and returns the complete freshly hydrated model. Errors may be input/schema validation, database/transaction/close, or model hydration errors.

pub async fn put(&self, input: M::Create) -> Result<M>

Uses the projected exact-model key when one usable key is carried; otherwise inserts. For an existing exact row, the supplied create value completely replaces non-key ownership and the complete effective active-role player set while preserving the exact IID and keys. It returns a complete freshly hydrated model.

pub async fn insert_many(&self, inputs: Vec<M::Create>) -> Result<Vec<M>>

Inserts each item and returns complete freshly hydrated models in input order, or one error for the whole call with no partial result vector.

pub async fn put_many(&self, inputs: Vec<M::Create>) -> Result<Vec<M>>

Applies the per-item Self::put key-or-insert rule, including complete replacement of non-key ownership and active role players for existing exact rows, returning complete freshly hydrated models in input order, or one error for the whole call with no partial vector.

pub async fn update(&self, iid: &str, input: M::Create) -> Result<M>

Completely replaces non-key ownership and the complete effective active-role player set on the exact relation at canonical iid, preserves that IID and its keys, and returns its complete freshly hydrated model.

pub async fn delete(&self, iid: &str) -> Result<()>

Deletes only the exact relation at canonical iid; subtype instances are not targeted.

pub async fn update_many( &self, inputs: Vec<(String, M::Create)>, ) -> Result<Vec<M>>

Atomically replaces each exact relation identified by its canonical IID and returns complete freshly hydrated models in input order. Every input and pre-hook completes before database work begins; any write or hydration failure rolls back the whole batch.

pub async fn delete_many(&self, iids: &[String]) -> Result<()>

Atomically deletes every exact relation at the supplied canonical IIDs. All IIDs and pre-hooks are accepted before database work begins; any write failure rolls back the whole batch, and post-hook failures do not change the committed result.

pub async fn count(&self) -> Result<u64>

Counts only exact relations, excluding subtypes.

pub async fn get_by_iid(&self, iid: &str) -> Result<Option<M>>

Reads one exact coalesced relation by canonical IID; invalid IIDs are rejected before I/O and a valid but absent relation returns None.

pub async fn all(&self) -> Result<Vec<M>>

Reads all exact coalesced relations in application result order, excluding subtypes; each result is a complete hydrated model.

impl<'db, S, M> RelationManager<'db, S, M>

where S: Schema, M: SubtypeRootModel<Schema = S> + RelationModel<Schema = S>,

pub fn subtypes(&self) -> RelationSubtypeManager<'db, S, M>

Switches only the read scope and result shape to the generated inclusive subtype association; it does not add write operations.

Trait Implementations

impl<'db, S: Schema, M: RelationModel<Schema = S>> Clone for RelationManager<'db, S, M>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.