AbstractDb (hutool-db 6.0.0-M14 API)

java.lang.Object
- org.dromara.hutool.db.DefaultConnectionHolder
- - org.dromara.hutool.db.AbstractDb<R>

类型参数:

R - return this类型

所有已实现的接口:

Serializable, ConnectionHolder

直接已知子类:

Db, Session
```
public abstract class AbstractDb<R extends AbstractDb<R>>
extends DefaultConnectionHolder
implements Serializable
```
抽象数据库操作类
通过给定的数据源执行给定SQL或者给定数据源和方言，执行相应的CRUD操作
提供抽象方法getConnection和closeConnection，用于自定义数据库连接的打开和关闭

作者:

looly

另请参阅:

序列化表格

字段概要

字段
限定符和类型	字段和说明
`protected boolean`	`caseInsensitive` 是否大小写不敏感（默认大小写不敏感）
`protected DbConfig`	`dbConfig`
`protected Boolean`	`isSupportTransaction` 是否支持事务
`protected DialectRunner`	`runner`

从类继承的字段 org.dromara.hutool.db.DefaultConnectionHolder
ds

构造器概要

构造器
构造器和说明

AbstractDb(DataSource ds, Dialect dialect)
构造

构造器
构造器和说明
`AbstractDb(DataSource ds, Dialect dialect)` 构造

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`protected void`	`checkTransactionSupported(Connection conn)` 检查数据库是否支持事务，此项检查同一个数据源只检查一次，如果不支持抛出DbRuntimeException异常
`long`	`count(CharSequence selectSql, Object... params)` 结果的条目数
`long`	`count(Entity where)` 结果的条目数
`long`	`count(SqlBuilder sql)` 结果的条目数
`int`	`del(Entity where)` 删除数据
`int`	`del(String tableName, String field, Object value)` 删除数据
`R`	`disableWrapper()` 取消包装器取消自动添加到字段名、表名上的包装符（例如双引号）
`int`	`execute(String sql, Object... params)` 执行非查询语句语句包括插入、更新、删除
`int[]`	`executeBatch(Iterable<String> sqls)` 批量执行非查询语句
`int[]`	`executeBatch(String... sqls)` 批量执行非查询语句
`int[]`	`executeBatch(String sql, Iterable<Object[]> paramsBatch)` 批量执行非查询语句
`Long`	`executeForGeneratedKey(String sql, Object... params)` 执行非查询语句语句包括插入、更新、删除
`List<Entity>`	`find(Collection<String> fields, Entity where)` 查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`find(Collection<String> fields, Entity where, RsHandler<T> rsh)` 查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`List<Entity>`	`find(Entity where)` 查询数据列表，返回字段由where参数指定查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> List<T>`	`find(Entity where, Class<T> beanClass)` 查询数据列表，返回字段由where参数指定查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`find(Entity where, RsHandler<T> rsh, String... fields)` 查询，返回所有字段查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`find(Query query, RsHandler<T> rsh)` 查询 Query为查询所需数据的一个实体类，此对象中可以定义返回字段、查询条件，查询的表、分页等信息
`List<Entity>`	`findAll(Entity where)` 查询数据列表，返回所有字段查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> List<T>`	`findAll(Entity where, Class<T> beanClass)` 查询数据列表，返回所有字段查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`List<Entity>`	`findAll(String tableName)` 查询数据列表，返回所有字段
`List<Entity>`	`findBy(String tableName, Condition... wheres)` 根据多个条件查询数据列表，返回所有字段
`List<Entity>`	`findBy(String tableName, String field, Object value)` 根据某个字段名条件查询数据列表，返回所有字段
`List<Entity>`	`findLike(String tableName, String field, String value, Condition.LikeType likeType)` 根据某个字段名条件查询数据列表，返回所有字段
`Entity`	`get(Entity where)` 根据条件实体查询单个记录，当有多条返回时，只显示查询到的第一条
`<T> Entity`	`get(String tableName, String field, T value)` 根据某个字段（最好是唯一字段）查询单个记录当有多条返回时，只显示查询到的第一条
`DialectRunner`	`getRunner()` 获取`DialectRunner`
`int[]`	`insert(Collection<Entity> records)` 批量插入数据需要注意的是，批量插入每一条数据结构必须一致。
`int`	`insert(Entity record)` 插入数据
`Long`	`insertForGeneratedKey(Entity record)` 插入数据
`List<Object>`	`insertForGeneratedKeys(Entity record)` 插入数据
`int`	`insertOrUpdate(Entity record, String... keys)` 插入或更新数据根据给定的字段名查询数据，如果存在则更新这些数据，否则执行插入
`PageResult<Entity>`	`page(CharSequence sql, Page page, Object... params)` 分页查询
`<T> T`	`page(CharSequence sql, Page page, RsHandler<T> rsh, Object... params)` 分页查询
`PageResult<Entity>`	`page(Collection<String> fields, Entity where, int pageNumber, int pageSize)` 分页查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`PageResult<Entity>`	`page(Collection<String> fields, Entity where, Page page)` 分页查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`page(Collection<String> fields, Entity where, Page page, RsHandler<T> rsh)` 分页查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`PageResult<Entity>`	`page(Entity where, Page page)` 分页查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`page(Entity where, Page page, RsHandler<T> rsh)` 分页查询查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`page(SqlBuilder sql, Page page, RsHandler<T> rsh)` 分页查询
`<T> List<T>`	`pageForBeanList(CharSequence sql, Page page, Class<T> elementBeanType, Object... params)` 分页查询，结果为Bean列表，不计算总数
`<T> PageResult<T>`	`pageForBeanResult(CharSequence sql, Page page, Class<T> elementBeanType, Object... params)` 分页查询，结果为Bean列表，不计算总数
`List<Entity>`	`pageForEntityList(Entity where, Page page)` 分页查询，结果为Entity列表，不计算总数查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`<T> T`	`query(SerFunction<Connection,PreparedStatement> statementFunc, RsHandler<T> rsh)` 执行自定义的`PreparedStatement`，结果使用`RsHandler`处理此方法主要用于自定义场景，如游标查询等
`<T> List<T>`	`query(String sql, Class<T> beanClass, Object... params)` 查询
`List<Entity>`	`query(String sql, Map<String,Object> params)` 查询
`List<Entity>`	`query(String sql, Object... params)` 查询
`<T> T`	`query(String sql, RsHandler<T> rsh, Map<String,Object> paramMap)` 支持占位符的查询，例如：select * from table where field1=:name1
`<T> T`	`query(String sql, RsHandler<T> rsh, Object... params)` 查询
`Number`	`queryNumber(String sql, Object... params)` 查询单条单个字段记录,并将其转换为Number
`Entity`	`queryOne(String sql, Object... params)` 查询单条记录
`String`	`queryString(String sql, Object... params)` 查询单条单个字段记录,并将其转换为String
`R`	`setCaseInsensitive(boolean caseInsensitive)` 设置是否在结果中忽略大小写如果忽略，则在Entity中调用getXXX时，字段值忽略大小写，默认忽略
`R`	`setRunner(DialectRunner runner)` 设置 `DialectRunner`
`R`	`setWrapper(Character wrapperChar)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`R`	`setWrapper(QuoteWrapper quoteWrapper)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`int`	`update(Entity record, Entity where)` 更新数据更新条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
`int`	`upsert(Entity record, String... keys)` 使用upsert语义插入或更新数据根据给定的字段名查询数据，如果存在则更新这些数据，否则执行插入如果方言未实现本方法，内部会自动调用insertOrUpdate来实现功能，由于upsert和insert使用有区别，为了兼容性保留原有insertOrUpdate不做变动

