如何使用QueryDsl按自定义顺序对数据库查询的字符串字段排序

需求匹配说明 #

当前待排序字段的取值范围固定为"A"、"B"、"C"、null四类，需要遵循自定义顺序customOrder = ["B", "A", "C"]的优先级返回排序结果。该需求完全可通过QueryDSL原生能力实现，无需额外开发或引入第三方依赖。

实现逻辑 #

自定义排序的核心是为每个枚举值匹配固定排序权重，权重值越小排序优先级越高。通过QueryDSL的表达式拼接能力，可以在数据库查询层生成CASE WHEN权重映射逻辑，直接由数据库完成排序，无额外性能损耗。
针对给定的自定义排序规则，默认权重映射关系为：

• 字段值为"B"：映射权重0，排序优先级最高
• 字段值为"A"：映射权重1，排序优先级次之
• 字段值为"C"：映射权重2，排序优先级低于A
• 字段值为null：默认映射权重3，排在所有非空值记录之后，权重可按需调整改变null的排序位置

代码实现 #

假设查询中对应实体的QueryDSL路径为testEntity，待排序字段为testEntity.status，具体实现代码如下：

// 构造自定义排序的权重计算表达式
Expression<Integer> customSortExpr = Expressions.stringTemplate(
    "CASE WHEN {0} = 'B' THEN 0 " +
    "WHEN {0} = 'A' THEN 1 " +
    "WHEN {0} = 'C' THEN 2 " +
    "ELSE 3 END",
    testEntity.status
);
// 按权重升序排序，即可匹配指定的自定义顺序
query.orderBy(customSortExpr.asc());

注意事项 #

• 上述实现会将排序逻辑下推至数据库执行，和原生SQL的排序性能完全一致，不会出现将全量数据加载到内存后再排序的性能问题
• 调整null值的排序位置时，仅需修改ELSE分支对应的权重值即可：如需将null排在最前，将ELSE后的3替换为-1即可
• 由于待排序字段的取值范围固定，CASE WHEN的匹配逻辑可覆盖所有可能的取值，不会出现匹配遗漏的问题
• 后续调整自定义排序顺序时，仅需同步修改CASE WHEN内的权重映射关系即可，无需改动查询的其他流程

内容的提问来源于stack exchange，提问作者lickerish