public class DefaultSqlContext extends Object implements SqlContext
| Modifier | Constructor and Description |
|---|---|
protected |
DefaultSqlContext() |
| Modifier and Type | Method and Description |
|---|---|
<T> int |
delete(Class<T> entityClass,
Consumer<WhereCondition> condition)
根据指定的条件删除数据库中的记录。
|
<T> int |
deleteByPrimaryKey(Class<T> entityClass,
Collection<?> pkValues)
根据主键值集合删除数据库中的多条记录。
|
<T> int |
deleteByPrimaryKey(Class<T> entityClass,
Object pkValue)
根据主键值删除数据库中的单条记录。
|
<T> int |
insert(T entity)
插入一个实体到数据库，插入所有字段。
|
<T> int |
insertBatch(Collection<T> entities)
批量插入一组实体到数据库。
|
<T> int |
insertMultiple(Collection<T> entities)
通过追加模式插入多条记录到数据库。
|
<T> int |
insertSelective(T entity)
插入一个实体到数据库，选择性插入非空字段。
|
<T> int |
insertSelective(T entity,
Collection<Fn<T,?>> forcedFields)
插入一个实体到数据库，选择性插入非空字段，并强制插入指定字段。
|
AbstractColumnReference |
select()
创建并返回一个
AbstractColumnReference 对象，用于构建 SQL 查询操作
，并选择所需的列进行检索。 |
<T> List<T> |
selectByPrimaryKey(Class<T> entityClass,
Collection<?> pkValues)
根据多个主键查询实体对象集合。
|
<T> T |
selectByPrimaryKey(Class<T> entityClass,
Object pkValue)
根据主键查询实体对象。
|
<T> List<T> |
selectList(String sql,
Class<T> returnType)
执行指定的 SQL 查询，返回映射为指定类型的结果列表。
|
<T> List<T> |
selectList(String sql,
Class<T> returnType,
ParameterBinder parameterBinder)
使用预编译的方式执行指定的 SQL 查询，返回映射为指定类型的结果列表。
|
<T> List<T> |
selectList(String dataSourceName,
String sql,
Class<T> returnType)
执行指定数据源上的 SQL 查询，返回映射为指定类型的结果列表。
|
<T> List<T> |
selectList(String dataSourceName,
String sql,
Class<T> returnType,
ParameterBinder parameterBinder)
使用预编译的方式在指定数据源上执行 SQL 查询，返回映射为指定类型的结果列表。
|
<T> T |
selectOne(String sql,
Class<T> returnType)
执行指定的 SQL 查询，返回映射为指定类型的单个结果。
|
<T> T |
selectOne(String sql,
Class<T> returnType,
ParameterBinder parameterBinder)
使用预编译的方式执行指定的 SQL 查询，返回映射为指定类型的单个结果。
|
<T> T |
selectOne(String dataSourceName,
String sql,
Class<T> returnType)
执行指定数据源上的 SQL 查询，返回映射为指定类型的单个结果。
|
<T> T |
selectOne(String dataSourceName,
String sql,
Class<T> returnType,
ParameterBinder parameterBinder)
使用预编译的方式在指定数据源上执行 SQL 查询，返回映射为指定类型的单个结果。
|
<T> int |
update(T entity,
Consumer<WhereCondition> condition)
根据指定条件更新实体对象的所有字段。
|
<T> int |
updateByPrimaryKey(T entity)
根据主键更新整个实体对象的所有字段。
|
<T> int |
updateSelective(T entity,
Collection<Fn<T,?>> forcedFields,
Consumer<WhereCondition> condition)
根据指定条件更新实体对象的非空字段，并强制更新指定的字段。
|
<T> int |
updateSelective(T entity,
Consumer<WhereCondition> condition)
根据指定条件更新实体对象的非空字段。
|
<T> int |
updateSelectiveByPrimaryKey(T entity)
根据主键更新实体对象中非空字段。
|
<T> int |
updateSelectiveByPrimaryKey(T entity,
Collection<Fn<T,?>> forcedFields)
根据主键更新实体对象中非空字段，并强制更新指定的字段。
|
<T> int |
upsert(T entity)
插入或更新实体对象的所有字段。
|
<T> int |
upsertMultiple(Collection<T> entities)
批量插入或更新实体对象的所有字段。
|
<T> int |
upsertSelective(T entity)
插入或更新实体（仅更新非空字段）。
|
<T> int |
upsertSelective(T entity,
Collection<Fn<T,?>> forcedFields)
插入或更新实体（仅更新非空字段），并强制更新指定字段。
|
public AbstractColumnReference select()
SqlContextAbstractColumnReference 对象，用于构建 SQL 查询操作
，并选择所需的列进行检索。select in interface SqlContextAbstractColumnReference 对象public <T> T selectByPrimaryKey(Class<T> entityClass, Object pkValue)
SqlContextselectByPrimaryKey in interface SqlContextT - 实体类的类型。entityClass - 实体类的 Class 对象，用于指定查询结果的映射类型。pkValue - 主键值，用于定位唯一的数据库记录。null。public <T> List<T> selectByPrimaryKey(Class<T> entityClass, Collection<?> pkValues)
SqlContextselectByPrimaryKey in interface SqlContextT - 实体类的类型。entityClass - 实体类的 Class 对象，用于指定查询结果的映射类型。pkValues - 主键值集合public <T> T selectOne(String sql, Class<T> returnType)
SqlContextselectOne in interface SqlContextT - 返回值的泛型类型。sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。null。public <T> T selectOne(String sql, Class<T> returnType, ParameterBinder parameterBinder)
SqlContextselectOne in interface SqlContextT - 返回值的泛型类型。sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。parameterBinder - 参数绑定器，用于绑定查询中的参数。null。public <T> T selectOne(String dataSourceName, String sql, Class<T> returnType)
SqlContextselectOne in interface SqlContextT - 返回值的泛型类型。dataSourceName - 数据源名称，未指定默认按照优先级匹配最佳数据源sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。null。public <T> T selectOne(String dataSourceName, String sql, Class<T> returnType, ParameterBinder parameterBinder)
SqlContext使用示例：
ParameterBinder parameterBinder = new ParameterBinder();
String value = SqlUtils.registerValueWithKey(parameterBinder, 1);
String sql = "SELECT x.user_id FROM .users x where x.user_id = %s";
sqlContext.selectOne("dataSource", String.format(sql, value), Integer.class, parameterBinder);
selectOne in interface SqlContextT - 返回值的泛型类型。dataSourceName - 数据源名称，未指定默认按照优先级匹配最佳数据源sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。parameterBinder - 参数绑定器，用于绑定查询中的参数。null。public <T> List<T> selectList(String sql, Class<T> returnType)
SqlContextselectList in interface SqlContextT - 返回值的泛型类型。sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。public <T> List<T> selectList(String sql, Class<T> returnType, ParameterBinder parameterBinder)
SqlContextselectList in interface SqlContextT - 返回值的泛型类型。sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。parameterBinder - 参数绑定器，用于绑定查询中的参数。public <T> List<T> selectList(String dataSourceName, String sql, Class<T> returnType)
SqlContextselectList in interface SqlContextT - 返回值的泛型类型。dataSourceName - 数据源名称，未指定默认按照优先级匹配最佳数据源sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。public <T> List<T> selectList(String dataSourceName, String sql, Class<T> returnType, ParameterBinder parameterBinder)
SqlContext使用示例：
ParameterBinder parameterBinder = new ParameterBinder();
String value = SqlUtils.registerValueWithKey(parameterBinder, 1);
String sql = "SELECT x.user_id FROM .users x where x.user_id >= %s";
sqlContext.selectList("dataSource", String.format(sql, value), Integer.class, parameterBinder);
selectList in interface SqlContextT - 返回值的泛型类型。dataSourceName - 数据源名称，未指定默认按照优先级匹配最佳数据源sql - 要执行的 SQL 查询语句。returnType - 结果映射的目标类型。parameterBinder - 参数绑定器，用于绑定查询中的参数。public <T> int insertSelective(T entity)
SqlContextinsertSelective in interface SqlContextT - 实体的类型，通常是一个数据模型类。entity - 要插入的实体对象，不能为空。public <T> int insertSelective(T entity,
Collection<Fn<T,?>> forcedFields)
SqlContextinsertSelective in interface SqlContextT - 实体的类型，通常是一个数据模型类。entity - 要插入的实体对象，不能为空。forcedFields - 强制插入的字段集合，可以为 null 或空集合。public <T> int insert(T entity)
SqlContextinsert in interface SqlContextT - 实体的类型，通常是一个数据模型类。entity - 要插入的实体对象，不能为空。public <T> int insertBatch(Collection<T> entities)
SqlContext使用批处理模式插入多个记录，更加稳定但执行时间相对较长。
insertBatch in interface SqlContextT - 实体的类型，一般为数据模型类。entities - 要插入的实体集合，不能为空。public <T> int insertMultiple(Collection<T> entities)
SqlContext
追加模式更高效，但可能有局限性；
比如 SQL 语句长度超出数据库限制，或部分数据库不支持此模式。
insertMultiple in interface SqlContextT - 实体的类型，一般为数据模型类。entities - 要插入的实体集合，不能为空。public <T> int deleteByPrimaryKey(Class<T> entityClass, Object pkValue)
SqlContextdeleteByPrimaryKey in interface SqlContextT - 实体类的类型。entityClass - 实体类，表示需要操作的表。pkValue - 主键值，指定要删除的记录。public <T> int deleteByPrimaryKey(Class<T> entityClass, Collection<?> pkValues)
SqlContextdeleteByPrimaryKey in interface SqlContextT - 实体类的类型。entityClass - 实体类，表示需要操作的表。pkValues - 主键值集合，指定要删除的多条记录。public <T> int delete(Class<T> entityClass, Consumer<WhereCondition> condition)
SqlContextdelete in interface SqlContextT - 实体类的类型。entityClass - 实体类，表示需要操作的表。condition - 条件构造器，使用 Consumer 定义删除条件。
如果传入 null，则删除整张表的所有数据。public <T> int updateByPrimaryKey(T entity)
SqlContextupdateByPrimaryKey in interface SqlContextT - 实体类的类型。entity - 包含主键和其他字段的实体对象，所有字段将被更新。public <T> int updateSelectiveByPrimaryKey(T entity)
SqlContextupdateSelectiveByPrimaryKey in interface SqlContextT - 实体类的类型。entity - 包含主键的实体对象，仅更新非空字段。public <T> int updateSelectiveByPrimaryKey(T entity,
Collection<Fn<T,?>> forcedFields)
SqlContextupdateSelectiveByPrimaryKey in interface SqlContextT - 实体类的类型。entity - 包含主键的实体对象，仅更新非空字段。forcedFields - 需要强制更新的字段，即使字段值为空也会更新。public <T> int update(T entity,
Consumer<WhereCondition> condition)
SqlContextupdate in interface SqlContextT - 实体类的类型。entity - 实体对象，表示需要更新的数据。condition - 条件构造器，使用 Consumer 定义更新条件，为null更新所有。public <T> int updateSelective(T entity,
Consumer<WhereCondition> condition)
SqlContextupdateSelective in interface SqlContextT - 实体类的类型。entity - 实体对象，仅更新非空字段。condition - 条件构造器，使用 Consumer 定义更新条件，为null更新所有。public <T> int updateSelective(T entity,
Collection<Fn<T,?>> forcedFields,
Consumer<WhereCondition> condition)
SqlContextupdateSelective in interface SqlContextT - 实体类的类型。entity - 实体对象，仅更新非空字段。forcedFields - 需要强制更新的字段，即使字段值为空也会更新。condition - 条件构造器，使用 Consumer 定义更新条件，为null更新所有。public <T> int upsert(T entity)
SqlContext如果记录不存在，则执行插入操作。 如果记录已存在，则更新所有字段。
upsert in interface SqlContextT - 实体类的类型。entity - 要插入或更新的实体对象。public <T> int upsertSelective(T entity)
SqlContext如果记录不存在，则执行插入操作。 如果记录已存在，则仅更新非空字段。
upsertSelective in interface SqlContextT - 实体类的类型。entity - 要插入或更新的实体对象。public <T> int upsertSelective(T entity,
Collection<Fn<T,?>> forcedFields)
SqlContext如果记录不存在，则执行插入操作。 如果记录已存在，则仅更新非空字段，并强制更新指定字段。
upsertSelective in interface SqlContextT - 实体类的类型。entity - 要插入或更新的实体对象。forcedFields - 需要强制更新的字段，即使字段值为空也会更新。public <T> int upsertMultiple(Collection<T> entities)
SqlContext对于每个实体： 如果记录不存在，则执行插入操作。 如果记录已存在，则更新所有字段。
upsertMultiple in interface SqlContextT - 实体类的类型。entities - 包含需要插入或更新的实体对象集合。Copyright © 2024 Dynamic-SQL. All rights reserved.