com.litongjava.db.activerecord.dialect

类 Dialect

java.lang.Object

com.litongjava.db.activerecord.dialect.Dialect

直接已知子类:

AnsiSqlDialect, H2Dialect, InformixDialect, MysqlDialect, OracleDialect, PostgreSqlDialect, Sqlite3Dialect, SqlServerDialect, TdEngineDialect

public abstract class Dialect
extends Object

Dialect.

嵌套类概要

嵌套类

限定符和类型	类和说明
protected static class	Dialect.Holder

字段概要

字段

限定符和类型	字段和说明
protected boolean	keepByteAndShort
protected ModelBuilder	modelBuilder
protected RecordBuilder	recordBuilder

构造器概要

构造器

构造器和说明
Dialect()

方法概要

限定符和类型	方法和说明
<T> List<T>	buildModelList(ResultSet rs, Class<? extends Model> modelClass)
List<Record>	buildRecordList(Config config, ResultSet rs)
List<Record>	buildRecordListWithJsonFields(Config config, ResultSet rs, String[] jsonFields)
<T> void	eachModel(ResultSet rs, Class<? extends Model> modelClass, java.util.function.Function<T,Boolean> func)
void	eachRecord(Config config, ResultSet rs, java.util.function.Function<Record,Boolean> func)
void	fillStatement(PreparedStatement pst, List<Object> paras)
void	fillStatement(PreparedStatement pst, Object... paras)
protected void	fillStatementHandleDateType(PreparedStatement pst, List<Object> paras) fillStatement 时处理日期类型
protected void	fillStatementHandleDateType(PreparedStatement pst, Object... paras) fillStatement 时处理日期类型
abstract void	forDbDelete(String tableName, String[] pKeys, Record record, StringBuilder sql, List<Object> paras)
abstract String	forDbDeleteById(String tableName, String[] pKeys)
abstract String	forDbFindById(String tableName, String[] pKeys)
abstract String	forDbFindColumns(String tableName, String columns)
abstract String	forDbFindColumnsById(String tableName, String columns, String[] pKeys)
abstract void	forDbSave(String tableName, String[] pKeys, Record record, StringBuilder sql, List<Object> paras)
abstract void	forDbSave(String tableName, String[] pKeys, Record record, StringBuilder sql, List<Object> paras, String[] jsonFields)
abstract void	forDbUpdate(String tableName, String[] pKeys, Object[] ids, Record record, StringBuilder sql, List<Object> paras)
abstract void	forDbUpdate(String tableName, String[] pKeys, Object[] ids, Record record, StringBuilder sql, List<Object> paras, String[] jsonFields)
abstract String	forExistsByFields(String tableName, String fields)
String	forFindAll(String tableName)
abstract String	forModelDeleteById(Table table)
abstract String	forModelFindById(Table table, String columns)
abstract void	forModelSave(Table table, Map<String,Object> attrs, StringBuilder sql, List<Object> paras)
abstract void	forModelUpdate(Table table, Map<String,Object> attrs, Set<String> modifyFlag, StringBuilder sql, List<Object> paras)
abstract String	forPaginate(int pageNumber, int pageSize, StringBuilder findSql)
String	forPaginateTotalRow(String select, String sqlExceptSelect, Object ext) 为分页方法生成查询 totalRow 值的 sql
abstract String	forTableBuilderDoBuild(String tableName)
String	getDefaultPrimaryKey()
void	getModelGeneratedKey(Model<?> model, PreparedStatement pst, Table table) 用于获取 Model.save() 以后自动生成的主键值，可通过覆盖此方法实现更精细的控制 目前只有 PostgreSqlDialect，覆盖过此方法
void	getRecordGeneratedKey(PreparedStatement pst, Record record, String[] pKeys) 用于获取 Db.save(tableName, record) 以后自动生成的主键值，可通过覆盖此方法实现更精细的控制 目前只有 PostgreSqlDialect，覆盖过此方法
boolean	isKeepByteAndShort() 指示 MetaBuilder 生成的 ColumnMeta.javaType 是否保持住 Byte、Short 类型 进而 BaseModelBuilder 生成针对 Byte、Short 类型的获取方法： getByte(String)、getShort(String)
boolean	isOracle()
boolean	isPrimaryKey(String colName, String[] pKeys)
boolean	isTakeOverDbPaginate()
boolean	isTakeOverModelPaginate()
protected void	processGeneratedBigIntegerKey(Model<?> model, String pKey, Object v) mysql 数据库的 bigint unsigned 对应的 java 类型为 BigInteger 但是 rs.getObject(1) 返回值为 Long 型，造成 model.save() 以后 model.getId() 时的类型转换异常
String	replaceOrderBy(String sql)
Dialect	setKeepByteAndShort(boolean keepByteAndShort) 指示 Generator、ModelBuilder、RecordBuilder 是否保持住 Byte、Short 类型
Dialect	setModelBuilder(ModelBuilder modelBuilder) 配置自定义 ModelBuilder 通过继承扩展 ModelBuilder 可以对 JDBC 到 java 数据类型进行定制化转换 不同数据库从 JDBC 到 java 数据类型的映射关系有所不同 此外，还可以通过改变 ModelBuilder.buildLabelNamesAndTypes() 方法逻辑，实现下划线字段名转驼峰变量名的功能
Dialect	setRecordBuilder(RecordBuilder recordBuilder) 配置自定义 RecordBuilder 通过继承扩展 RecordBuilder 可以对 JDBC 到 java 数据类型进行定制化转换 不同数据库从 JDBC 到 java 数据类型的映射关系有所不同 此外，还可以通过改变 RecordBuilder.buildLabelNamesAndTypes() 方法逻辑，实现下划线字段名转驼峰变量名的功能
<T> Page<T>	takeOverDbPaginate(Connection conn, int pageNumber, int pageSize, Boolean isGroupBySql, String totalRowSql, StringBuilder findSql, Object... paras)
Page	takeOverModelPaginate(Connection conn, Class<? extends Model> modelClass, int pageNumber, int pageSize, Boolean isGroupBySql, String totalRowSql, StringBuilder findSql, Object... paras)
void	trimPrimaryKeys(String[] pKeys)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

