Session (easytools 1.0.0 API)

java.lang.Object
- javacommon.easytools.db.AbstractSqlRunner
- - javacommon.easytools.db.Session

所有已实现的接口:

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

字段概要
- 从类继承的字段 javacommon.easytools.db.AbstractSqlRunner
  runner

构造器概要

构造器
构造器和说明

Session(Connection conn)
构造

Session(DataSource ds)
构造

构造器
构造器和说明
`Session(Connection conn)` 构造
`Session(DataSource ds)` 构造

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`beginTransaction()` 开始事务
`void`	`close()`
`void`	`closeConnection(Connection conn)` Session中不关闭连接
`void`	`commit()` 提交事务
`static Session`	`create()` 创建默认数据源会话
`static Session`	`create(Connection conn)` 创建会话
`static Session`	`create(DataSource ds)` 创建会话
`Connection`	`getConn()` 获得`Connection`
`Connection`	`getConnection()` 获得连接，Session中使用同一个连接
`SqlConnRunner`	`getRunner()` 获得`SqlConnRunner`
`boolean`	`isSupportTransaction()` 数据库是否支持事务
`void`	`quietRollback()` 静默回滚事务回滚事务
`void`	`quietRollback(Savepoint savepoint)` 静默回滚到某个保存点，保存点的设置请使用setSavepoint方法
`void`	`rollback()` 回滚事务
`void`	`rollback(Savepoint savepoint)` 回滚到某个保存点，保存点的设置请使用setSavepoint方法
`void`	`setConn(Connection conn)` 设置`Connection`
`void`	`setRunner(SqlConnRunner runner)` 设置`SqlConnRunner`
`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(VoidFunc func)` 在事务中执行操作，通过实现`VoidFunc`接口的call方法执行多条SQL语句从而完成事务

从类继承的方法 javacommon.easytools.db.AbstractSqlRunner
count, del, del, execute, executeBatch, executeForGeneratedKey, find, find, find, find, find, findAll, findAll, findAll, findBy, findBy, findLike, get, get, insert, insert, insertForGeneratedKey, insertForGeneratedKeys, page, page, page, page, page, page, page, page, pageForEntityList, pageForEntityList, query, query, query, queryNumber, queryOne, queryString, update

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

- 构造器详细资料
  - Session
```
public Session(DataSource ds)
```
    构造
    
    参数:
    
    ds - 数据源
  - Session
```
public Session(Connection conn)
```
    构造
    
    参数:
    
    conn - 数据库连接对象
- 方法详细资料
  - create
```
public static Session create()
```
    创建默认数据源会话
    
    返回:
    
    Session
    
    从以下版本开始:
    
    3.2.3
  - create
```
public static Session create(DataSource ds)
```
    创建会话
    
    参数:
    
    ds - 数据源
    
    返回:
    
    Session
  - create
```
public static Session create(Connection conn)
```
    创建会话
    
    参数:
    
    conn - 数据库连接对象
    
    返回:
    
    Session
  - getConn
```
public Connection getConn()
```
    获得Connection
    
    返回:
    
    Connection
  - setConn
```
public void setConn(Connection conn)
```
    设置Connection
    
    参数:
    
    conn - Connection
  - getRunner
```
public SqlConnRunner getRunner()
```
    获得SqlConnRunner
    
    覆盖:
    
    getRunner 在类中 AbstractSqlRunner
    
    返回:
    
    SqlConnRunner
  - setRunner
```
public void setRunner(SqlConnRunner runner)
```
    设置SqlConnRunner
    
    覆盖:
    
    setRunner 在类中 AbstractSqlRunner
    
    参数:
    
    runner - SqlConnRunner
  - isSupportTransaction
```
public boolean isSupportTransaction()
                             throws DbRuntimeException
```
    数据库是否支持事务
    
    返回:
    
    是否支持事务
    
    抛出:
    
    DbRuntimeException - SQLException包装
    
    从以下版本开始:
    
    3.2.3
  - 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执行异常
  - trans
```
public void trans(VoidFunc func)
```
    在事务中执行操作，通过实现VoidFunc接口的call方法执行多条SQL语句从而完成事务
    
    参数:
    
    func - 函数抽象，在函数中执行多个SQL操作，多个操作会被合并为同一事务
    
    从以下版本开始:
    
    3.2.3
  - setWrapper
```
public Session setWrapper(Character wrapperChar)
```
    从类复制的说明: AbstractSqlRunner
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    覆盖:
    
    setWrapper 在类中 AbstractSqlRunner
    
    参数:
    
    wrapperChar - 包装字符，字符会在SQL生成时位于表名和字段名两边，null时表示取消包装
    
    返回:
    
    this
  - setWrapper
```
public Session setWrapper(Wrapper wrapper)
```
    从类复制的说明: AbstractSqlRunner
    
    设置包装器，包装器用于对表名、字段名进行符号包装（例如双引号），防止关键字与这些表名或字段冲突
    
    覆盖:
    
    setWrapper 在类中 AbstractSqlRunner
    
    参数:
    
    wrapper - 包装器，null表示取消包装
    
    返回:
    
    this
  - getConnection
```
public Connection getConnection()
                         throws SQLException
```
    获得连接，Session中使用同一个连接
    
    指定者:
    
    getConnection 在类中 AbstractSqlRunner
    
    返回:
    
    Connection
    
    抛出:
    
    SQLException - SQL执行异常
  - closeConnection
```
public void closeConnection(Connection conn)
```
    Session中不关闭连接
    
    指定者:
    
    closeConnection 在类中 AbstractSqlRunner
    
    参数:
    
    conn - Connection
  - close
```
public void close()
```
    指定者:
    
    close 在接口中 Closeable
    
    指定者:
    
    close 在接口中 AutoCloseable

类 Session

字段概要

从类继承的字段 javacommon.easytools.db.AbstractSqlRunner

构造器概要

方法概要

从类继承的方法 javacommon.easytools.db.AbstractSqlRunner

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

构造器详细资料

Session

Session

方法详细资料

create

create

create

getConn

setConn

getRunner

setRunner

isSupportTransaction

beginTransaction

commit

rollback

quietRollback

rollback

quietRollback

setSavepoint

setSavepoint

setTransactionIsolation

trans

setWrapper

setWrapper

getConnection

closeConnection

close