Trans (Nutz 1.r.61.r2 API)

java.lang.Object
- org.nutz.trans.Trans

```
public abstract class Trans
extends Object
```
用模板的方式操作事务

作者:

zozoh(zozohtnt@gmail.com), wendal(wendal1985@gmail.com)

字段概要

字段
限定符和类型字段和说明

static boolean DEBUG
事务debug开关

字段
限定符和类型	字段和说明
`static boolean`	`DEBUG` 事务debug开关

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static void`	`begin()` 开始一个事务，级别为 TRANSACTION_READ_COMMITTED 你需要手工用 try...catch...finally 来保证你提交和关闭这个事务
`static void`	`begin(int level)` 开始一个指定事务你需要手工用 try...catch...finally 来保证你提交和关闭这个事务
`static void`	`clear(boolean rollbackOrCommit)` 强制清理事务上下文
`static void`	`close()` 关闭事务，执行它前，你必需保证你已经手工开始了一个事务
`static void`	`closeConnectionAuto(Connection conn)` 自动判断是否关闭当前连接
`static void`	`commit()` 提交事务，执行它前，你必需保证你已经手工开始了一个事务
`static void`	`exec(Atom... atoms)` 执行一组原子操作，默认的事务级别为: TRANSACTION_READ_COMMITTED。
`static void`	`exec(int level, Atom... atoms)` 执行一组原子操作，并指定事务级别。
`static <T> T`	`exec(Molecule<T> molecule)` 执行一个分子，并给出返回值
`static Transaction`	`get()`
`static Connection`	`getConnectionAuto(DataSource ds)` 如果在事务中,则返回事务的连接,否则直接从数据源取一个新的连接
`static boolean`	`isTransactionNone()` 是否在事务中
`static void`	`rollback()` 回滚事务，执行它前，你必需保证你已经手工开始了一个事务
`static void`	`setup(Class<? extends Transaction> classOfTransaction)` 这个函数允许你扩展默认的 Nutz 事务实现方式

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

- 字段详细资料
  - DEBUG
```
public static boolean DEBUG
```
    事务debug开关
- 方法详细资料
  - get
```
public static Transaction get()
```
    返回:
    
    当前线程的事务，如果没有事务，返回 null
  - setup
```
public static void setup(Class<? extends Transaction> classOfTransaction)
```
    这个函数允许你扩展默认的 Nutz 事务实现方式
    
    参数:
    
    classOfTransaction - 你的事务实现
  - isTransactionNone
```
public static boolean isTransactionNone()
```
    是否在事务中
    
    返回:
    
    真,如果在不事务中
  - exec
```
public static void exec(Atom... atoms)
```
    执行一组原子操作，默认的事务级别为: TRANSACTION_READ_COMMITTED。详细请看 exec(int level, Atom... atoms) 函数的说明
    
    参数:
    
    atoms - 原子操作对象
  - exec
```
public static void exec(int level,
                        Atom... atoms)
```
    执行一组原子操作，并指定事务级别。
    这里需要注意的是，Nutz 支持事务模板的无限层级嵌套。这里，如果每一层嵌套，指定的事务级别有所不同，不同的数据库，可能引发不可预知的错误。
    所以，嵌套的事务模板的事务，将以最顶层的事务为级别为标准。就是说，如果最顶层的事务级别为 'TRANSACTION_READ_COMMITTED'，那么下面所包含的所有事务，无论你指定什么样的事务级别，都是 'TRANSACTION_READ_COMMITTED'，这一点，由抽象类 Transaction 来保证。其 setLevel 当被设置了一个大于 0 的整数以后，将不再接受任何其他的值。
    你可以通过继承 Transaction 来修改这个默认的行为，当然，这个行为修改一般是没有必要的。
    另外，你还可能需要知道，通过 Trans.setup 方法，能让整个虚拟机的 Nutz 事务操作都使用你的 Transaction 实现
    参数:
    level - 事务的级别。
    你可以设置的事务级别是：
    
    java.sql.Connection.TRANSACTION_NONE
    java.sql.Connection.TRANSACTION_READ_UNCOMMITTED
    java.sql.Connection.TRANSACTION_READ_COMMITTED
    java.sql.Connection.TRANSACTION_REPEATABLE_READ
    java.sql.Connection.TRANSACTION_SERIALIZABLE
    不同的数据库，对于 JDBC 事务级别的规范，支持的力度不同。请参看相应数据库的文档，已确定你设置的数据库事务级别是否被支持。
    atoms - 原子操作对象
    
    另请参阅:
    
    Transaction, Connection
  - exec
```
public static <T> T exec(Molecule<T> molecule)
```
    执行一个分子，并给出返回值
    
    类型参数:
    
    T -
    
    参数:
    
    molecule - 分子
    
    返回:
    
    分子返回值
  - begin
```
public static void begin()
                  throws Exception
```
    开始一个事务，级别为 TRANSACTION_READ_COMMITTED
    你需要手工用 try...catch...finally 来保证你提交和关闭这个事务
    
    抛出:
    
    Exception
  - begin
```
public static void begin(int level)
                  throws Exception
```
    开始一个指定事务
    你需要手工用 try...catch...finally 来保证你提交和关闭这个事务
    
    参数:
    
    level - 指定级别
    
    抛出:
    
    Exception
  - commit
```
public static void commit()
                   throws Exception
```
    提交事务，执行它前，你必需保证你已经手工开始了一个事务
    
    抛出:
    
    Exception
  - rollback
```
public static void rollback()
                     throws Exception
```
    回滚事务，执行它前，你必需保证你已经手工开始了一个事务
    
    抛出:
    
    Exception
  - close
```
public static void close()
                  throws Exception
```
    关闭事务，执行它前，你必需保证你已经手工开始了一个事务
    
    抛出:
    
    Exception
  - getConnectionAuto
```
public static Connection getConnectionAuto(DataSource ds)
                                    throws SQLException
```
    如果在事务中,则返回事务的连接,否则直接从数据源取一个新的连接
    
    抛出:
    
    SQLException
  - closeConnectionAuto
```
public static void closeConnectionAuto(Connection conn)
```
    自动判断是否关闭当前连接
    
    参数:
    
    conn - 数据库连接
  - clear
```
public static void clear(boolean rollbackOrCommit)
```
    强制清理事务上下文
    
    参数:
    
    rollbackOrCommit - 检测到未闭合的事务时回滚还是提交，true为回滚，false为提交。

类 Trans

字段概要

方法概要

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

字段详细资料

DEBUG

方法详细资料

get

setup

isTransactionNone

exec

exec

exec

begin

begin

commit

rollback

close

getConnectionAuto

closeConnectionAuto

clear