从类继承的方法 org.dromara.hutool.db.DefaultConnectionHolder
closeConnection, getConnection

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - isSupportTransaction
```
protected Boolean isSupportTransaction
```
    是否支持事务
  - runner
```
protected DialectRunner runner
```
  - dbConfig
```
protected DbConfig dbConfig
```
  - caseInsensitive
```
protected boolean caseInsensitive
```
    是否大小写不敏感（默认大小写不敏感）
- 构造器详细资料
  - AbstractDb
```
public AbstractDb(DataSource ds,
                  Dialect dialect)
```
    构造
    
    参数:
    
    ds - 数据源
    
    dialect - 数据库方言
- 方法详细资料
  - query
```
public List<Entity> query(String sql,
                          Map<String,Object> params)
                   throws DbException
```
    查询
    
    参数:
    
    sql - 查询语句
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.1.1
  - query
```
public List<Entity> query(String sql,
                          Object... params)
                   throws DbException
```
    查询
    
    参数:
    
    sql - 查询语句
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.1.1
  - query
```
public <T> List<T> query(String sql,
                         Class<T> beanClass,
                         Object... params)
                  throws DbException
```
    查询
    
    类型参数:
    
    T - 结果集需要处理的对象类型
    
    参数:
    
    sql - 查询语句
    
    beanClass - 元素Bean类型
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.2
  - queryOne
