当前位置：首页 > 文章列表 > 文章 > 前端 > 多字段排序，为服务器端开发人员提供节省时间的功能（api分页）

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

2025-01-25 11:55:07 0浏览收藏

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是文章学习者，那么本文《多字段排序，为服务器端开发人员提供节省时间的功能（api分页）》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

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

升序/降序: 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 代码：

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

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

export interface IFormattedPagination {
    skip: number;
    page: number;
    limit: number;
    sort: Record;
}

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

    const formattedSort: Record = {};

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

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

功能概述:

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

代码说明:

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