Struct DbSetQueryIncludeMany 

pub struct DbSetQueryIncludeMany<E: Entity, J: Entity> { /* private fields */ }

Query builder returned by DbSetQuery::include_many::<T>(...) for a collection navigation.

Implementations

impl<E: Entity, J: Entity> DbSetQueryIncludeMany<E, J>

pub fn filter(self, predicate: Predicate) -> Self

Adds a predicate after configuring the collection include.

pub fn join(self, join: Join) -> Self

Adds an explicit join after configuring the collection include.

pub fn inner_join<K: Entity>(self, on: Predicate) -> Self

Adds an explicit INNER JOIN after configuring the collection include.

pub fn left_join<K: Entity>(self, on: Predicate) -> Self

Adds an explicit LEFT JOIN after configuring the collection include.

pub fn order_by(self, order: OrderBy) -> Self

Adds an ordering expression after configuring the collection include.

pub fn join_strategy(self) -> Self

Uses the join-based collection loading strategy.

This is the default strategy. The row limit protects callers from accidentally loading an unbounded cartesian result through one join.

pub fn split_query(self) -> Self

Selects the planned split-query loading strategy.

Execution currently returns a clear error because split queries need a separate implementation that loads roots first and related rows second.

pub fn max_joined_rows(self, limit: usize) -> Self

Overrides the maximum number of joined rows accepted before grouping.

Use this only when the expected root/collection cardinality is known.

pub fn unbounded_join(self) -> Self

Removes the join row safety limit.

This keeps the API explicit for callers that intentionally accept a large join result.

pub fn with_deleted(self) -> Self

Includes logically deleted root rows for entities with soft_delete.

This affects only the root entity E; included collection entities still apply their own default soft_delete visibility inside the join.

pub fn only_deleted(self) -> Self

Returns only logically deleted root rows for entities with soft_delete.

This affects only the root entity E; included collection entities still apply their own default soft_delete visibility inside the join.

pub async fn all(self) -> Result<Vec<E>, OrmError>

where E: FromRow + IncludeCollection<J> + Send + SoftDeleteEntity + TenantScopedEntity, J: FromRow + Send + SoftDeleteEntity + TenantScopedEntity,

Executes the query and materializes root entities with one collection navigation attached.