```
public Entity queryOne(String sql,
                       Object... params)
                throws DbException
```
    查询单条记录
    
    参数:
    
    sql - 查询语句
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - queryNumber
```
public Number queryNumber(String sql,
                          Object... params)
                   throws DbException
```
    查询单条单个字段记录,并将其转换为Number
    
    参数:
    
    sql - 查询语句
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - queryString
```
public String queryString(String sql,
                          Object... params)
                   throws DbException
```
    查询单条单个字段记录,并将其转换为String
    
    参数:
    
    sql - 查询语句
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - query
```
public <T> T query(String sql,
                   RsHandler<T> rsh,
                   Object... params)
            throws DbException
```
    查询
    
    类型参数:
    
    T - 结果集需要处理的对象类型
    
    参数:
    
    sql - 查询语句
    
    rsh - 结果集处理对象
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - query
```
public <T> T query(String sql,
                   RsHandler<T> rsh,
                   Map<String,Object> paramMap)
            throws DbException
```
    支持占位符的查询，例如：select * from table where field1=:name1
    
    类型参数:
    
    T - 结果集需要处理的对象类型
    
    参数:
    
    sql - 查询语句，使用参数名占位符，例如:name
    
    rsh - 结果集处理对象
    
    paramMap - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.2.2
  - query
```
public <T> T query(SerFunction<Connection,PreparedStatement> statementFunc,
                   RsHandler<T> rsh)
            throws DbException
```
    执行自定义的PreparedStatement，结果使用RsHandler处理
    此方法主要用于自定义场景，如游标查询等
    
    类型参数:
    
    T - 结果集需要处理的对象类型
    
    参数:
    
    statementFunc - 自定义PreparedStatement创建函数
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.7.17
  - execute
```
public int execute(String sql,
                   Object... params)
            throws DbException
```
    执行非查询语句
    语句包括插入、更新、删除
    
    参数:
    
    sql - SQL
    
    params - 参数
    
    返回:
    
    影响行数
    
    抛出:
    
    DbException - SQL执行异常
  - executeForGeneratedKey
```
public Long executeForGeneratedKey(String sql,
                                   Object... params)
                            throws DbException
```
    执行非查询语句
    语句包括插入、更新、删除
    
    参数:
    
    sql - SQL
    
    params - 参数
    
    返回:
    
    主键
    
    抛出:
    
    DbException - SQL执行异常
  - executeBatch
