Struct PageParams 

pub struct PageParams {
    pub limit: Option<i64>,
    pub offset: Option<i64>,
}

The page window a list endpoint accepts.

Fields

limit: Option<i64>

offset: Option<i64>

Implementations

impl PageParams

pub fn from(limit: Option<i64>, offset: Option<i64>) -> Self

Builds a window from fields a caller declared inline.

pub fn resolve(&self, config: &Config) -> Page

Clamps the caller’s window into something the database can be handed.

Clamped rather than refused: a ?limit=100000 is far more likely to be a client that does not know the ceiling than an attack, and answering with the largest allowed page is more useful than a 400. A negative offset is nonsense, so it becomes 0 rather than a SQL error.

The upper clamp is not cosmetic: pages::pager computes offset + limit to place the “next” link, and ?offset= arrives straight off the query string as an i64. At i64::MAX that addition overflows — a panic in a debug build, a silent wrap to a negative page window in release, which sets no overflow-checks. [MAX_OFFSET] leaves headroom for the addition no matter what limit resolved to.

Trait Implementations

impl Debug for PageParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PageParams

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PageParams

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.