Session (hutool-db 4.6.0 API)

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

所有已实现的接口:

Closeable, Serializable, AutoCloseable
```
public class Session
extends AbstractDb
implements Closeable
```
数据库SQL执行会话
会话通过共用Connection而可以实现JDBC事务
一个会话只维护一个连接，推荐在执行完后关闭Session，避免重用
本对象并不是线程安全的，多个线程共用一个Session将会导致不可预知的问题

作者:

loolly

另请参阅:
序列化表格

字段概要
- 从类继承的字段 cn.hutool.db.AbstractDb
  ds, isSupportTransaction, runner

构造器概要

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

方法概要

方法
限定符和类型	方法和说明
`void`	`beginTransaction()` 开始事务
`void`	`close()`
`void`	`closeConnection(Connection conn)` 关闭连接自定义关闭连接有利于自定义回收连接机制，或者不关闭
`void`	`commit()` 提交事务
`static Session`	`create()` 创建默认数据源会话
`static Session`	`create(DataSource ds)` 创建会话
`static Session`	`create(String group)` 创建会话
`Session`	`disableWrapper()` 取消包装器取消自动添加到字段名、表名上的包装符（例如双引号）
`Connection`	`getConnection()` 获得链接。
`SqlConnRunner`	`getRunner()` 获得`SqlConnRunner`
`void`	`quietRollback()` 静默回滚事务回滚事务
`void`	`quietRollback(Savepoint savepoint)` 静默回滚到某个保存点，保存点的设置请使用setSavepoint方法
`void`	`rollback()` 回滚事务
`void`	`rollback(Savepoint savepoint)` 回滚到某个保存点，保存点的设置请使用setSavepoint方法
`Savepoint`	`setSavepoint()` 设置保存点
`Savepoint`	`setSavepoint(String name)` 设置保存点
`void`	`setTransactionIsolation(int level)` 设置事务的隔离级别 Connection.TRANSACTION_NONE 驱动不支持事务 Connection.TRANSACTION_READ_UNCOMMITTED 允许脏读、不可重复读和幻读 Connection.TRANSACTION_READ_COMMITTED 禁止脏读，但允许不可重复读和幻读 Connection.TRANSACTION_REPEATABLE_READ 禁止脏读和不可重复读，单运行幻读 Connection.TRANSACTION_SERIALIZABLE 禁止脏读、不可重复读和幻读
`Session`	`setWrapper(Character wrapperChar)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`Session`	`setWrapper(Wrapper wrapper)` 设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
`void`	`trans(VoidFunc1<Session> func)` 已过时。请使用`tx(VoidFunc1)`
`void`	`tx(VoidFunc1<Session> func)` 在事务中执行操作，通过实现`VoidFunc0`接口的call方法执行多条SQL语句从而完成事务

从类继承的方法 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, 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

- 构造器详细资料
  - Session
```
public Session(DataSource ds)
```
    构造，从DataSource中识别方言
    
    参数:
    ds - 数据源
  - Session
```
public Session(DataSource ds,
       String driverClassName)
```
    构造
    
    参数:
    ds - 数据源
    driverClassName - 数据库连接驱动类名，用于识别方言
  - Session
```
public Session(DataSource ds,
       Dialect dialect)
```
    构造
    
    参数:
    ds - 数据源
    dialect - 方言
- 方法详细资料
  - create
```
public static Session create()
```
    创建默认数据源会话
    
    返回:
    Session
    从以下版本开始:
    
    3.2.3
  - create
```
public static Session create(String group)
```
    创建会话
    
    参数:
    group - 分组
    
    返回:
    Session
    从以下版本开始:
    
    4.0.11
  - create
```
public static Session create(DataSource ds)
```
    创建会话
    
    参数:
    ds - 数据源
    
    返回:
    Session
  - getRunner
```
public SqlConnRunner getRunner()
```
    获得SqlConnRunner
    
    覆盖:
    
    getRunner 在类中 AbstractDb
    
    返回:
    SqlConnRunner
  - beginTransaction
```
public void beginTransaction()
                      throws SQLException
```
    开始事务
    
    抛出:
    
    SQLException - SQL执行异常
  - commit
```
public void commit()
            throws SQLException
