多字段排序，为服务器端开发人员提供节省时间的功能（api分页）-js教程-PHP中文网

多字段排序，为服务器端开发人员提供节省时间的功能（api分页）

碧海醫心

发布： 2025-01-23 19:10:26

原创

448人浏览过

多字段排序，为服务器端开发人员提供节省时间的功能（api分页）

应用场景：
您可以使用多种方式指定排序顺序，例如：

升序/降序: https://your-url?sort[first_name]=desc&sort[last_name]=asc
ascending/descending: 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 和 sortorder 参数: https://your-url?sortorder=desc&sortby=last_name

此函数还能处理 sortby 和 sortorder 参数。

TypeScript 代码：

<code class="typescript">type SortOrder = "asc" | "desc" | "ascending" | "descending" | 1 | -1;

export interface IPaginationFields {
    page?: number;
    limit?: number;
    sortby?: string | string[];
    sortorder?: SortOrder | SortOrder[];
    sort?: Record<string, SortOrder>;
}

export interface IFormattedPagination {
    skip: number;
    page: number;
    limit: number;
    sort: Record<string, 1 | -1>;
}

export const formatPagination = (
    pagination: IPaginationFields
): IFormattedPagination => {
    const { limit = 10, page = 1, sortby, sortorder, sort = {} } = pagination;

    const formattedSort: Record<string, 1 | -1> = {};

    const normalizeOrder = (value: string | number): 1 | -1 => {
        const numValue = Number(value);
        if (!isNaN(numValue) && (numValue === 1 || numValue === -1)) {
            return numValue;
        } else {
            return value === "asc" || value === "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]);
        });
    }

    Object.entries(sort).forEach(([field, order]) => {
        formattedSort[field] = normalizeOrder(order);
    });


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

    return {
        skip: (page - 1) * limit,
        limit: Number(limit),
        page: Number(page),
        sort: formattedSort,
    };
};</code>

登录后复制

JavaScript 代码：

<code class="javascript">const formatPagination = (pagination) => {
    const { limit = 10, page = 1, sortby, sortorder, sort = {} } = pagination;

    const formattedSort = {};

    const normalizeOrder = (value) => {
        const numValue = Number(value);
        if (!isNaN(numValue) && (numValue === 1 || numValue === -1)) {
            return numValue;
        } else {
            return value === "asc" || value === "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]);
        });
    }

    Object.entries(sort).forEach(([field, order]) => {
        formattedSort[field] = normalizeOrder(order);
    });

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

    return {
        skip: (page - 1) * limit,
        limit: Number(limit),
        page: Number(page),
        sort: formattedSort,
    };
};</code>

登录后复制

功能概述:

这段代码提供了一个函数 formatPagination，用于将各种分页和排序参数规范化为数据库查询或其他后端系统易于理解的格式。它支持多种排序参数格式，并提供默认值和默认排序字段 (createdAt) 以增强健壮性。

代码说明:

字狐AI PPT

字狐AIPPT是一款集成了多种智能功能的软件，智能生成PPT和PPT大纲，帮助您快速生成PPT，节约时间，提高效率！

查看详情

类型定义: SortOrder 枚举定义了所有支持的排序值。IPaginationFields 和 IFormattedPagination 接口定义了输入和输出对象的结构。
formatPagination 函数: 该函数解析输入参数，并将其转换为标准化的 IFormattedPagination 对象。 normalizeOrder 辅助函数将各种排序值（字符串或数字）转换为统一的 1 (升序) 或 -1 (降序) 表示。函数处理 sortby/sortorder 和 sort 对象两种参数形式，并添加默认的 createdAt 排序。
示例用法: 提供的示例展示了如何使用该函数以及其输出结果。