Ebean 字段别名配置引发语法问题

￡神魔★判官ぃ 2024-03-22 16:00 105阅读 0赞

## 前言 ##

Ebean 没听过？这里简单给你介绍下：Ebean 是一个 Java ORM（Object-Relational Mapping）框架，具有以下优势：

1.  简单易用：Ebean 的 API 设计简单易用，可以快速上手，无需繁琐的配置。
2.  自动化 SQL 生成：Ebean 可以自动化生成 SQL 语句，开发者无需手写 SQL，提高了开发效率。
3.  高性能：Ebean 的性能优秀，支持缓存、预编译等优化手段，可以快速处理大量数据。
4.  多数据源支持：Ebean 支持多数据源，可以同时连接多个数据库，方便应用在不同环境下的部署和迁移。
5.  事务管理：Ebean 提供了完整的事务管理机制，保证数据的一致性和可靠性。
6.  灵活的查询：Ebean 支持灵活的查询方式，可以根据需求灵活组合条件、排序和分页等操作。

简单来说，Ebean 是一个功能丰富、易于使用且性能优越的 ORM 框架，适用于各种规模的 Java 项目，尤其是丰富的流式 API 封装，使用很丝滑，举个例子：

// "alias" bean that can be used in select and fetch clauses
    QCustomer cust = QCustomer.alias();
    
    List<Customer> customers =
      new QCustomer()
        // only fetch some properties of customer (partial objects)
        .select(cust.name, cust.version, cust.whenCreated)
        .name.istartsWith("Rob")
        .findList();

## 项目场景： ##

最近接手一个项目，持久层就使用了 Ebean 框架。刚接手的项目，你懂的，总有一些坑需要你去踩！

需求很简答：要对查询结果字段做去重并统计总数，很简单的问题，直接翻译成代码即可：

int count = queryBean()
                    .select(QCallRecord.alias().contentId)
                    .type.eq("user")
                    .setDistinct(true)
                    .findCount();

正常情况下，这样使用就 OK 了

--------------------

## 问题描述 ##

问题来了：

Caused by: java.sql.SQLSyntaxErrorException: You have an error in your SQL syntax; 
    check the manual that corresponds to your MySQL server version 
    for the right syntax to use near 'c0) from call_record t0 where t0.type = 'user'' at line 1

也就是语法有问题，我们看看生成的 SQL 语法：

select count(distinct t0.content_id c0) from call_record t0 where t0.type = 'user'

问题在哪？ 字段 content\_id 的别名。

在 MySQL 中，对于 count 这类聚合函数内是不允许出现字段别名，别名 c0 是在函数参数中定义的，这是一种错误的写法，会导致语法错误。

正确的写法应该是将 AS 关键字放在函数后面，比如：

SELECT count(DISTINCT t0.content_id) AS c0 FROM call_record t0 WHERE t0.type = 'user';

更深层原因？

SQL 聚合函数是作用于某个列或表达式的数据集上，并计算这些值的总和、平均值、最小值、最大值等等。因此，在 SQL 查询中，聚合函数的参数应该是列或表达式，而不是别名。

--------------------

## 原因分析： ##

Ebean 怎么会解析出有语法问题的 SQL？是bug 还是配置问题？

Ebean 提供了 DatabasePlatform 这么一个数据库平台抽象类，它定义了一系列通用的接口和方法，以便与不同的数据库进行交互，具体差异由子类去个性化实现，你可以看看：

![在这里插入图片描述][ac42200834c846d8b0e71de8af01435c.png]

有多少是自己熟悉的数据库？

不同的数据库难免有些差异，比如 MySQL、Postgres 等，当然 Ebean 已经把这些差异化都实现了，默认情况下自动选择，对使用者来说无感知！！！ 除非你特性化需求配置。

当然，我就遇到了。DB 自定义配置项：

@Override
        public Database getObject() throws Exception {
        
            DatabaseConfig databaseConfig = new DatabaseConfig();
            
            ...
            
            DatabasePlatform dbPlatform = new DatabasePlatform();
            dbPlatform.getDbIdentity().setIdType(IdType.IDENTITY);
            dbPlatform.getDbIdentity().setSupportsGetGeneratedKeys(true);
            dbPlatform.getDbIdentity().setSupportsSequence(false);
            dbPlatform.getDbIdentity().setSupportsIdentity(true);
            databaseConfig.setDatabasePlatform(dbPlatform);
     
            ...
    
            return DatabaseFactory.create(databaseConfig);
        }

项目里手动配置这几个参数，但是配置不够完整，部分适用于 MySQL 的默认配置没有加上，比如我们这缺失的 ：

dbPlatform.setColumnAliasPrefix(null);

不过查看 Ebean 对于 MySQL 的默认配置：

![在这里插入图片描述][b0dec6f107f34447ae2609e26bb7c5d6.png]

你看，默认的参数和手动配置参数值的是否一样？同时也更加完善，大部分时候，默认配置可能都是最优解。

--------------------

## 解决方案： ##

新增配置项：

dbPlatform.setColumnAliasPrefix(null);

取消这种默认定义别名的方式，最后的正确的 SQL 语法：

select count(distinct t0.content_id) from call_record t0 where t0.type = 'user';

当然，也不排除这个本身是 Ebean 的问题，可以进一步做的更好，比如改进聚合函数取别名的方式等。

不同框架在底层细节实现上可能有些不同，但一般都留足了可扩展的口子，提供给你去定制化使用；当然，如非必要，直接使用默认配置可能是最优解！

[ac42200834c846d8b0e71de8af01435c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/9df5d47df52a4661b4b80c665a3ea291.png
[b0dec6f107f34447ae2609e26bb7c5d6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/f1888417d68d4238aeda1f827c3a54fc.png