```
public int[] executeBatch(String sql,
                          Iterable<Object[]> paramsBatch)
                   throws DbException
```
    批量执行非查询语句
    
    参数:
    
    sql - SQL
    
    paramsBatch - 批量的参数
    
    返回:
    
    每个SQL执行影响的行数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.4.2
  - executeBatch
```
public int[] executeBatch(String... sqls)
                   throws DbException
```
    批量执行非查询语句
    
    参数:
    
    sqls - SQL列表
    
    返回:
    
    每个SQL执行影响的行数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    4.5.6
  - executeBatch
```
public int[] executeBatch(Iterable<String> sqls)
                   throws DbException
```
    批量执行非查询语句
    
    参数:
    
    sqls - SQL列表
    
    返回:
    
    每个SQL执行影响的行数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.4.2
  - insert
```
public int insert(Entity record)
           throws DbException
```
    插入数据
    
    参数:
    
    record - 记录
    
    返回:
    
    插入行数
    
    抛出:
    
    DbException - SQL执行异常
  - insertOrUpdate
```
public int insertOrUpdate(Entity record,
                          String... keys)
                   throws DbException
```
    插入或更新数据
    根据给定的字段名查询数据，如果存在则更新这些数据，否则执行插入
    
    参数:
    
    record - 记录
    
    keys - 需要检查唯一性的字段
    
    返回:
    
    插入行数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    4.0.10
  - upsert
```
public int upsert(Entity record,
                  String... keys)
           throws DbException
```
    使用upsert语义插入或更新数据
    根据给定的字段名查询数据，如果存在则更新这些数据，否则执行插入如果方言未实现本方法，内部会自动调用insertOrUpdate来实现功能，由于upsert和insert使用有区别，为了兼容性保留原有insertOrUpdate不做变动
    
    参数:
    
    record - 记录
    
    keys - 需要检查唯一性的字段
    
    返回:
    
    插入行数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.7.21
  - insert
```
public int[] insert(Collection<Entity> records)
             throws DbException
```
    批量插入数据
    需要注意的是，批量插入每一条数据结构必须一致。批量插入数据时会获取第一条数据的字段结构，之后的数据会按照这个格式插入。
    也就是说假如第一条数据只有2个字段，后边数据多于这两个字段的部分将被抛弃。
    
    参数:
    
    records - 记录列表
    
    返回:
    
    插入行数
    
    抛出:
    
    DbException - SQL执行异常
  - insertForGeneratedKeys
```
public List<Object> insertForGeneratedKeys(Entity record)
                                    throws DbException
```
    插入数据
    
    参数:
    
    record - 记录
    
    返回:
    
    主键列表
    
    抛出:
    
    DbException - SQL执行异常
  - insertForGeneratedKey
```
public Long insertForGeneratedKey(Entity record)
                           throws DbException
```
    插入数据
    
    参数:
    
    record - 记录
    
    返回:
    
    主键
    
    抛出:
    
    DbException - SQL执行异常
  - del
```
public int del(String tableName,
               String field,
               Object value)
        throws DbException
```
    删除数据
    
    参数:
    
    tableName - 表名
    
    field - 字段名，最好是主键
    
    value - 值，值可以是列表或数组，被当作IN查询处理
    
    返回:
    
    删除行数
    
    抛出:
    
    DbException - SQL执行异常
  - del
```
public int del(Entity where)
        throws DbException
```
    删除数据
    
    参数:
    
    where - 条件
    
    返回:
    
    影响行数
    
    抛出:
    
    DbException - SQL执行异常
  - update
```
public int update(Entity record,
                  Entity where)
           throws DbException
```
    更新数据
    更新条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    record - 记录
    
    where - 条件
    
    返回:
    
    影响行数
    
    抛出:
    
    DbException - SQL执行异常
  - get
