IDialect (ymate-platform-v2-码云(gitee.com))

All Known Implementing Classes:

AbstractDialect, DB2Dialect, H2Dialect, HSQLDBDialect, MySQLDialect, OracleDialect, PostgreSQLDialect, SQLiteDialect, SQLServerDialect
```
@Ignored
public interface IDialect
```
数据库方言接口定义，用于适配不同数据库特性

Author:

刘镇 (suninformation@163.com) on 2011-8-30 下午01:02:44

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`String`	`buildCountSQL(String originSql)` 构建计算查询结果总记录数量的SQL语句
`String`	`buildCreateSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable)` 构建创建实体数据表SQL语句
`String`	`buildDeleteByPkSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable, Fields pkFields)` 构建删除实体数据记录SQL语句
`String`	`buildDropSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable)` 构建删除实体数据表SQL语句
`String`	`buildInsertSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable, Fields fields)` 构建插入实体数据记录SQL语句
`String`	`buildPagedQuerySql(String originSql, int page, int pageSize)` 构建分页SQL语句
`String`	`buildSelectByPkSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable, Fields pkFields, Fields fields)` 构建根据主键查询实体数据记录SQL语句
`String`	`buildSelectSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable, Fields fields)` 构建查询全部实体数据记录SQL语句
`String`	`buildTableName(String prefix, EntityMeta entityMeta, IShardingable shardingable)` 获取完整的数据表名称，并根据数据库特性决定是否添加引用标识符
`String`	`buildTableName(String prefix, String tableName, IShardingRule shardingRule, IShardingable shardingable)` 获取完整的数据表名称，并根据数据库特性决定是否添加引用标识符
`String`	`buildUpdateByPkSql(Class<? extends IEntity> entityClass, String prefix, IShardingable shardingable, Fields pkFields, Fields fields)` 构建更新实体数据记录SQL语句
`Map<String,Object>`	`getGeneratedKey(Statement statement, List<String> autoincrementKeys)` 获取自增主键值（按 Long 类型返回），采用JDBC Statement对象获取自动生成的主键（仅处理单主键）
`String`	`getIdentifierQuoteBegin()` 获取引用标识符
`String`	`getIdentifierQuoteEnd()` 获取引用标识符
`String`	`getName()` 获取方言名称
`String`	`getSequenceNextValSql(String sequenceName)` 获取下一序列值的SQL语句
`boolean`	`hasIdentifierQuote()` 是否存在引用标识符
`void`	`setIdentifierQuote(String identifierQuoteBegin, String identifierQuoteEnd)` 设置引用标识符
`String`	`wrapIdentifierQuote(String origin)` 添加引用标识符的字段或表名称，防止字段或表名与关键字冲突，此接口方法默认实现按原样返回

- Method Detail
  - getName
```
String getName()
```
    获取方言名称
    
    Returns:
    
    返回方言名称
  - wrapIdentifierQuote
```
String wrapIdentifierQuote(String origin)
```
    添加引用标识符的字段或表名称，防止字段或表名与关键字冲突，此接口方法默认实现按原样返回
    
    Parameters:
    
    origin - 字段或表名称
    
    Returns:
    
    返回添加引用标识符的字段或表名称
  - setIdentifierQuote
```
void setIdentifierQuote(String identifierQuoteBegin,
                        String identifierQuoteEnd)
```
    设置引用标识符
    
    Parameters:
    
    identifierQuoteBegin - 引用标识符开始
    
    identifierQuoteEnd - 引用标识符结束
  - hasIdentifierQuote
```
boolean hasIdentifierQuote()
```
    是否存在引用标识符
    
    Returns:
    
    返回true表示引用标识符存在(即值不为空)
  - getIdentifierQuoteBegin
```
String getIdentifierQuoteBegin()
```
    获取引用标识符
    
    Returns:
    
    返回引用标识符
  - getIdentifierQuoteEnd
```
String getIdentifierQuoteEnd()
```
    获取引用标识符
    
    Returns:
    
    返回引用标识符
  - buildTableName
```
String buildTableName(String prefix,
                      EntityMeta entityMeta,
                      IShardingable shardingable)
```
    获取完整的数据表名称，并根据数据库特性决定是否添加引用标识符
    
    Parameters:
    
    prefix - 数据表名称前缀
    
    entityMeta - 数据实体属性描述对象
    
    shardingable - 分片(表)参数对象
    
    Returns:
    
    返回数据表名称
  - buildTableName
```
String buildTableName(String prefix,
                      String tableName,
                      IShardingRule shardingRule,
                      IShardingable shardingable)
```
    获取完整的数据表名称，并根据数据库特性决定是否添加引用标识符
    
    Parameters:
    
    prefix - 数据表名称前缀
    
    tableName - 数据表名称
    
    shardingRule - 数据分片(表)规则
    
    shardingable - 分片(表)参数对象
    
    Returns:
    
    返回数据表名称
  - getGeneratedKey
