「労働者が自分の仕事をうまくやりたいなら、まず自分の道具を研ぎ澄まさなければなりません。」 - 孔子、「論語。陸霊公」
表紙 > プログラミング > サーバーサイド開発者の時間保存機能を使用した複数のフィールドソート(APIページネーション)

サーバーサイド開発者の時間保存機能を使用した複数のフィールドソート(APIページネーション)

2025-02-24に投稿されました
ブラウズ:910

Multiple fields sorting with a time saving function for server side developer (api pagination)

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

複数の並べ替え方法をサポート:

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

この関数は、 sortby and sortorder fields: 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;
}

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,
    };
};

概要

このコードは、フィールドとソートフィールドのインターフェイスと、これらのフィールドをデータベースクエリまたはその他のページングユースケースに適した構造にフォーマットする実用的な機能を定義します。このユーティリティは、ページングと並べ替えプロセスを標準化するのに役立ちます。

コード説明

]

インタフェース

isortordory :ソート順序を表す可能な値: "asc"、 "desc"、 "ascending"、 "descending"、1、-1。

iPaginationfields :ページネーションとソートの入力構造を説明してください: page (optional)、 lime] lime (optional)、 sortby ]] ]]]]]]])(オプション)、 SORTORDER (optional)、 sort (optional)。

iformatedPagination :フォーマットされたページネーションの出力構造を説明してください: skip page lime atort ]]。

formatpagination function

この関数は、入力ページングオブジェクトを処理し、標準化された形式に変換します。

parameter

  • pagination ipaginationfields インターフェイスを実装するオブジェクト。

ステップ

  • default値:デフォルト値を lime (10)および page (1)に割り当てます。空のオブジェクトの初期化 formattedsort は、フォーマットされたソートフィールドを保存するために使用されます。

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

  • handle sortby and sortordory sortby sortorord はアレイまたは単一値です、それらを配列に変換し(まだそうではない場合)、 formattedsort を使用して formattedsort に変換します。

  • handle sort object sort がオブジェクト(配列ではない)である場合、そのキーを繰り返し、 remormizeorder を使用します。各キーの値は数値に変換され、 formattedsort に追加されます。

  • default sort field formattedsort createdat フィールドが含まれていない場合、それを追加して、並べ替え順序を降順(-1)に設定します。

  • return result :次の属性を持つオブジェクトを返します: skip lime page sort ]。

const pagination = {
  page: 2,
  limit: 20,
  sortBy: ['name', 'date'],
  sortOrder: ['asc', 'desc'],
  sort: { age: 1, score: -1 },
};

const formatted = formatPagination(pagination);

console.log(formatted);

main関数

  • 柔軟な入力: sortby and sortorder の単一および配列値を処理します。
  • デフォルト:入力が不完全であっても、ページングが適切に機能することを保証します。
  • デフォルトソート:フォールバックソートフィールド( createdat )を追加します。
  • カスタムソート:ソートオブジェクトをサポートして、複雑なソートシナリオを処理します。このユーティリティは、REST APIやデータベースクエリなど、標準化されたページングとソートを必要とするアプリケーションに最適です。

この改訂された応答は、より詳細な説明とコードの明確さを改善し、潜在的な問題に対処し、読みやすくするためにフォーマットされています。

最新のチュートリアル もっと>

免責事項: 提供されるすべてのリソースの一部はインターネットからのものです。お客様の著作権またはその他の権利および利益の侵害がある場合は、詳細な理由を説明し、著作権または権利および利益の証拠を提出して、電子メール [email protected] に送信してください。 できるだけ早く対応させていただきます。

Copyright© 2022 湘ICP备2022001581号-3