```
public <T> Entity get(String tableName,
                      String field,
                      T value)
               throws DbException
```
    根据某个字段（最好是唯一字段）查询单个记录
    当有多条返回时，只显示查询到的第一条
    
    类型参数:
    
    T - 字段值类型
    
    参数:
    
    tableName - 表名
    
    field - 字段名
    
    value - 字段值
    
    返回:
    
    记录
    
    抛出:
    
    DbException - SQL执行异常
  - get
```
public Entity get(Entity where)
           throws DbException
```
    根据条件实体查询单个记录，当有多条返回时，只显示查询到的第一条
    
    参数:
    
    where - 条件
    
    返回:
    
    记录
    
    抛出:
    
    DbException - SQL执行异常
  - find
```
public <T> T find(Collection<String> fields,
                  Entity where,
                  RsHandler<T> rsh)
           throws DbException
```
    查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - 需要处理成的结果对象类型
    
    参数:
    
    fields - 返回的字段列表，null则返回所有字段
    
    where - 条件实体类（包含表名）
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - find
```
public List<Entity> find(Collection<String> fields,
                         Entity where)
                  throws DbException
```
    查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    fields - 返回的字段列表，null则返回所有字段
    
    where - 条件实体类（包含表名）
    
    返回:
    
    结果Entity列表
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    4.5.16
  - find
```
public <T> T find(Query query,
                  RsHandler<T> rsh)
           throws DbException
```
    查询
    Query为查询所需数据的一个实体类，此对象中可以定义返回字段、查询条件，查询的表、分页等信息
    
    类型参数:
    
    T - 需要处理成的结果对象类型
    
    参数:
    
    query - Query对象，此对象中可以定义返回字段、查询条件，查询的表、分页等信息
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    4.0.0
  - find
```
public <T> T find(Entity where,
                  RsHandler<T> rsh,
                  String... fields)
           throws DbException
```
    查询，返回所有字段
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - 需要处理成的结果对象类型
    
    参数:
    
    where - 条件实体类（包含表名）
    
    rsh - 结果集处理对象
    
    fields - 字段列表，可变长参数如果无值表示查询全部字段
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - find
```
public List<Entity> find(Entity where)
                  throws DbException
```
    查询数据列表，返回字段由where参数指定
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    where - 条件实体类（包含表名）
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.1
  - find
```
public <T> List<T> find(Entity where,
                        Class<T> beanClass)
                 throws DbException
```
    查询数据列表，返回字段由where参数指定
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    where - 条件实体类（包含表名）
    
    beanClass - Bean类
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.2
  - findAll
```
public List<Entity> findAll(Entity where)
                     throws DbException
```
    查询数据列表，返回所有字段
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    where - 条件实体类（包含表名）
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
  - findAll
```
public <T> List<T> findAll(Entity where,
                           Class<T> beanClass)
                    throws DbException
```
    查询数据列表，返回所有字段
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    where - 条件实体类（包含表名）
    
    beanClass - 返回的对象类型
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.2
  - findAll
```
public List<Entity> findAll(String tableName)
                     throws DbException
```
    查询数据列表，返回所有字段
    
    参数:
    
    tableName - 表名
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
  - findBy
```
public List<Entity> findBy(String tableName,
                           String field,
                           Object value)
                    throws DbException
```
    根据某个字段名条件查询数据列表，返回所有字段
    
    参数:
    
    tableName - 表名
    
    field - 字段名
    
    value - 字段值
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
  - findBy
```
public List<Entity> findBy(String tableName,
                           Condition... wheres)
                    throws DbException
```
    根据多个条件查询数据列表，返回所有字段
    
    参数:
    
    tableName - 表名
    
    wheres - 条件，多个条件的连接逻辑使用Condition.setLinkOperator(LogicalOperator) 定义
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    4.0.0
  - findLike
```
public List<Entity> findLike(String tableName,
                             String field,
                             String value,
                             Condition.LikeType likeType)
                      throws DbException
```
    根据某个字段名条件查询数据列表，返回所有字段
    
    参数:
    
    tableName - 表名
    
    field - 字段名
    
    value - 字段值
    
    likeType - Condition.LikeType
    
    返回:
    
    数据对象列表
    
    抛出:
    
    DbException - SQL执行异常
  - count