```
    提交事务
    
    抛出:
    
    SQLException - SQL执行异常
  - rollback
```
public void rollback()
              throws SQLException
```
    回滚事务
    
    抛出:
    
    SQLException - SQL执行异常
  - quietRollback
```
public void quietRollback()
```
    静默回滚事务
    回滚事务
  - rollback
```
public void rollback(Savepoint savepoint)
              throws SQLException
```
    回滚到某个保存点，保存点的设置请使用setSavepoint方法
    
    参数:
    savepoint - 保存点
    
    抛出:
    
    SQLException - SQL执行异常
  - quietRollback
```
public void quietRollback(Savepoint savepoint)
                   throws SQLException
```
    静默回滚到某个保存点，保存点的设置请使用setSavepoint方法
    
    参数:
    savepoint - 保存点
    
    抛出:
    
    SQLException - SQL执行异常
  - setSavepoint
```
public Savepoint setSavepoint()
                       throws SQLException
```
    设置保存点
    
    返回:
    保存点对象
    
    抛出:
    
    SQLException - SQL执行异常
  - setSavepoint
```
public Savepoint setSavepoint(String name)
                       throws SQLException
```
    设置保存点
    
    参数:
    name - 保存点的名称
    
    返回:
    保存点对象
    
    抛出:
    
    SQLException - SQL执行异常
  - setTransactionIsolation
```
public void setTransactionIsolation(int level)
                             throws SQLException
```
    设置事务的隔离级别
    Connection.TRANSACTION_NONE 驱动不支持事务
    Connection.TRANSACTION_READ_UNCOMMITTED 允许脏读、不可重复读和幻读
    Connection.TRANSACTION_READ_COMMITTED 禁止脏读，但允许不可重复读和幻读
    Connection.TRANSACTION_REPEATABLE_READ 禁止脏读和不可重复读，单运行幻读
    Connection.TRANSACTION_SERIALIZABLE 禁止脏读、不可重复读和幻读
    
    参数:
    level - 隔离级别
    
    抛出:
    
    SQLException - SQL执行异常
  - tx
```
public void tx(VoidFunc1<Session> func)
        throws SQLException
```
    在事务中执行操作，通过实现VoidFunc0接口的call方法执行多条SQL语句从而完成事务
    
    参数:
    func - 函数抽象，在函数中执行多个SQL操作，多个操作会被合并为同一事务
    
    抛出:
    
    SQLException
    从以下版本开始:
    
    3.2.3
  - trans
```
@Deprecated
public void trans(VoidFunc1<Session> func)
```
    已过时。 请使用tx(VoidFunc1)
    
    在事务中执行操作，通过实现VoidFunc0接口的call方法执行多条SQL语句从而完成事务
    
    参数:
    func - 函数抽象，在函数中执行多个SQL操作，多个操作会被合并为同一事务
    从以下版本开始:
    
    3.2.3
  - setWrapper
```
public Session setWrapper(Character wrapperChar)
```
    从类复制的说明: AbstractDb
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    覆盖:
    
    setWrapper 在类中 AbstractDb
    
    参数:
    wrapperChar - 包装字符，字符会在SQL生成时位于表名和字段名两边，null时表示取消包装
    
    返回:
    this
  - setWrapper
```
public Session setWrapper(Wrapper wrapper)
```
    从类复制的说明: AbstractDb
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    覆盖:
    
    setWrapper 在类中 AbstractDb
    
    参数:
    wrapper - 包装器，null表示取消包装
    
    返回:
    this
  - disableWrapper
```
public Session 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
  - close
```
public void close()
```
    指定者:
    
    close 在接口中 Closeable
    
    指定者:
    
    close 在接口中 AutoCloseable

类 Session

字段概要

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

构造器概要

方法概要

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

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

构造器详细资料

Session

Session

Session

方法详细资料

create

create

create

getRunner

beginTransaction

commit

rollback

quietRollback

rollback

quietRollback

setSavepoint

setSavepoint

setTransactionIsolation

tx

trans

setWrapper

setWrapper

disableWrapper

getConnection

closeConnection

close