pip-services3-commons-node/obj/src/data/DataPage.d.ts

/** @module data */
/**
 * Data transfer object that is used to pass results of paginated queries.
 * It contains items of retrieved page and optional total number of items.
 *
 * Most often this object type is used to send responses to paginated queries.
 * Pagination parameters are defined by [[PagingParams]] object.
 * The <code>skip</code> parameter in the PagingParams there means how many items to skip.
 * The <code>takes</code> parameter sets number of items to return in the page.
 * And the optional <code>total</code> parameter tells to return total number of items in the query.
 *
 * Remember: not all implementations support the <code>total</code> parameter
 * because its generation may lead to severe performance implications.
 *
 * @see [[PagingParams]]
 *
 * ### Example ###
 *
 *     myDataClient.getDataByFilter(
 *         "123",
 *         FilterParams.fromTuples("completed": true),
 *         new PagingParams(0, 100, true),
 *         (err: any, page: DataPage<MyData>) => {
 *             if (err == null) {
 *                 console.log("Items: ");
 *                 for (let item of page.Data) {
 *                     console.log(item);
 *                 }
 *                 console.log("Total items: " + page.total);
 *             }
 *         };
 *     );
 */
export declare class DataPage<T> {
    /** The items of the retrieved page. */
    data: T[];
    /** The total amount of items in a request. */
    total: number;
    /**
     * Creates a new instance of data page and assigns its values.
     *
     * @param data      a list of items from the retrieved page.
     * @param total     (optional) .
     */
    constructor(data?: T[], total?: number);
}