```
Map<String,Object> getGeneratedKey(Statement statement,
                                   List<String> autoincrementKeys)
                            throws SQLException
```
    获取自增主键值（按 Long 类型返回），采用JDBC Statement对象获取自动生成的主键（仅处理单主键）
    
    Parameters:
    
    statement - Statement对象
    
    autoincrementKeys - 自定义自增字段名称集合
    
    Returns:
    
    返回自动生成的主键
    
    Throws:
    
    SQLException - 可能产生的异常
  - getSequenceNextValSql
```
String getSequenceNextValSql(String sequenceName)
```
    获取下一序列值的SQL语句
    
    Parameters:
    
    sequenceName - 序列名称
    
    Returns:
    
    返回下一序列值的SQL语句
  - buildPagedQuerySql
```
String buildPagedQuerySql(String originSql,
                          int page,
                          int pageSize)
```
    构建分页SQL语句
    
    Parameters:
    
    originSql - 原SQL语句
    
    page - 页号
    
    pageSize - 每页记录数
    
    Returns:
    
    返回分页SQL语句
  - buildCountSQL
```
String buildCountSQL(String originSql)
```
    构建计算查询结果总记录数量的SQL语句
    
    Parameters:
    
    originSql - 原SQL语句
    
    Returns:
    
    返回计算查询结果总记录数量的SQL语句
  - buildCreateSql
```
String buildCreateSql(Class<? extends IEntity> entityClass,
                      String prefix,
                      IShardingable shardingable)
```
    构建创建实体数据表SQL语句
    
    Parameters:
    
    entityClass - 实体模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    Returns:
    
    返回创建实体数据表SQL语句
  - buildDropSql
```
String buildDropSql(Class<? extends IEntity> entityClass,
                    String prefix,
                    IShardingable shardingable)
```
    构建删除实体数据表SQL语句
    
    Parameters:
    
    entityClass - 实体模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    Returns:
    
    返回删除实体数据表SQL语句
  - buildInsertSql
```
String buildInsertSql(Class<? extends IEntity> entityClass,
                      String prefix,
                      IShardingable shardingable,
                      Fields fields)
```
    构建插入实体数据记录SQL语句
    
    Parameters:
    
    entityClass - 实体模模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    fields - 字段名称集合，可选参数，若不指定则包括全部字段
    
    Returns:
    
    返回插入实体数据记录SQL语句
  - buildDeleteByPkSql
```
String buildDeleteByPkSql(Class<? extends IEntity> entityClass,
                          String prefix,
                          IShardingable shardingable,
                          Fields pkFields)
```
    构建删除实体数据记录SQL语句
    
    Parameters:
    
    entityClass - 实体模模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    pkFields - 主键字段名称集合，可选参数，若不指定则包括全部主键
    
    Returns:
    
    返回删除实体数据记录SQL语句
  - buildUpdateByPkSql
```
String buildUpdateByPkSql(Class<? extends IEntity> entityClass,
                          String prefix,
                          IShardingable shardingable,
                          Fields pkFields,
                          Fields fields)
```
    构建更新实体数据记录SQL语句
    
    Parameters:
    
    entityClass - 实体模模型类
    
    prefix - 前缀名称
    
    shardingable - 分片(表)参数对象
    
    pkFields - 主键字段名称集合，可选参数，若不指定则包括全部主键
    
    fields - 字段名称集合，可选参数，若不指定则包括全部字段
    
    Returns:
    
    返回更新实体数据记录SQL语句
  - buildSelectByPkSql
```
String buildSelectByPkSql(Class<? extends IEntity> entityClass,
                          String prefix,
                          IShardingable shardingable,
                          Fields pkFields,
                          Fields fields)
```
    构建根据主键查询实体数据记录SQL语句
    
    Parameters:
    
    entityClass - 实体模模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    pkFields - 主键字段名称集合，可选参数，若不指定则包括全部主键
    
    fields - 字段名称集合，可选参数，若不指定则包括全部字段
    
    Returns:
    
    返回根据主键查询实体数据记录SQL语句
  - buildSelectSql
```
String buildSelectSql(Class<? extends IEntity> entityClass,
                      String prefix,
                      IShardingable shardingable,
                      Fields fields)
```
    构建查询全部实体数据记录SQL语句
    
    Parameters:
    
    entityClass - 实体模模型类
    
    prefix - 实体名称前缀
    
    shardingable - 分片(表)参数对象
    
    fields - 字段名称集合，可选参数，若不指定则包括全部字段
    
    Returns:
    
    返回查询全部实体数据记录SQL语句

Interface IDialect

Method Summary

Method Detail

getName

wrapIdentifierQuote

setIdentifierQuote

hasIdentifierQuote

getIdentifierQuoteBegin

getIdentifierQuoteEnd

buildTableName

buildTableName

getGeneratedKey

getSequenceNextValSql

buildPagedQuerySql

buildCountSQL

buildCreateSql

buildDropSql

buildInsertSql

buildDeleteByPkSql

buildUpdateByPkSql

buildSelectByPkSql

buildSelectSql