com.dt.jdbc.norm.JdbcEngine Maven / Gradle / Ivy
package com.dt.jdbc.norm;
import com.dt.core.engine.ColumnEngine;
import com.dt.core.engine.LimitEngine;
import com.dt.core.engine.WhereEngine;
import com.dt.core.norm.Engine;
import com.dt.core.norm.Model;
import com.dt.jdbc.bean.PageResultForBean;
import com.dt.jdbc.bean.PageResultForMap;
import com.dt.jdbc.bean.Pagination;
import com.dt.jdbc.core.SpringJdbcEngine;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Map;
/**
* jdbc 增删改查接口
* 提供总计多达100+种方法
*
注意,凡是涉及列名请使用驼峰命名法转义后的属性名,生成的模板类有对应的常量供使用
*
* @author 白超
* @version 1.0
* @see SpringJdbcEngine
* @since 2018/7/10
*/
@SuppressWarnings("unused")
public interface JdbcEngine {
/**
* 复制一张表
*
不会复制表的数据
*
* @param sourceTableName 源表名
* @param targetTableName 目标表名
* @return 不反回任何值, 这里返回int为占位用
*/
int copyTable(String sourceTableName, String targetTableName);
/**
* 删除表
*
* @param tableName 表名
* @return 不反回任何值, 这里返回int为占位用
*/
int deleteTable(String tableName);
/**
* 重命名表
*
* @param sourceTableName 源表名
* @param targetTableName 目标表名
* @return 不反回任何值, 这里返回 {@code int} 为占位用
*/
int renameTable(String sourceTableName, String targetTableName);
/**
* 查询表是否存在
*
* @param tableName 表名
* @return 存在返回 {@code true}, 不存在返回 {@link false}
*/
boolean isTableExist(String tableName);
/**
* 根据主键查询
*
若查询不到对应数据,返回 {@code null}
*
* @param keyValue 主键值
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 查询结果注入Map返回, key-属性名(驼峰命名法) value-属性值
*/
Map queryByPrimaryKey(Object keyValue, ColumnEngine columnEngine);
/**
* 根据主键查询
* 若查询不到对应数据,返回 {@code null}
*
注意,用于接收数据的容器必须具备对应查询字段(驼峰命名法)的setter方法
*
* @param keyValue 主键值
* @param returnType 返回容器类型,用于接收查询结果
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 与returnType指定数据类型一致
* @return 查询结果注入指定的returnType对象
*/
T queryByPrimaryKey(Object keyValue, Class returnType, ColumnEngine columnEngine);
/**
* 查询唯一一条数据
* 若查询不到对应数据,返回 {@code null}
*
若查询到多条数据,抛异常 {@link org.springframework.dao.IncorrectResultSizeDataAccessException}
*
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 查询结果注入Map返回, key-属性名(驼峰命名法) value-属性值
*/
Map queryOne(Engine engine);
/**
* 查询唯一一条数据
* 若查询不到对应数据,返回 {@code null}
*
若查询到多条数据,抛异常 {@link org.springframework.dao.IncorrectResultSizeDataAccessException}
*
注意,用于接收数据的容器必须具备对应查询字段(驼峰命名法)的setter方法
*
* @param returnType 返回容器类型,用于接收查询结果
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 与returnType指定数据类型一致
* @return 查询结果注入指定的returnType对象
*/
T queryOne(Class returnType, Engine engine);
/**
* 查询多条数据
* 若查询不到对应数据,返回长度为0的空集合
*
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 查询结果注入Map装入ArrayList返回, key-属性名(驼峰命名法) value-属性值
*/
List> queryForList(Engine engine);
/**
* 查询多条数据
* 若查询不到对应数据,返回长度为0的空集合
*
注意,用于接收数据的容器必须具备对应查询字段(驼峰命名法)的setter方法
*
* @param returnType 返回容器类型,用于接收查询结果
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 与returnType指定数据类型一致
* @return 查询结果注入指定的returnType对象装入ArrayList返回
*/
List queryForList(Class returnType, Engine engine);
/**
* 查询总数
* 若查询不到对应数据,抛异常 {@link org.springframework.dao.EmptyResultDataAccessException}
*
若查询到多条数据,抛异常 {@link org.springframework.dao.IncorrectResultSizeDataAccessException}
*
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 总数
*/
int queryCount(Engine engine);
/**
* 分页查询
*
默认方法,内部先调用 {@link #queryCount(Engine)} 查询总数
*
若总数为0,则直接返回结果
*
若总数不为0,则根据参数构建分页对象 {@link Pagination} 并获取分页起始号
*
最后调用 {@link #queryForList(Engine)} 查询数据
*
* @param currentPage 当前页号
* @param pageSize 每页显示条数
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 分页结果 {@link PageResultForMap}
*/
default PageResultForMap pageQueryForList(int currentPage, int pageSize, LimitEngine engine) {
int count = this.queryCount(engine);
Pagination pagination = new Pagination(count, currentPage, pageSize);
PageResultForMap pageResult = new PageResultForMap();
pageResult.setPagination(pagination);
if (count == 0) {
pageResult.setResult(new ArrayList<>());
return pageResult;
}
engine.limit(pagination.getLimitStart(), pagination.getLimitEnd());
pageResult.setResult(this.queryForList(engine));
return pageResult;
}
/**
* 分页查询
*
默认方法,内部先调用 {@link #queryCount(Engine)} 查询总数
*
若总数为0,则直接返回结果
*
若总数不为0,则根据参数构建分页对象 {@link Pagination} 并获取分页起始号
*
最后调用 {@link #queryForList(Engine)} 查询数据
*
* @param returnType 返回容器类型,用于接收查询结果
* @param currentPage 当前页号
* @param pageSize 每页显示条数
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 与returnType指定数据类型一致
* @return 分页结果 {@link PageResultForBean}
*/
default PageResultForBean pageQueryForList(Class returnType, int currentPage, int pageSize, LimitEngine engine) {
int count = this.queryCount(engine);
Pagination pagination = new Pagination(count, currentPage, pageSize);
PageResultForBean pageResult = new PageResultForBean<>();
pageResult.setPagination(pagination);
if (count == 0) {
pageResult.setResult(new ArrayList<>());
return pageResult;
}
engine.limit(pagination.getLimitStart(), pagination.getLimitEnd());
pageResult.setResult(this.queryForList(returnType, engine));
return pageResult;
}
/**
* 查询一对列值存入Map(默认第一列为key,第二列为value)
* 你可以使用该方法将某列值指定为key,另一列列值为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @param 作为value的列值类型
* @return 查询结果注入Map返回
*/
Map queryPairColumnInMap(Engine engine);
/**
* 查询一对列值存入Map
* 你可以使用该方法将某列值指定为key,另一列列值为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyIndex 作为key的列下标(从1开始)
* @param valueIndex 作为value的列下标(从1开始)
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @param 作为value的列值类型
* @return 查询结果注入Map返回
*/
Map queryPairColumnInMap(int keyIndex, int valueIndex, Engine engine);
/**
* 查询一对列值存入Map
* 你可以使用该方法将某列值指定为key,另一列列值为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyColumnName 作为key的列字段名(驼峰命名法)
* @param valueColumnName 作为value的列字段名(驼峰命名法)
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @param 作为value的列值类型
* @return 查询结果注入Map返回
*/
Map queryPairColumnInMap(String keyColumnName, String valueColumnName, Engine engine);
/**
* 查询结果存入Map
* 该方法类似于 {@link #queryPairColumnInMap(int, int, Engine)}
*
你可以使用该方法将某列值指定为key,然后每一行的结果数据作为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyIndex 作为key的列下标(从1开始)
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @return 查询结果注入Map返回
*/
Map> queryForListInMap(int keyIndex, Engine engine);
/**
* 查询结果存入Map
* 该方法类似于 {@link #queryPairColumnInMap(int, int, Engine)}
*
你可以使用该方法将某列值指定为key,然后每一行的结果数据作为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyColumnName 作为key的列字段名(驼峰命名法)
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @return 查询结果注入Map返回
*/
Map> queryForListInMap(String keyColumnName, Engine engine);
/**
* 查询结果存入Map
* 该方法类似于 {@link #queryPairColumnInMap(int, int, Engine)}
*
你可以使用该方法将某列值指定为key,然后每一行的结果数据作为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyIndex 作为key的列下标(从1开始)
* @param returnType 返回容器类型,用于接收查询结果
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @param 与returnType指定数据类型一致
* @return 查询结果注入Map返回
*/
Map queryForListInMap(int keyIndex, Class returnType, Engine engine);
/**
* 查询结果存入Map
* 该方法类似于 {@link #queryPairColumnInMap(int, int, Engine)}
*
你可以使用该方法将某列值指定为key,然后每一行的结果数据作为value,结果集注入Map中
*
注意,由于Map集合特性,作为key的列值,若重复出现,则会覆盖前者数据
*
* @param keyColumnName 作为key的列字段名(驼峰命名法)
* @param returnType 返回容器类型,用于接收查询结果
* @param engine 用于构建查询SQL的引擎 {@link com.dt.core.engine.MySqlEngine}
* @param 作为key的列值类型
* @param 与returnType指定数据类型一致
* @return 查询结果注入Map返回
*/
Map queryForListInMap(String keyColumnName, Class returnType, Engine engine);
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param modelClass 生成的表模型类
* @param args 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int insertArgs(Class modelClass, Object... args) {
return this.insertArgs(args, modelClass);
}
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param args 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int insertArgs(String tableName, Class modelClass, Object... args) {
return this.insertArgs(args, tableName, modelClass);
}
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param args 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertArgs(Object[] args, Class modelClass);
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param args 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertArgs(Object[] args, String tableName, Class modelClass);
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param args 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertArgs(Collection args, Class modelClass);
/**
* 不推荐使用该方法
* 根据参数插入一条数据
*
参数顺序需要对应列顺序
*
* @param args 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertArgs(Collection args, String tableName, Class modelClass);
/**
* 指定列及参数插入一条数据
* 列顺序必须和参数顺序一致
*
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @param args 参数
* @return 影响的行数
*/
default int insertArgs(ColumnEngine columnEngine, Object... args) {
return this.insertArgs(args, columnEngine);
}
/**
* 指定列及参数插入一条数据
*
列顺序必须和参数顺序一致
*
* @param args 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertArgs(Object[] args, ColumnEngine columnEngine);
/**
* 指定列及参数插入一条数据
*
列顺序必须和参数顺序一致
*
* @param args 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertArgs(Collection args, ColumnEngine columnEngine);
/**
* 使用数据容器插入一条数据
*
数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecord(Map record, Class modelClass);
/**
* 使用数据容器插入一条数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecord(Map record, String tableName, Class modelClass);
/**
* 使用数据容器插入一条数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecord(Object record, Class modelClass);
/**
* 使用数据容器插入一条数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecord(Object record, String tableName, Class modelClass);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertRecord(Map record, ColumnEngine columnEngine);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertRecord(Object record, ColumnEngine columnEngine);
/**
* 使用数据容器指定列名插入一条数据
*
数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecordSelective(Map record, Class modelClass);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecordSelective(Map record, String tableName, Class modelClass);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecordSelective(Object record, Class modelClass);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int insertRecordSelective(Object record, String tableName, Class modelClass);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertRecordSelective(Map record, ColumnEngine columnEngine);
/**
* 使用数据容器指定列名插入一条数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int insertRecordSelective(Object record, ColumnEngine columnEngine);
/**
* 不推荐使用
*
根据参数批量插入数据
*
* @param modelClass 生成的表模型类
* @param batchArgs 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchInsertArgs(Class modelClass, Object... batchArgs) {
return this.batchInsertArgs(batchArgs, modelClass);
}
/**
* 不推荐使用
* 根据参数批量插入数据
*
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param batchArgs 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchInsertArgs(String tableName, Class modelClass, Object... batchArgs) {
return this.batchInsertArgs(batchArgs, tableName, modelClass);
}
/**
* 不推荐使用
* 根据参数批量插入数据
*
* @param batchArgs 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertArgs(Object[] batchArgs, Class modelClass);
/**
* 不推荐使用
* 根据参数批量插入数据
*
* @param batchArgs 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertArgs(Object[] batchArgs, String tableName, Class modelClass);
/**
* 不推荐使用
* 根据参数批量插入数据
*
* @param batchArgs 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertArgs(Collection batchArgs, Class modelClass);
/**
* 不推荐使用
* 根据参数批量插入数据
*
* @param batchArgs 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertArgs(Collection batchArgs, String tableName, Class modelClass);
/**
* 指定列名及参数批量插入数据
*
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @param batchArgs 参数
* @return 影响的行数
*/
default int batchInsertArgs(ColumnEngine columnEngine, Object... batchArgs) {
return this.batchInsertArgs(batchArgs, columnEngine);
}
/**
* 指定列名及参数批量插入数据
*
* @param batchArgs 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int batchInsertArgs(Object[] batchArgs, ColumnEngine columnEngine);
/**
* 指定列名及参数批量插入数据
*
* @param batchArgs 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int batchInsertArgs(Collection batchArgs, ColumnEngine columnEngine);
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param modelClass 生成的表模型类
* @param records 数据容器
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchInsertRecords(Class modelClass, Object... records) {
return this.batchInsertRecords(records, modelClass);
}
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param records 数据容器
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchInsertRecords(String tableName, Class modelClass, Object... records) {
return this.batchInsertRecords(records, tableName, modelClass);
}
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertRecords(Object[] records, Class modelClass);
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertRecords(Object[] records, String tableName, Class modelClass);
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertRecords(Collection records, Class modelClass);
/**
* 使用数据容器批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int batchInsertRecords(Collection records, String tableName, Class modelClass);
/**
* 使用数据容器指定列名批量插入数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @param records 数据容器
* @return 影响的行数
*/
default int batchInsertRecords(ColumnEngine columnEngine, Object... records) {
return this.batchInsertRecords(records, columnEngine);
}
/**
* 使用数据容器指定列名批量插入数据
*
数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int batchInsertRecords(Object[] records, ColumnEngine columnEngine);
/**
* 使用数据容器指定列名批量插入数据
*
数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param records 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int batchInsertRecords(Collection records, ColumnEngine columnEngine);
/**
* 不推荐使用
*
根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param modelClass 生成的表模型类
* @param args 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int updateArgsByPrimaryKey(Object keyValue, Class modelClass, Object... args) {
return this.updateArgsByPrimaryKey(keyValue, args, modelClass);
}
/**
* 不推荐使用
* 根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param args 参数
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int updateArgsByPrimaryKey(Object keyValue, String tableName, Class modelClass, Object... args) {
return this.updateArgsByPrimaryKey(keyValue, args, tableName, modelClass);
}
/**
* 不推荐使用
* 根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param args 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Object[] args, Class modelClass);
/**
* 不推荐使用
* 根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param args 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Object[] args, String tableName, Class modelClass);
/**
* 不推荐使用
* 根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param args 参数
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Collection args, Class modelClass);
/**
* 不推荐使用
* 根据主键更新参数
*
参数顺序需要对应列顺序
*
* @param keyValue 主键值
* @param args 参数
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Collection args, String tableName, Class modelClass);
/**
* 根据主键更新指定字段
* 列顺序必须和参数顺序一致
*
* @param keyValue 主键值
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @param args 参数
* @return 影响的行数
*/
default int updateArgsByPrimaryKey(Object keyValue, ColumnEngine columnEngine, Object... args) {
return this.updateArgsByPrimaryKey(keyValue, args, columnEngine);
}
/**
* 根据主键更新指定字段
*
列顺序必须和参数顺序一致
*
* @param keyValue 主键值
* @param args 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Object[] args, ColumnEngine columnEngine);
/**
* 根据主键更新指定字段
*
列顺序必须和参数顺序一致
*
* @param keyValue 主键值
* @param args 参数
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateArgsByPrimaryKey(Object keyValue, Collection args, ColumnEngine columnEngine);
/**
* 根据主键使用数据容器更新数据
*
数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Map record, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Object record, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Map record, String tableName, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Object record, String tableName, Class modelClass);
/**
* 根据主键使用数据容器对指定字段进行更新
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Map record, ColumnEngine columnEngine);
/**
* 根据主键使用数据容器对指定字段进行更新
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordByPrimaryKey(Object keyValue, Object record, ColumnEngine columnEngine);
/**
* 根据主键使用数据容器更新数据
*
数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Map record, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Map record, String tableName, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Object record, Class modelClass);
/**
* 根据主键使用数据容器更新数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Object record, String tableName, Class modelClass);
/**
* 根据主键使用数据容器对指定字段进行更新
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Map record, ColumnEngine columnEngine);
/**
* 根据主键使用数据容器对指定字段进行更新
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param keyValue 主键值
* @param record 数据容器
* @param columnEngine 用于构建查询SQL的字段引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordByPrimaryKeySelective(Object keyValue, Object record, ColumnEngine columnEngine);
/**
* 更新数据
*
数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param whereEngine 用于构建查询SQL的条件引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecord(Map record, WhereEngine whereEngine);
/**
* 更新数据
* 数据容器属性如果为 {@code null},则属性对应列值也为 {@code null}
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param whereEngine 用于构建查询SQL的条件引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecord(Object record, WhereEngine whereEngine);
/**
* 更新数据
*
数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param whereEngine 用于构建查询SQL的条件引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordSelective(Map record, WhereEngine whereEngine);
/**
* 更新数据
* 数据容器属性如果为 {@code null},则不插入该属性对应列
*
数据容器与列名使用驼峰命名法进行映射
*
* @param record 数据容器
* @param whereEngine 用于构建查询SQL的条件引擎 {@link com.dt.core.engine.MySqlEngine}
* @return 影响的行数
*/
int updateRecordSelective(Object record, WhereEngine whereEngine);
/**
* 根据主键批量更新数据
*
数据容器对应的主键字段值不能为空
*
* @param modelClass 生成的表模型类
* @param records 数据容器
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchUpdateRecordsByPrimaryKeys(Class modelClass, Object... records) {
return this.batchUpdateRecordsByPrimaryKeys(records, modelClass);
}
/**
* 根据主键批量更新数据
* 数据容器对应的主键字段值不能为空
*
* @param tableName 表名
* @param modelClass 生成的表模型类
* @param records 数据容器
* @param 用于限定参数类型 {@link Model}
* @return 影响的行数
*/
default int batchUpdateRecordsByPrimaryKeys(String tableName, Class modelClass, Object... records) {
return this.batchUpdateRecordsByPrimaryKeys(records, tableName, modelClass);
}
/**
* 根据主键批量更新数据
* 数据容器对应的主键字段值不能为空
*
* @param records 数据容器
* @param modelClass 生成的表模型类
* @param