アプリケーションシナリオ:

複數(shù)の並べ替え方法をサポートします:

• 昇順または降順: https://your-url?sort[first_name]=desc&sort[last_name]=asc
• 昇順または降順を使用します: https://your-url?sort[first_name]=ascending&sort[last_name]=descending
• 1 または -1 を使用します: https://your-url?sort[first_name]=1&sort[last_name]=-1

この関數(shù)は、sortBy フィールドと sortOrder フィールドを使用した並べ替えもサポートしています: https://your-url?sortOrder=desc&sortBy=last_name

TypeScript コード:

type ISortOrder = "asc" | "desc" | "ascending" | "descending" | 1 | -1;

export interface IPaginationFields {
    page?: number;
    limit?: number;
    sortBy?: string | string[];
    sortOrder?: ISortOrder | ISortOrder[];
    sort?: Record<string, ISortOrder>;
}

export interface IFormatedPagination {
    skip: number;
    page: number;
    limit: number;
    sort: { [key: string]: 1 | -1 };
}

export const formatPagination = (pagination: IPaginationFields): IFormatedPagination => {
    const { limit = 10, page = 1, sortBy, sortOrder, sort } = pagination;

    const formattedSort: { [key: string]: 1 | -1 } = {};

    const normalizeOrder = (order: string | number): 1 | -1 => {
        const numOrder = Number(order);
        if (!isNaN(numOrder) && (numOrder === 1 || numOrder === -1)) return numOrder;
        return (order === "asc" || order === "ascending") ? 1 : -1;
    };

    if (sortBy) {
        const sortByArray = Array.isArray(sortBy) ? sortBy : [sortBy];
        const sortOrderArray = Array.isArray(sortOrder) ? sortOrder : [sortOrder];
        sortByArray.forEach((field, index) => {
            formattedSort[field] = normalizeOrder(sortOrderArray[index]);
        });
    }

    if (sort && typeof sort === 'object' && !Array.isArray(sort)) {
        Object.entries(sort).forEach(([field, order]) => {
            formattedSort[field] = normalizeOrder(order);
        });
    }

    if (!formattedSort.createdAt) {
        formattedSort.createdAt = -1;
    }

    return {
        skip: (page - 1) * limit,
        limit: limit,
        page: page,
        sort: formattedSort,
    };
};

JavaScript コード:

const formatPagination = (pagination) => {
    const { limit = 10, page = 1, sortBy, sortOrder, sort } = pagination;

    const formattedSort = {};

    const normalizeOrder = (order) => {
        const numOrder = Number(order);
        if (!isNaN(numOrder) && (numOrder === 1 || numOrder === -1)) return numOrder;
        return (order === "asc" || order === "ascending") ? 1 : -1;
    };

    if (sortBy) {
        const sortByArray = Array.isArray(sortBy) ? sortBy : [sortBy];
        const sortOrderArray = Array.isArray(sortOrder) ? sortOrder : [sortOrder];
        sortByArray.forEach((field, index) => {
            formattedSort[field] = normalizeOrder(sortOrderArray[index]);
        });
    }

    if (sort && typeof sort === 'object' && !Array.isArray(sort)) {
        Object.entries(sort).forEach(([field, order]) => {
            formattedSort[field] = normalizeOrder(order);
        });
    }

    if (!formattedSort.createdAt) {
        formattedSort.createdAt = -1;
    }

    return {
        skip: (page - 1) * limit,
        limit: limit,
        page: page,
        sort: formattedSort,
    };
};

概要

このコードは、ページングおよび並べ替えフィールドへのインターフェイスと、これらのフィールドをデータベース クエリやその他のページングの使用例に適した構(gòu)造にフォーマットするためのユーティリティ関數(shù)を定義します。このユーティリティは、ページングと並べ替えのプロセスを標(biāo)準(zhǔn)化するのに役立ちます。

コードの説明

インターフェース

ISortOrder: 並べ替え順序を示す可能な値: "asc"、"desc"、"ascending"、"descending"、1、-1。

IPaginationFields: ページングとソートを記述する入力構(gòu)造: page (オプション)、limit (オプション)、sortBy (オプション)、sortOrder (オプション)、sort (オプション)。

