Struct EntityQuery 

pub struct EntityQuery<T, E: EntityTrait> { /* private fields */ }

A chainable query builder that wraps SeaORM’s Select<E> and auto-converts results to the domain type T via From<E::Model>.

Construct one from E::find() or E::find_by_id(pk) and then chain filter/order/limit/offset calls before executing with a terminal method.

Example

let todos: Vec<Todo> = EntityQuery::new(TodoEntity::find())
    .filter(todo::Column::Done.eq(false))
    .order_by_asc(todo::Column::CreatedAt)
    .limit(10)
    .all(&db)
    .await?;

Implementations

impl<T, E> EntityQuery<T, E>

where E: EntityTrait, T: From<E::Model> + Send + Sync, E::Model: FromQueryResult + Send + Sync,

pub fn new(select: Select<E>) -> Self

Wrap an existing Select<E>.

pub fn filter(self, f: impl IntoCondition) -> Self

Apply a WHERE condition.

pub fn order_by_asc<C: ColumnTrait>(self, col: C) -> Self

ORDER BY col ASC.

pub fn order_by_desc<C: ColumnTrait>(self, col: C) -> Self

ORDER BY col DESC.

pub fn limit(self, n: u64) -> Self

LIMIT n rows.

pub fn offset(self, n: u64) -> Self

OFFSET n rows.

pub async fn all(self, db: &impl ConnectionTrait) -> Result<Vec<T>, Error>

Fetch all matching rows and convert each model to T.

pub async fn one(self, db: &impl ConnectionTrait) -> Result<Option<T>, Error>

Fetch at most one row and convert to T if present.

pub async fn count(self, db: &impl ConnectionTrait) -> Result<u64, Error>

Return the number of rows that match the current query.

pub async fn paginate( self, db: &impl ConnectionTrait, params: &PageParams, ) -> Result<PageResult<T>, Error>

Offset-based pagination. Results are auto-converted to T.

pub async fn paginate_cursor<C, V, F>( self, col: C, cursor_fn: F, db: &impl ConnectionTrait, params: &CursorParams<V>, ) -> Result<CursorResult<T>, Error>

where C: IntoIdentity, V: IntoValueTuple + Clone, F: Fn(&E::Model) -> String,

Cursor-based pagination. Results are auto-converted to T.

• col — the column to paginate on (e.g. Column::Id).
• cursor_fn — extracts the cursor string from a model instance.

pub fn into_select(self) -> Select<E>

Unwrap the inner Select<E> for advanced SeaORM usage.