当使用Bean管理事务时，开发者必须通过JNDI API查找并获取由服务器提供的javax.transaction.UserTransaction接口，或者通过伴随EJB实例的javax.ejb.EJBContext接口的getUserTransaction方法，获取javax.transaction.UserTransaction接口，并使用此接口对事务进行划分。另外，还必须在EJB的部署描述文件中，使用transaction-type元素指定其事务管理类型为Bean管理事务类型。

使用JNDI查找UserTransaction接口的范例代码如下：

...
try 
{
    Context initial = new InitialContext();
    Object objref = initial.lookup("java:comp/UserTransaction");
    javax.transaction.UserTransaction tx = 
        (javax.transaction.UserTransaction)objref;
    tx.begin();
    ...
}
catch(...)
...

Session Bean中使用javax.ejb.EJBContext取得UserTransaction接口的范例代码如下：

try
{
    ...
    javax.ejb.EJBContext ctx = getSessionContext();
    javax.transaction.UserTransaction tx = 
        ctx.getUserTransaction();
    ...
    tx.begin();
    ...
}
catch(...)
...

tansaction-type元素的设置范例如下：

...
<ejb-jar>
    <display-name>CartEJB</display-name>
    <enterprise-beans>
        <session>
            <display-name>CartEJB</display-name>
            ...   
            <transaction-type>Bean</transaction-type>
            ...
        </session>
        ...
    </enterprise-beans>
    ...
</ejb-jar>

有关javax.transaction.UserTransaction的详细使用说明，请参考Sun的JTA文档。

当使用容器管理事务时，开发者需要在部署描述文件中使用transaction-type元素指定事务管理类型为容器管理事务，并在Entity Bean的assembly-descriptor元素中，使用container-transaction元素对EJB方法的事务属性进行声明。

使用容器管理事务的EJB的业务方法和Message-driven Bean中的onMessage方法中，不可对相关的资源调用任何特定的事务管理方法，以免干扰容器对事务边界的划分。这些方法包括如java.sql.Connection接口的commit、setAutoCommit和rollback方法，javax.jms.Session接口的commit和rollback等方法。

使用容器管理事务的EJB的业务方法和Message-driven Bean中的onMessage方法中，不能试图访问和使用javax.transaction.UserTransaction接口。

下面是一个容器管理事务的EJB的业务方法的例子，此方法使用JDBC连接更新两个数据库中的相关数据，容器按照部署描述中的事务属性进行事务划分：

...
public class MySessionEJB 
    implements javax.ejb.SessionBean 
{
    EJBContext ejbContext;
    
    public void someMethod(...) {
        java.sql.Connection con1;
        java.sql.Connection con2;
        java.sql.Statement stmt1;
        java.sql.Statement stmt2;
        // 获取con1和con2连接对象
        con1 = ...;
        con2 = ...;
        stmt1 = con1.createStatement();
        stmt2 = con2.createStatement();
        //
        // 在con1和con2上进行更新操作。容器使用自动征用con1和
        // con2对象，提供对con1和con2的操作的事务管理。
        //
        stmt1.executeQuery(...);
        stmt1.executeUpdate(...);
        stmt2.executeQuery(...);
        stmt2.executeUpdate(...);
        stmt1.executeUpdate(...);
        stmt2.executeUpdate(...);
        // 释放连接
        con1.close();
        con2.close();
    }
    ...
}

此范例Session Bean的事务属性相关的部署描述文件如下：

<ejb-jar>
    <display-name>MySessionEJB</display-name>
    <enterprise-beans>
        <session>
            <display-name>MySessionEJB</display-name>
            ...
        </session>
    ...
    </enterprise-beans>
    <assembly-descriptor>
        ...
        <container-transaction>
            ...
            <method>
                ...
                <ejb-name>MySessionEJB</ejb-name>
                <method-name>someMethod</method-name>
                ...
            </method>
            <trans-attribute>Required</trans-attribute>
            ...
        </container-transaction>
        ...
    </assembly-descriptor>
</ejb-jar>

44.11.3.2.3. 事务属性

对容器管理事务的Session Bean和Entity Bean的Home接口和组件接口中定义的方法，以及Message-driven Bean中的onMessage方法，开发者可以设置其事务属性。当客户端通过Home接口或组件接口调用这些方法时，或者当消息到达时onMessage方法被调用时，容器将按照开发者指定的事务属性对以上方法的事务进行管理。

当使用容器管理事务的EJB时，开发者必须指定以下方法的事务属性：

• Session Bean中，除了在javax.ejb.EJBObject接口和javax.ejb.EJBLocalObject接口中定义的方法，其他定义在组件接口中的方法，以及定义在组件接口直接或非直接地继承的接口中的方法，开发者必须指定方法的事务属性。Session Bean的Home接口中的方法不可指定其事务属性；