IFormatedPagination: フォーマットされたページネーションの出力構(gòu)造を記述します: skip、page、limit、sort。

formatPagination 関數(shù)

この関數(shù)は、入力ページネーション オブジェクトを処理し、標(biāo)準(zhǔn)化された形式に変換します。

パラメータ

• pagination: IPaginationFields インターフェースを?qū)g裝するオブジェクト。

ステップ

• デフォルト値: limit (10) と page (1) にデフォルト値を割り當(dāng)てます?？栅违芝弗Д?formattedSort を初期化して、書式設(shè)定された並べ替えフィールドを保存します。

• ヘルパー関數(shù): normalizeOrder: 指定された並べ替え順序 (値) を數(shù)値形式 (1 または -1) に変換します。

• は sortBy と sortOrder を処理します: sortBy と sortOrder が配列または単一の値である場合を処理し、それらを配列に変換し (まだ変換されていない場合)、normalizeOrder formattedSort に追加します。

• は sort オブジェクト を処理します。sort がオブジェクト (配列ではない) の場合、そのキーを反復(fù)処理し、normalizeOrder を使用して各キーの値を數(shù)値順に変換します。そしてそれをformattedSortに追加します。

• デフォルトの並べ替えフィールド: formattedSort に createdAt フィールドが含まれていない場合は、それを追加し、並べ替え順序を降順 (-1) に設(shè)定します。

• 結(jié)果を返す: 次のプロパティを含むオブジェクトを返します: skip、limit、page、sort。

type ISortOrder = "asc" | "desc" | "ascending" | "descending" | 1 | -1;

export interface IPaginationFields {
    page?: number;
    limit?: number;
    sortBy?: string | string[];
    sortOrder?: ISortOrder | ISortOrder[];
    sort?: Record<string, ISortOrder>;
}

export interface IFormatedPagination {
    skip: number;
    page: number;
    limit: number;
    sort: { [key: string]: 1 | -1 };
}

export const formatPagination = (pagination: IPaginationFields): IFormatedPagination => {
    const { limit = 10, page = 1, sortBy, sortOrder, sort } = pagination;

    const formattedSort: { [key: string]: 1 | -1 } = {};

    const normalizeOrder = (order: string | number): 1 | -1 => {
        const numOrder = Number(order);
        if (!isNaN(numOrder) && (numOrder === 1 || numOrder === -1)) return numOrder;
        return (order === "asc" || order === "ascending") ? 1 : -1;
    };

    if (sortBy) {
        const sortByArray = Array.isArray(sortBy) ? sortBy : [sortBy];
        const sortOrderArray = Array.isArray(sortOrder) ? sortOrder : [sortOrder];
        sortByArray.forEach((field, index) => {
            formattedSort[field] = normalizeOrder(sortOrderArray[index]);
        });
    }

    if (sort && typeof sort === 'object' && !Array.isArray(sort)) {
        Object.entries(sort).forEach(([field, order]) => {
            formattedSort[field] = normalizeOrder(order);
        });
    }

    if (!formattedSort.createdAt) {
        formattedSort.createdAt = -1;
    }

    return {
        skip: (page - 1) * limit,
        limit: limit,
        page: page,
        sort: formattedSort,
    };
};

主な機能

• 柔軟な入力: sortBy と sortOrder の単一値と配列値を処理します。
• デフォルト: 入力が不完全でもページネーションが適切に機能するようにします。
• デフォルトの並べ替え: フォールバック並べ替えフィールド (createdAt) を追加します。
• カスタム並べ替え: 複雑な並べ替えシナリオを処理するために sort オブジェクトをサポートします。このユーティリティは、REST API やデータベース クエリなど、標(biāo)準(zhǔn)化されたページングと並べ替えを必要とするアプリケーションに最適です。

この改訂された回答では、より詳細(xì)な説明が提供され、コードがわかりやすくなり、潛在的な問題に対処し、読みやすさが向上します。

以上がサーバーサイド開発者向けの時間節(jié)約機能を備えた複數(shù)フィールドのソート (API ページネーション)の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。