Struct PaginatedQuery 

pub struct PaginatedQuery<T> { /* private fields */ }

Builder pour les requêtes paginées avec tri, recherche et filtres WHERE.

Exemples

// Simple
PaginatedQuery::<MediaFile>::new("SELECT * FROM media_file")
    .allowed_sorts(&["id", "filename", "created", "size"])
    .default_sort("id")
    .execute(pool, params)
    .await

// Avec WHERE
PaginatedQuery::<CommentListItem>::new(
    "SELECT c.id, c.comment, u.username FROM comment c LEFT JOIN users u ON c.user_id = u.id"
)
    .where_eq("c.content_id", content_id.into())
    .default_sort("c.created")
    .default_order("ASC")
    .execute(pool, params)
    .await

// Avec recherche
PaginatedQuery::<UserListItem>::new("SELECT u.id, u.username FROM users u")
    .allowed_sorts(&["id", "username", "email", "created"])
    .sort_prefix("u")
    .search_columns(&["u.username", "u.email"])
    .execute(pool, params)
    .await

Implementations

impl<T> PaginatedQuery<T>

where T: Send + Unpin + for<'r> FromRow<'r, DbRow>,

pub fn new(base_sql: &str) -> Self

Crée un nouveau builder à partir d’une requête SELECT de base (sans ORDER BY/LIMIT).

pub fn allowed_sorts(self, sorts: &[&str]) -> Self

Colonnes de tri autorisées (whitelist pour éviter l’injection SQL).

pub fn default_sort(self, sort: &str) -> Self

Colonne de tri par défaut.

pub fn default_order(self, order: &str) -> Self

Direction de tri par défaut (“ASC” ou “DESC”).

pub fn sort_prefix(self, prefix: &str) -> Self

Préfixe de table pour le ORDER BY (ex: “u” → ORDER BY u.id).

pub fn search_columns(self, columns: &[&str]) -> Self

Colonnes à rechercher avec LIKE (activé si params.search est renseigné).

pub fn where_eq(self, column: &str, value: WhereValue) -> Self

Ajoute une condition WHERE (col = ?).

pub fn where_gte(self, column: &str, value: WhereValue) -> Self

Ajoute une condition WHERE (col >= ?).

pub fn where_lte(self, column: &str, value: WhereValue) -> Self

Ajoute une condition WHERE (col <= ?).

pub fn count_from(self, sql: &str) -> Self

Surcharge la requête COUNT (utile si le FROM est complexe). Par défaut, le COUNT est déduit automatiquement de la requête de base.

pub async fn execute( self, pool: &DbPool, params: &PaginationParams, ) -> AppResult<(Vec<T>, u64)>

Exécute la requête paginée et retourne (Vec<T>, total).