cn.hutool.db

类 Db

java.lang.Object

cn.hutool.db.AbstractDb

cn.hutool.db.Db

所有已实现的接口:

Serializable

public class Db
extends AbstractDb

数据库操作类
通过给定的数据源执行给定SQL或者给定数据源和方言，执行相应的CRUD操作

从以下版本开始:

4.1.2

作者:

Looly

另请参阅:

序列化表格

字段概要

从类继承的字段 cn.hutool.db.AbstractDb

ds, isSupportTransaction, runner

构造器概要

构造器

构造器和说明
Db(DataSource ds) 构造，从DataSource中识别方言
Db(DataSource ds, Dialect dialect) 构造
Db(DataSource ds, String driverClassName) 构造

方法概要

方法

限定符和类型	方法和说明
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 使用默认数据源，自动探测数据库连接池

从类继承的方法 cn.hutool.db.AbstractDb

checkTransactionSupported, count, del, del, execute, executeBatch, executeBatch, executeForGeneratedKey, find, find, find, find, find, find, findAll, findAll, findAll, findBy, findBy, findLike, get, get, getRunner, insert, insert, insertForGeneratedKey, insertForGeneratedKeys, insertOrUpdate, page, page, page, page, page, page, page, page, pageForEntityList, pageForEntityList, query, query, query, queryNumber, queryOne, queryString, setRunner, update

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

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

构造器详细资料

Db

public Db(DataSource ds)

构造，从DataSource中识别方言

参数:

ds - 数据源

Db

public Db(DataSource ds,
  String driverClassName)

构造

参数:

ds - 数据源

driverClassName - 数据库连接驱动类名，用于识别方言

Db

public Db(DataSource ds,
  Dialect dialect)

构造

参数:

ds - 数据源

dialect - 方言

方法详细资料

use

public static Db use()

创建Db
使用默认数据源，自动探测数据库连接池

返回:

Db

use

public static Db use(String group)

创建Db
使用默认数据源，自动探测数据库连接池

参数:

group - 数据源分组

返回:

Db

use

public static Db use(DataSource ds)

创建Db
会根据数据源连接的元信息识别目标数据库类型，进而使用合适的数据源

参数:

ds - 数据源

返回:

Db

use

public static Db use(DataSource ds,
     Dialect dialect)

创建Db

参数:

ds - 数据源

dialect - 方言

返回:

Db

use

public static Db use(DataSource ds,
     String driverClassName)

创建Db

参数:

ds - 数据源

driverClassName - 数据库连接驱动类名

返回:

Db

setWrapper

public Db setWrapper(Character wrapperChar)

从类复制的说明: AbstractDb

设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突

覆盖:

setWrapper 在类中 AbstractDb

参数:

wrapperChar - 包装字符，字符会在SQL生成时位于表名和字段名两边，null时表示取消包装

返回:

this

setWrapper

public Db setWrapper(Wrapper wrapper)

从类复制的说明: AbstractDb

设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突

覆盖:

setWrapper 在类中 AbstractDb

参数:

wrapper - 包装器，null表示取消包装

返回:

this

disableWrapper

public Db disableWrapper()

从类复制的说明: AbstractDb

取消包装器
取消自动添加到字段名、表名上的包装符（例如双引号）

覆盖:

disableWrapper 在类中 AbstractDb

返回:

this

getConnection

public Connection getConnection()
                         throws SQLException

从类复制的说明: AbstractDb

获得链接。根据实现不同，可以自定义获取连接的方式

指定者:

getConnection 在类中 AbstractDb

返回:

Connection

抛出:

SQLException - 连接获取异常

closeConnection

public void closeConnection(Connection conn)

从类复制的说明: AbstractDb

关闭连接
自定义关闭连接有利于自定义回收连接机制，或者不关闭

指定者:

closeConnection 在类中 AbstractDb

参数:

conn - 连接 Connection

tx

public Db tx(VoidFunc1<Db> func)
      throws SQLException

执行事务，使用默认的事务级别
在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚

参数:

func - 事务函数，所有操作应在同一函数下执行，确保在同一事务中

返回:

this

抛出:

SQLException - SQL异常

tx

public Db tx(TransactionLevel transactionLevel,
    VoidFunc1<Db> func)
      throws SQLException

执行事务
在同一事务中，所有对数据库操作都是原子的，同时提交或者同时回滚

参数:

transactionLevel - 事务级别枚举，null表示使用JDBC默认事务

func - 事务函数，所有操作应在同一函数下执行，确保在同一事务中

返回:

this

抛出:

SQLException - SQL异常