• Entity Bean中，除了getEJBHome、getEJBLocalHome、getHandler、getPrimaryKey和isIdentical方法之外，其他定义在组件接口中的方法，以及定义在组件接口直接或非直接地继承的接口中的方法，开发者必须指定方法的事务属性。除了远程Home接口中的getEJBMetaData和getHomeHandler方法，其他定义在Home接口中的方法，以及定义在Home接口直接或非直接地继承的接口中的方法，开发者必须指定方法的事务属性；

• Message-driven Bean中，开发者必须指定onMessage方法的事务属性。

开发者可指定的事务属性包括以下几种：NotSupported、Required、Supports、RequiresNew、Mandatory和Never。

下面对这六种事务属性具有的事务语义分别进行描述。

44.11.3.2.3.1. NotSupported

当某方法的事务属性被指定为NotSupported时，容器将在未指明的事务上下文中调用此方法。具体情形如下：

当客户端请求伴随事务上下文，容器将在调用EJB的业务方法之间，暂停当前线程伴随的事务上下文。当方法调用完成之后，容器恢复前面暂停的事务上下文。伴随客户端调用事务上下文不会传递到资源管理器或业务方法中调用的其他组件。 如此业务方法调用了其他组件，则此调用不伴随任何事务。

当客户端请求不伴随事务上下文，容器也将不在事务上下文中进行此方法调用。

另外，如果方法中调用了其他的组件，则调用将不会伴随事务上下文。

44.11.3.2.3.2. Required

当某方法的事务属性被指定为Required时，容器将在有效的事务上下文中调用此方法。具体情形如下：

当客户端请求伴随事务上下文，则容器在此事务上下文中调用此业务方法。

如客户端请求不伴随事务上下文，容器在调用此业务方法之前，将自动开始一个新的事务，并在此事务中自动征用（enlist）此业务方法访问的所有事务性资源，如方法中调用了其他的EJB组件，则调用将伴随此容器开始的事务。当容器对业务方法的调用完成，容器将试图提交事务。在方法调用结果返回客户端之前，容器将执行事务的提交协议（如两阶段提交协议）。

44.11.3.2.3.3. Supports

当某方法的事务属性被指定为Supports时，容器将按如下规则调用此方法：

• 如客户端请求伴随事务上下文，容器按照事务属性为Required的情况，使用相同步骤进行处理；

• 如客户端请求不伴随事务上下文，容器按照事务属性为NotSupported的情况，使用相同步骤进行处理。

	注意
	使用Supports事务属性时必须注意，因为根据客户端请求是否伴随事务上下文，决定了不同的执行模式，进而决定了不同的方法事务语义，只有在这两种不同的执行模式中都能正确运行的方法，才能考虑使用Supports事务属性。

44.11.3.2.3.4. RequiresNew

当某方法的事务属性被指定为RequiresNew时，容器将在一个新的事务上下文中调用此方法。具体情形如下：

当客户端请求不伴随事务上下文，容器在调用此业务方法之前，将自动开始一个新的事务，并在此事务中自动征用（enlist）此业务方法访问的所有事务性资源，如方法中调用了其他的EJB组件，则调用将伴随此容器开始的事务。当容器对业务方法的调用完成，容器将试图提交事务。在方法调用结果返回客户端之前，容器将执行事务的提交协议（如两阶段提交协议）。

当客户端请求伴随事务上下文，容器在开始一个新的事务和调用业务方法之前，将自动暂停当前客户端线程伴随的事务上下文。在方法调用和容器开始的事务完成之后，容器将恢复前面暂停的客户端事务。

44.11.3.2.3.5. Mandatory

当某方法的事务属性被指定为Mandatory时，容器将在客户端的事务上下文中调用此方法。客户端调用此方法时，必须伴随事务：

• 如客户端请求伴随事务上下文，容器按照事务属性为Required的情况，使用相同步骤进行处理；

• 如客户端请求不伴随事务上下文，如果客户端为远程客户端，则容器将抛出javax.transaction.TransactionRequiredException异常；如果客户端为本地客户端，则容器将抛出javax.transaction.TransactionRequiredLocalException异常；

44.11.3.2.3.6. Never

当某方法的事务属性被指定为Never时，容器将不会在任何EJB规范中规定的事务上下文中调用此方法。客户端调用此方法时，不能伴随事务：

• 如客户端请求伴随事务上下文，如果客户端为远程客户端，则容器将抛出java.rmi.RemoteException异常；如果客户端为本地客户端，则容器将抛出javax.ejb.EJBException异常；

• 如客户端请求不伴随事务上下文，容器按照事务属性为NotSupported的情况，使用相同步骤进行处理；