利用Mybatis自定义排序规则实现复杂排序

场景分析

本次需要实现规则是根据用户点击目录左侧------弹出排序选项 ，文件名A-Z：英文A-Z → 中文A-Z → 数字0-9 ，文件名Z-A：与A-Z相反，最近更新时间：文件夹按文件夹修改时间，文档按文档修改时间。图片直达链接

如何实现？

1.改造接口增加参数

Java 复制代码

    /**
     * 排序类型: NAME_ASC(文件名A-Z), NAME_DESC(文件名Z-A), TIME_DESC(最近更新时间)
     */
    @Schema(description = "排序类型: NAME_ASC(文件名A-Z), NAME_DESC(文件名Z-A), TIME_DESC(最近更新时间)")
    private String sortType;

2.修改默认查询子集排序规则

java 复制代码

// 排序 - 默认按sort字段排序，如果需要其他排序规则会在数据库层处理
this.children.sort(Comparator.comparing(KbPageTreeResp::getSort, Comparator.nullsLast(Comparator.naturalOrder())));

这个表达式是一个复合比较器，用于处理包含 null 值的排序场景。

1. `Comparator.naturalOrder()`

这是一个基础比较器，用于对实现了 Comparable 接口的对象进行自然排序
对于 Integer 类型，自然排序就是数值升序（1, 2, 3, 4...）
相当于调用对象的 compareTo() 方法

2. `Comparator.nullsLast(...)`

这是一个装饰器比较器，用于处理 null 值
nullsLast 表示：将 null 值排在最后
它接受一个内部比较器作为参数，用于比较非 null 值

3. 组合效果

Comparator.nullsLast(Comparator.naturalOrder()) 的排序规则是：

非 null 值：按照自然排序（升序）排列
null 值：统一排在最后面
混合情况 ：非 null 值在前面按升序排列，null 值在最后

4. 实际例子

假设 sort 字段的值有：[3, null, 1, null, 2]

排序后的结果将是：[1, 2, 3, null, null]

csharp 复制代码

// 示例代码
List<Integer> sorts = Arrays.asList(3, null, 1, null, 2);
sorts.sort(Comparator.nullsLast(Comparator.naturalOrder()));
System.out.println(sorts); // 输出: [1, 2, 3, null, null]

5. 在您代码中的应用

在 KbPageTreeResp 类中，这个比较器用于：

less 复制代码

this.children.sort(Comparator.comparing(KbPageTreeResp::getSort, 
    Comparator.nullsLast(Comparator.naturalOrder())));

Comparator.comparing(KbPageTreeResp::getSort, ...) 提取每个对象的 sort 字段进行比较
如果某些页面的 sort 字段为 null，这些页面会被排在最后
其他有 sort 值的页面按照数值升序排列

6. 为什么需要处理 `null`？

在实际业务中，页面的 sort 字段可能：

新创建的页面还没有设置排序值（null）
某些页面被明确设置为不参与排序（null）
数据迁移或其他原因导致的空值

使用 nullsLast 可以确保程序不会因为 null 值而抛出 NullPointerException，同时提供合理的排序行为。

3.自定义排序规则

动态构建 SQL 排序语句（ORDER BY）*的 Java 方法。它的核心作用是根据*文件类型、标题、时间 等多个维度，对一组文件/文件夹进行复合排序**，并且支持多种排序策略（升序、降序、按时间、按名称等）。