SQL 方言（Dialect）

Bean Searcher 可以为我们自动生成完整的 SQL 语句，但对应不同的数据库，SQL 语法可能略有不同。为此，Bean Searcher 使用方言（Dialect）来扩展支持这些不同的数据库。

方言实现

Bean Searcher 自带五种 Dialect 实现：

• MySqlDialect - 默认方言，可用于 类 MySql 的数据库
• OracleDialect - 可用于 类 Oracle 12c（2013年6月发布）及以上版本 的数据库
• PostgreSqlDialect - 可用于 类 PostgreSQL 的数据库（since v3.6.0）
• SqlServerDialect - 可用于 类 SqlServer (v2012+) 的数据库（since v3.7.0）
• DaMengDialect - 可用于 类 达梦 的数据库 (since v4.6.0).
• 其它数据库可自定义 Dialect，可 参考 MySqlDialect 的实现

Bean Searcher 的方言非常轻量

• 自 v3.3.0 起，实现一个方言只需重写 两个 方法；
• 自 v3.7.0 起，进一步简化为只需重写 一个 方法。

配置方法

以下介绍各框架下的方言配置。

SpringBoot / Grails

使用 bean-searcher-boot-starter 依赖时，如需切换 Bean Searcher 自带的方言，则可通过以下配置项来指定：

配置键名	含义	可选值	默认值
bean-searcher.sql.dialect	SQL 方言	MySQL、Oracle、PostgreSQL、SqlServer、DaMeng	MySQL

自定义的方言，只需将之注册为 Bean 即可：

@Bean
public Dialect myDialect() {
    return new MyDialect();
}

Others

Dialect dialect = new MyDialect();
// v3.3 起需要配置运算符池
FieldOpPool fieldOpPool = new FieldOpPool();
fieldOpPool.setDialect(dialect);    // 配置使用 Oracle 方言
DefaultParamResolver paramResolver = new DefaultParamResolver();
paramResolver.setFieldOpPool(fieldOpPool);
DefaultSqlResolver sqlResolver = new DefaultSqlResolver();
sqlResolver.setDialect(dialect);    // 配置使用 Oracle 方言
MapSearcher mapSearcher = SearcherBuilder.mapSearcher()
        // 省略其它属性配置，BeanSearcher 检索器也同此配置
        .paramResolver(paramResolver)
        .sqlResolver(sqlResolver)
        .build();

动态方言（v4.2.0）

动态方言一般在 多数据源 的场景下才会使用。其实现原理非常简单，仅两个实现类：

• DynamicDialect（核心类）
• DynamicDialectSupport

配置方法（使用 bean-searcher-boot-starter 与 bean-searcher-solon-plugin 依赖时）：

配置键名	含义	可选值	默认值
bean-searcher.sql.dialect-dynamic	是否使用动态方言	true、false	false
bean-searcher.sql.dialects	不同数据源的方言关系	Map<String, Dialect>	空

例如：

bean-searcher:
  sql:
    # 默认 MySQL 方言
    dialect: MySQL
    # 启用动态方言
    dialect-dynamic: true
    dialects:
      # user 数据源使用 Oracle 方言
      user: Oracle
      # order 数据源使用 PostgreSQL 方言
      order: PostgreSQL

以上指定的方言都是框架自带的方言，你也可以自定义方言，并用如下方法配置某个数据源使用自定义方言：

@Bean
public DataSourceDialect shopDialect() {
    // shop 数据源使用 MyDialect 自定义方言
    return new DataSourceDialect("shop", new MyDialect());
}

布尔字面量转换（since v4.6.0）

部分数据库（如 Oracle、达梦）不支持 SQL 中的布尔字面量 true / false，如果用户在 @DbField 的 condition 属性或 SQL 拦截器中手写了含 true/false 的条件，在这些数据库上会直接报错。

DialectSqlInterceptor 可以自动检测当前方言是否支持布尔字面量，并在不支持时将 SQL 中的 true 替换为 1、false 替换为 0。

SpringBoot / Grails / Solon

使用 bean-searcher-boot-starter 或 bean-searcher-solon-plugin 时，DialectSqlInterceptor 已被自动注册，无需手动配置，开箱即用。

其它框架

非 Boot/Solon 环境下，需手动将其加入拦截器链：

DialectSqlInterceptor dialectSqlInterceptor = new DialectSqlInterceptor(dialect);
MapSearcher mapSearcher = SearcherBuilder.mapSearcher()
        // 省略其它配置
        .addInterceptor(dialectSqlInterceptor)
        .build();

注意顺序

若同时启用了动态方言（DynamicDialectSupport），DialectSqlInterceptor 必须排在 DynamicDialectSupport 之后，才能正确获取到当前请求对应的方言。