```
public long count(Entity where)
           throws DbException
```
    结果的条目数
    
    参数:
    
    where - 查询条件
    
    返回:
    
    复合条件的结果数
    
    抛出:
    
    DbException - SQL执行异常
  - count
```
public long count(SqlBuilder sql)
           throws DbException
```
    结果的条目数
    
    参数:
    
    sql - sql构造器
    
    返回:
    
    复合条件的结果数
    
    抛出:
    
    DbException - SQL执行异常
  - count
```
public long count(CharSequence selectSql,
                  Object... params)
           throws DbException
```
    结果的条目数
    
    参数:
    
    selectSql - 查询SQL语句
    
    params - 查询参数
    
    返回:
    
    复合条件的结果数
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.6.6
  - pageForBeanResult
```
public <T> PageResult<T> pageForBeanResult(CharSequence sql,
                                           Page page,
                                           Class<T> elementBeanType,
                                           Object... params)
```
    分页查询，结果为Bean列表，不计算总数
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    sql - SQL构建器，可以使用SqlBuilder.of(CharSequence) 包装普通SQL
    
    page - 分页对象
    
    elementBeanType - 结果集处理对象
    
    params - 参数
    
    返回:
    
    结果对象
  - pageForBeanList
```
public <T> List<T> pageForBeanList(CharSequence sql,
                                   Page page,
                                   Class<T> elementBeanType,
                                   Object... params)
```
    分页查询，结果为Bean列表，不计算总数
    
    类型参数:
    
    T - Bean类型
    
    参数:
    
    sql - SQL构建器，可以使用SqlBuilder.of(CharSequence) 包装普通SQL
    
    page - 分页对象
    
    elementBeanType - 结果集处理对象
    
    params - 参数
    
    返回:
    
    结果对象
  - pageForEntityList
```
public List<Entity> pageForEntityList(Entity where,
                                      Page page)
                               throws DbException
```
    分页查询，结果为Entity列表，不计算总数
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    where - 条件实体类（包含表名）
    
    page - 分页对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.2
  - page
```
public <T> T page(Entity where,
                  Page page,
                  RsHandler<T> rsh)
           throws DbException
```
    分页查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - 结果对象类型
    
    参数:
    
    where - 条件实体类（包含表名）
    
    page - 分页对象
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    3.2.2
  - page
```
public <T> T page(Collection<String> fields,
                  Entity where,
                  Page page,
                  RsHandler<T> rsh)
           throws DbException
```
    分页查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    类型参数:
    
    T - 结果对象类型
    
    参数:
    
    fields - 返回的字段列表，null则返回所有字段
    
    where - 条件实体类（包含表名）
    
    page - 分页对象
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - page
```
public <T> T page(CharSequence sql,
                  Page page,
                  RsHandler<T> rsh,
                  Object... params)
           throws DbException
```
    分页查询
    
    类型参数:
    
    T - 结果对象类型
    
    参数:
    
    sql - SQL构建器，可以使用SqlBuilder.of(CharSequence) 包装普通SQL
    
    page - 分页对象
    
    rsh - 结果集处理对象
    
    params - 参数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.6.6
  - page
```
public <T> T page(SqlBuilder sql,
                  Page page,
                  RsHandler<T> rsh)
           throws DbException
```
    分页查询
    
    类型参数:
    
    T - 处理结果类型，可以将ResultSet转换为给定类型
    
    参数:
    
    sql - SQL构建器
    
    page - 分页对象
    
    rsh - 结果集处理对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - page
```
public PageResult<Entity> page(CharSequence sql,
                               Page page,
                               Object... params)
                        throws DbException
```
    分页查询
    
    参数:
    
    sql - SQL语句字符串
    
    page - 分页对象
    
    params - 参数列表
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
    
    从以下版本开始:
    
    5.5.3
  - page