keepByteAndShort

protected boolean keepByteAndShort

modelBuilder

protected ModelBuilder modelBuilder

recordBuilder

protected RecordBuilder recordBuilder

构造器详细资料

Dialect

public Dialect()

方法详细资料

forTableBuilderDoBuild

public abstract String forTableBuilderDoBuild(String tableName)

forPaginate

public abstract String forPaginate(int pageNumber,
                                   int pageSize,
                                   StringBuilder findSql)

forModelFindById

public abstract String forModelFindById(Table table,
                                        String columns)

forModelDeleteById

public abstract String forModelDeleteById(Table table)

forModelSave

public abstract void forModelSave(Table table,
                                  Map<String,Object> attrs,
                                  StringBuilder sql,
                                  List<Object> paras)

forModelUpdate

public abstract void forModelUpdate(Table table,
                                    Map<String,Object> attrs,
                                    Set<String> modifyFlag,
                                    StringBuilder sql,
                                    List<Object> paras)

forDbFindById

public abstract String forDbFindById(String tableName,
                                     String[] pKeys)

forDbFindColumnsById

public abstract String forDbFindColumnsById(String tableName,
                                            String columns,
                                            String[] pKeys)

forDbFindColumns

public abstract String forDbFindColumns(String tableName,
                                        String columns)

forDbDeleteById

public abstract String forDbDeleteById(String tableName,
                                       String[] pKeys)

forDbSave

public abstract void forDbSave(String tableName,
                               String[] pKeys,
                               Record record,
                               StringBuilder sql,
                               List<Object> paras,
                               String[] jsonFields)

forDbSave

public abstract void forDbSave(String tableName,
                               String[] pKeys,
                               Record record,
                               StringBuilder sql,
                               List<Object> paras)

forDbDelete

public abstract void forDbDelete(String tableName,
                                 String[] pKeys,
                                 Record record,
                                 StringBuilder sql,
                                 List<Object> paras)

forDbUpdate

public abstract void forDbUpdate(String tableName,
                                 String[] pKeys,
                                 Object[] ids,
                                 Record record,
                                 StringBuilder sql,
                                 List<Object> paras)

forDbUpdate

public abstract void forDbUpdate(String tableName,
                                 String[] pKeys,
                                 Object[] ids,
                                 Record record,
                                 StringBuilder sql,
                                 List<Object> paras,
                                 String[] jsonFields)

forFindAll

public String forFindAll(String tableName)

setKeepByteAndShort

public Dialect setKeepByteAndShort(boolean keepByteAndShort)

指示 Generator、ModelBuilder、RecordBuilder 是否保持住 Byte、Short 类型

isKeepByteAndShort

public boolean isKeepByteAndShort()

指示 MetaBuilder 生成的 ColumnMeta.javaType 是否保持住 Byte、Short 类型 进而 BaseModelBuilder 生成针对 Byte、Short 类型的获取方法： getByte(String)、getShort(String)

setModelBuilder

public Dialect setModelBuilder(ModelBuilder modelBuilder)

配置自定义 ModelBuilder

通过继承扩展 ModelBuilder 可以对 JDBC 到 java 数据类型进行定制化转换 不同数据库从 JDBC 到 java 数据类型的映射关系有所不同

此外，还可以通过改变 ModelBuilder.buildLabelNamesAndTypes() 方法逻辑，实现下划线字段名转驼峰变量名的功能

setRecordBuilder

public Dialect setRecordBuilder(RecordBuilder recordBuilder)

