利用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()) 的排序规则是:

  1. null:按照自然排序(升序)排列
  2. null:统一排在最后面
  3. 混合情况 :非 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 方法。它的核心作用是根据*文件类型、标题、时间 等多个维度,对一组文件/文件夹进行复合排序**,并且支持多种排序策略(升序、降序、按时间、按名称等)。

java 复制代码
  
    /**
     * 构建ORDER BY语句
     * 文件夹和文件分别排序,文件夹在前,文件在后
     * xxxxx节点始终置顶
     * 
     * @return ORDER BY语句
     */
    private String buildOrderByClause() {
        StringBuilder orderBy = new StringBuilder();
        
        // 1. xxxxxx节点置顶
        orderBy.append("ORDER BY CASE WHEN title = 'xxxxxx' THEN 0 ELSE 1 END, ");
        
        // 2. 文件夹在前,文件在后
        orderBy.append("CASE WHEN type = 'FOLDER' THEN 0 ELSE 1 END, ");
        
        // 3. 根据排序类型进行排序
        if (StrUtil.isNotBlank(this.sortType)) {
            switch (this.sortType.toUpperCase()) {
                case "NAME_ASC":
                    // 文件名A-Z:英文A-Z → 中文A-Z → 数字0-9
                    // 使用ASCII码和字符判断来实现优先级排序
                    orderBy.append("CASE ")
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) BETWEEN 65 AND 90 OR ASCII(SUBSTRING(title, 1, 1)) BETWEEN 97 AND 122 THEN CONCAT('1', title) ") // 英文字母
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) > 127 THEN CONCAT('2', title) ") // 中文字符
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) BETWEEN 48 AND 57 THEN CONCAT('3', title) ") // 数字
                            .append("ELSE CONCAT('4', title) ") // 其他字符
                            .append("END ASC");
                    break;
                case "NAME_DESC":
                    // 文件名Z-A:与A-Z相反
                    orderBy.append("CASE ")
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) BETWEEN 65 AND 90 OR ASCII(SUBSTRING(title, 1, 1)) BETWEEN 97 AND 122 THEN CONCAT('1', title) ") // 英文字母
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) > 127 THEN CONCAT('2', title) ") // 中文字符
                            .append("WHEN ASCII(SUBSTRING(title, 1, 1)) BETWEEN 48 AND 57 THEN CONCAT('3', title) ") // 数字
                            .append("ELSE CONCAT('4', title) ") // 其他字符
                            .append("END DESC");
                    break;
                case "TIME_DESC":
                    // 最近更新时间:文件夹按文件夹修改时间,文档按文档修改时间
                    orderBy.append("modifier_time DESC");
                    break;
                default:
                    // 默认排序:修改时间降序 + sort升序 + 标题升序
                    orderBy.append("modifier_time DESC, sort ASC, title ASC");
                    break;
            }
        } else {
            // 默认排序:修改时间降序 + sort升序 + 标题升序
            orderBy.append("modifier_time DESC, sort ASC, title ASC");
        }
        
        return orderBy.toString();
    }
}
相关推荐
毕设源码-郭学长4 小时前
【开题答辩全过程】以 基于vue+springboot的校园疫情管理系统的设计与实现为例,包含答辩的问题和答案
java·spring boot·后端
Joey_Chen4 小时前
【Golang开发】快速入门Go——Goroutine和Channel
后端·go
CF14年老兵4 小时前
努力生活,本身就是一种成就
前端·后端·trae
LSTM974 小时前
Python与Excel的华丽邂逅:用Spire.XLS for Python高效读取数据
后端
bobz9654 小时前
kubevirt 编译 virt-launcher 下载 qemu 失败
后端
yinke小琪5 小时前
Spring生态全家桶:从基础到微服务的演进与关联是什么?
java·后端·spring
似水流年流不尽思念5 小时前
ReentrantLock 分为公平锁和非公平锁,它的底层是如何实现的?
后端
AAA修煤气灶刘哥5 小时前
微服务又崩了?5 招 + Sentinel 救场,后端小白也能学会
java·后端·spring cloud
brzhang5 小时前
技术榜单都快刷爆了,美团的“龙猫”大模型怎么就没声了?
前端·后端·架构