```
public PageResult<Entity> page(Collection<String> fields,
                               Entity where,
                               int pageNumber,
                               int pageSize)
                        throws DbException
```
    分页查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    fields - 返回的字段列表，null则返回所有字段
    
    where - 条件实体类（包含表名）
    
    pageNumber - 页码
    
    pageSize - 每页结果数
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - page
```
public PageResult<Entity> page(Collection<String> fields,
                               Entity where,
                               Page page)
                        throws DbException
```
    分页查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    fields - 返回的字段列表，null则返回所有字段
    
    where - 条件实体类（包含表名）
    
    page - 分页对象
    
    返回:
    
    结果对象
    
    抛出:
    
    DbException - SQL执行异常
  - page
```
public PageResult<Entity> page(Entity where,
                               Page page)
                        throws DbException
```
    分页查询
    查询条件为多个key value对表示，默认key = value，如果使用其它条件可以使用：where.put("key", " > 1")，value也可以传Condition对象，key被忽略
    
    参数:
    
    where - 条件实体类（包含表名）
    
    page - 分页对象
    
    返回:
    
    分页结果集
    
    抛出:
    
    DbException - SQL执行异常
  - setCaseInsensitive
```
public R setCaseInsensitive(boolean caseInsensitive)
```
    设置是否在结果中忽略大小写
    如果忽略，则在Entity中调用getXXX时，字段值忽略大小写，默认忽略
    
    参数:
    
    caseInsensitive - 否在结果中忽略大小写
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.2.4
  - getRunner
```
public DialectRunner getRunner()
```
    获取DialectRunner
    
    返回:
    
    DialectRunner
  - setRunner
```
public R setRunner(DialectRunner runner)
```
    设置 DialectRunner
    
    参数:
    
    runner - DialectRunner
    
    返回:
    
    this
  - setWrapper
```
public R setWrapper(Character wrapperChar)
```
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    参数:
    
    wrapperChar - 包装字符，字符会在SQL生成时位于表名和字段名两边，null时表示取消包装
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.0.0
  - setWrapper
```
public R setWrapper(QuoteWrapper quoteWrapper)
```
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    参数:
    
    quoteWrapper - 包装器，null表示取消包装
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.0.0
  - disableWrapper
```
public R disableWrapper()
```
    取消包装器
    取消自动添加到字段名、表名上的包装符（例如双引号）
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.5.7
  - checkTransactionSupported
```
protected void checkTransactionSupported(Connection conn)
                                  throws DbException
```
    检查数据库是否支持事务，此项检查同一个数据源只检查一次，如果不支持抛出DbRuntimeException异常
    
    参数:
    
    conn - Connection
    
    抛出:
    
    DbException - 获取元数据信息失败
    
    DbException - 不支持事务

类 AbstractDb<R extends AbstractDb<R>>

字段概要

从类继承的字段 org.dromara.hutool.db.DefaultConnectionHolder

构造器概要

方法概要

从类继承的方法 org.dromara.hutool.db.DefaultConnectionHolder

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

字段详细资料

isSupportTransaction

runner

dbConfig

caseInsensitive

构造器详细资料

AbstractDb

方法详细资料

query

query

query

queryOne

queryNumber

queryString

query

query

query

execute

executeForGeneratedKey

executeBatch

executeBatch

executeBatch

insert

insertOrUpdate

upsert

insert

insertForGeneratedKeys

insertForGeneratedKey

del

del

update

get

get

find

find

find

find

find

find

findAll

findAll

findAll

findBy

findBy

findLike

count

count

count

pageForBeanResult

pageForBeanList

pageForEntityList

page

page

page

page

page

page

page

page

setCaseInsensitive

getRunner

setRunner

setWrapper

setWrapper

disableWrapper

checkTransactionSupported