Db (hutool 5.8.36 API)

java.lang.Object
- cn.hutool.db.AbstractDb
- - cn.hutool.db.Db

All Implemented Interfaces:

Serializable
```
public class Db
extends AbstractDb
```
数据库操作类
通过给定的数据源执行给定SQL或者给定数据源和方言，执行相应的CRUD操作

Since:

4.1.2

Author:

Looly

See Also:

Serialized Form

Field Summary
- Fields inherited from class cn.hutool.db.AbstractDb
  caseInsensitive, ds, isSupportTransaction, runner

Constructor Summary

Constructors
Constructor and Description
`Db(DataSource ds)` 构造，从DataSource中识别方言
`Db(DataSource ds, Dialect dialect)` 构造
`Db(DataSource ds, String driverClassName)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`closeConnection(Connection conn)` 关闭连接自定义关闭连接有利于自定义回收连接机制，或者不关闭
`Db`	`disableWrapper()` 取消包装器取消自动添加到字段名、表名上的包装符（例如双引号）
`Connection`	`getConnection()` 获得链接。
`Db`	`setWrapper(Character wrapperChar)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`Db`	`setWrapper(Wrapper wrapper)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`Db`	`tx(TransactionLevel transactionLevel, VoidFunc1<Db> func)` 执行事务在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚
`Db`	`tx(VoidFunc1<Db> func)` 执行事务，使用默认的事务级别在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚
`static Db`	`use()` 创建Db 使用默认数据源，自动探测数据库连接池
`static Db`	`use(DataSource ds)` 创建Db 会根据数据源连接的元信息识别目标数据库类型，进而使用合适的数据源
`static Db`	`use(DataSource ds, Dialect dialect)` 创建Db
`static Db`	`use(DataSource ds, String driverClassName)` 创建Db
`static Db`	`use(String group)` 创建Db 使用默认数据源，自动探测数据库连接池

Methods inherited from class cn.hutool.db.AbstractDb
checkTransactionSupported, count, count, count, del, del, execute, executeBatch, executeBatch, executeBatch, executeBatch, executeForGeneratedKey, find, find, find, find, find, find, findAll, findAll, findAll, findBy, findBy, findLike, get, get, getDs, getRunner, insert, insert, insertForGeneratedKey, insertForGeneratedKeys, insertOrUpdate, page, page, page, page, page, page, page, page, page, page, page, page, pageForEntityList, pageForEntityList, query, query, query, query, query, query, queryNumber, queryOne, queryString, setCaseInsensitive, setRunner, update, upsert

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Db
```
public Db(DataSource ds)
```
    构造，从DataSource中识别方言
    
    Parameters:
    
    ds - 数据源
  - Db
```
public Db(DataSource ds,
          String driverClassName)
```
    构造
    
    Parameters:
    
    ds - 数据源
    
    driverClassName - 数据库连接驱动类名，用于识别方言
  - Db
```
public Db(DataSource ds,
          Dialect dialect)
```
    构造
    
    Parameters:
    
    ds - 数据源
    
    dialect - 方言
- Method Detail
  - use
```
public static Db use()
```
    创建Db
    使用默认数据源，自动探测数据库连接池
    
    Returns:
    
    Db
  - use
```
public static Db use(String group)
```
    创建Db
    使用默认数据源，自动探测数据库连接池
    
    Parameters:
    
    group - 数据源分组
    
    Returns:
    
    Db
  - use
```
public static Db use(DataSource ds)
```
    创建Db
    会根据数据源连接的元信息识别目标数据库类型，进而使用合适的数据源
    
    Parameters:
    
    ds - 数据源
    
    Returns:
    
    Db
  - use
```
public static Db use(DataSource ds,
                     Dialect dialect)
```
    创建Db
    
    Parameters:
    
    ds - 数据源
    
    dialect - 方言
    
    Returns:
    
    Db
  - use
```
public static Db use(DataSource ds,
                     String driverClassName)
```
    创建Db
    
    Parameters:
    
    ds - 数据源
    
    driverClassName - 数据库连接驱动类名
    
    Returns:
    
    Db
  - setWrapper
```
public Db setWrapper(Character wrapperChar)
```
    Description copied from class: AbstractDb
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    Overrides:
    
    setWrapper in class AbstractDb
    
    Parameters:
    
    wrapperChar - 包装字符，字符会在SQL生成时位于表名和字段名两边，null时表示取消包装
    
    Returns:
    
    this
  - setWrapper
```
public Db setWrapper(Wrapper wrapper)
```
    Description copied from class: AbstractDb
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    Overrides:
    
    setWrapper in class AbstractDb
    
    Parameters:
    
    wrapper - 包装器，null表示取消包装
    
    Returns:
    
    this
  - disableWrapper
```
public Db disableWrapper()
```
    Description copied from class: AbstractDb
    
    取消包装器
    取消自动添加到字段名、表名上的包装符（例如双引号）
    
    Overrides:
    
    disableWrapper in class AbstractDb
    
    Returns:
    
    this
  - getConnection
```
public Connection getConnection()
                         throws SQLException
```
    Description copied from class: AbstractDb
    
    获得链接。根据实现不同，可以自定义获取连接的方式
    
    Specified by:
    
    getConnection in class AbstractDb
    
    Returns:
    
    Connection
    
    Throws:
    
    SQLException - 连接获取异常
  - closeConnection
```
public void closeConnection(Connection conn)
```
    Description copied from class: AbstractDb
    
    关闭连接
    自定义关闭连接有利于自定义回收连接机制，或者不关闭
    
    Specified by:
    
    closeConnection in class AbstractDb
    
    Parameters:
    
    conn - 连接 Connection
  - tx
```
public Db tx(VoidFunc1<Db> func)
      throws SQLException
```
    执行事务，使用默认的事务级别
    在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚
    
    Parameters:
    
    func - 事务函数，所有操作应在同一函数下执行，确保在同一事务中
    
    Returns:
    
    this
    
    Throws:
    
    SQLException - SQL异常
  - tx
```
public Db tx(TransactionLevel transactionLevel,
             VoidFunc1<Db> func)
      throws SQLException
```
    执行事务
    在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚
    
    Parameters:
    
    transactionLevel - 事务级别枚举，null表示使用JDBC默认事务
    
    func - 事务函数，所有操作应在同一函数下执行，确保在同一事务中
    
    Returns:
    
    this
    
    Throws:
    
    SQLException - SQL异常

Class Db

Field Summary

Fields inherited from class cn.hutool.db.AbstractDb

Constructor Summary

Method Summary

Methods inherited from class cn.hutool.db.AbstractDb

Methods inherited from class java.lang.Object

Constructor Detail

Db

Db

Db

Method Detail

use

use

use

use

use

setWrapper

setWrapper

disableWrapper

getConnection

closeConnection

tx

tx