Struct df_st_api::api_objects::ApiCountPage

pub struct ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample,  {
    pub max_page_size: u32,
    pub total_item_count: u32,
    pub page_start: u32,
    pub page_size: u32,
    pub page_nr: u32,
    pub group_by: Option<String>,
    pub etag: String,
    pub links: ApiPageLinks,
    pub data: Vec<ApiMinimalItem<C>>,
    pub given_etag: String,
    pub base_url: String,
    pub server_max_page_size: u32,
    // some fields omitted
}

A paged response from the API. The actual requested data can be found in the data object.

Fields

max_page_size: u32

The maximum amount if items in this response.

total_item_count: u32

The total amount of items. (across all pages) Note: id's usually start at 0 so if there are 10 total items the list id is 9. But id's can be missing so do not use this to calculate id's!

page_start: u32

The offset from the start of the database structure. This value takes the sorting of the page into account.

page_size: u32

The actual size of the response. (page_size<=max_page_size).

page_nr: u32

The number of the page. This value is page_nr = page_start/max_page_size

group_by: Option<String>

Name of the field it is grouped by.

etag: String

Tag to identify this version of the page. More info here. This tag can be used to improve caching. ETag is a Sha256 of the whole response (including links and other metadata, excluding the etag itself.).

links: ApiPageLinks

Links the various related items.

data: Vec<ApiMinimalItem<C>>

List of actual requested data.

given_etag: String

The etag given in the request.

base_url: String

Server base url. Not included in response.

server_max_page_size: u32

Maximum amount of items requested on a page. Set by server at startup, see config. Not included in response.

Implementations

impl<C, D> ApiCountPage<C, D> where
    C: ApiObject + Default + Serialize + SchemaExample,
    D: ApiObject + Default + Serialize + SchemaExample, 

pub fn new(
    pagination: &ApiMinimalPagination,
    server_info: &State<'_, ServerInfo>
) -> Self

pub fn wrap(&mut self, list: Vec<C>) -> bool

Store the data in the object and construct links and calculate ETag. Return if true etag match with request tag.

Trait Implementations

impl<C: Clone, D: Clone> Clone for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample, 

fn clone(&self) -> ApiCountPage<C, D>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<C: Debug, D: Debug> Debug for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample, 

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

Formats the value using the given formatter.

impl<C: Default, D: Default> Default for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample, 

fn default() -> ApiCountPage<C, D>

Returns the "default value" for a type.

impl<'de, C, D> Deserialize<'de> for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample,
    C: Deserialize<'de>,
    D: Default, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<C: JsonSchema, D: JsonSchema> JsonSchema for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample, 

fn schema_name() -> String

The name of the generated JSON Schema.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl<C, D> SchemaExample for ApiCountPage<C, D> where
    C: SchemaExample + Serialize + ApiObject,
    D: SchemaExample + Serialize + ApiObject, 

fn example() -> Self

impl<C, D> Serialize for ApiCountPage<C, D> where
    C: ApiObject + Serialize + SchemaExample,
    D: ApiObject + Serialize + SchemaExample,
    C: Serialize, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.