Struct EntityManager 

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

Schema-bound, model-branded manager for exact entity 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> EntityManager<'db, S, M>

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

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

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

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

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

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

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

pub fn where_<V>( &self, field: FieldToken<M, V>, operator: ProjectedManagerComparison, value: &V, ) -> Result<ProjectedEntityFilter<'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 entity and returns its 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 a projected exact-model key when one is available; otherwise inserts. For an existing exact row, the supplied create value completely replaces non-key ownership: omitted optional values and empty multivalue collections remove prior ownership. It never reuses a subtype instance, and 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 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 on the exact model at canonical iid, preserves that IID, and returns its complete freshly hydrated model. Omitted optional values and empty multivalue collections remove prior ownership.

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

Deletes only the exact model 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 entity 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 entity 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 models, excluding subtypes.

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

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

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

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

Trait Implementations

impl<'db, S: Schema, M: EntityModel<Schema = S>> Clone for EntityManager<'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.