配置自定义 RecordBuilder

通过继承扩展 RecordBuilder 可以对 JDBC 到 java 数据类型进行定制化转换 不同数据库从 JDBC 到 java 数据类型的映射关系有所不同

此外，还可以通过改变 RecordBuilder.buildLabelNamesAndTypes() 方法逻辑，实现下划线字段名转驼峰变量名的功能

buildModelList

public <T> List<T> buildModelList(ResultSet rs,
                                  Class<? extends Model> modelClass)
                           throws SQLException,
                                  ReflectiveOperationException

抛出:

SQLException

ReflectiveOperationException

eachModel

public <T> void eachModel(ResultSet rs,
                          Class<? extends Model> modelClass,
                          java.util.function.Function<T,Boolean> func)
                   throws SQLException,
                          ReflectiveOperationException

抛出:

SQLException

ReflectiveOperationException

buildRecordList

public List<Record> buildRecordList(Config config,
                                    ResultSet rs)
                             throws SQLException

抛出:

SQLException

buildRecordListWithJsonFields

public List<Record> buildRecordListWithJsonFields(Config config,
                                                  ResultSet rs,
                                                  String[] jsonFields)
                                           throws SQLException

抛出:

SQLException

eachRecord

public void eachRecord(Config config,
                       ResultSet rs,
                       java.util.function.Function<Record,Boolean> func)
                throws SQLException

抛出:

SQLException

getModelGeneratedKey

public void getModelGeneratedKey(Model<?> model,
                                 PreparedStatement pst,
                                 Table table)
                          throws SQLException

用于获取 Model.save() 以后自动生成的主键值，可通过覆盖此方法实现更精细的控制 目前只有 PostgreSqlDialect，覆盖过此方法

抛出:

SQLException

processGeneratedBigIntegerKey

protected void processGeneratedBigIntegerKey(Model<?> model,
                                             String pKey,
                                             Object v)

mysql 数据库的 bigint unsigned 对应的 java 类型为 BigInteger 但是 rs.getObject(1) 返回值为 Long 型，造成 model.save() 以后 model.getId() 时的类型转换异常

getRecordGeneratedKey

public void getRecordGeneratedKey(PreparedStatement pst,
                                  Record record,
                                  String[] pKeys)
                           throws SQLException

用于获取 Db.save(tableName, record) 以后自动生成的主键值，可通过覆盖此方法实现更精细的控制 目前只有 PostgreSqlDialect，覆盖过此方法

抛出:

SQLException

isOracle

public boolean isOracle()

isTakeOverDbPaginate

public boolean isTakeOverDbPaginate()

takeOverDbPaginate

public <T> Page<T> takeOverDbPaginate(Connection conn,
                                      int pageNumber,
                                      int pageSize,
                                      Boolean isGroupBySql,
                                      String totalRowSql,
                                      StringBuilder findSql,
                                      Object... paras)
                               throws SQLException

抛出:

SQLException

isTakeOverModelPaginate

public boolean isTakeOverModelPaginate()

takeOverModelPaginate

public Page takeOverModelPaginate(Connection conn,
                                  Class<? extends Model> modelClass,
                                  int pageNumber,
                                  int pageSize,
                                  Boolean isGroupBySql,
                                  String totalRowSql,
                                  StringBuilder findSql,
                                  Object... paras)
                           throws Exception

抛出:

Exception

fillStatement

public void fillStatement(PreparedStatement pst,
                          List<Object> paras)
                   throws SQLException

抛出:

SQLException

fillStatement

public void fillStatement(PreparedStatement pst,
                          Object... paras)
                   throws SQLException

抛出:

SQLException

getDefaultPrimaryKey

public String getDefaultPrimaryKey()

isPrimaryKey

public boolean isPrimaryKey(String colName,
                            String[] pKeys)

replaceOrderBy

public String replaceOrderBy(String sql)

fillStatementHandleDateType

protected void fillStatementHandleDateType(PreparedStatement pst,
                                           List<Object> paras)
                                    throws SQLException

fillStatement 时处理日期类型

抛出:

SQLException

fillStatementHandleDateType

protected void fillStatementHandleDateType(PreparedStatement pst,
                                           Object... paras)
                                    throws SQLException

fillStatement 时处理日期类型

抛出:

SQLException

forPaginateTotalRow

public String forPaginateTotalRow(String select,
                                  String sqlExceptSelect,
                                  Object ext)

为分页方法生成查询 totalRow 值的 sql

参数:

select - sql 语句的 select 部分

sqlExceptSelect - sql 语句除了 select 以外的部分

ext - 扩展参数，在 Model 调用时传入 Model 对象，在 DbPro 调用时传入 null

trimPrimaryKeys

public void trimPrimaryKeys(String[] pKeys)

forExistsByFields

public abstract String forExistsByFields(String tableName,
                                         String fields)