通过 transactions 子系统，您可以配置事务管理器(TM)选项，如超时值、事务日志记录、统计收集，以及是否使用 Jakarta Transactions。事务 子系统由四个主要元素组成：

设计良好的事务的典型标准是原子性、一致、隔离和持久(ACID)：

唯一的节点标识符允许 JBoss EAP 恢复仅与指定节点标识符匹配的事务和事务状态。您可以使用 com.arjuna.ats.arjuna.nodeIdentifier 属性设置节点标识符。

您可以使用基于 Web 的管理控制台或命令行管理 CLI 配置事务管理器。

使用管理控制台配置交易管理器

以下步骤解释了如何使用基于 Web 的管理控制台配置事务管理器：

使用管理 CLI 配置交易管理器

通过使用管理 CLI，您可以使用一系列命令配置事务管理器。命令全部以单机服务器的 /subsystem=transactions 开头，受管域中 默认配置 文件的 /profile=default/subsystem=transactions/ 开头。

有关所有事务管理器配置选项的详细列表，请参阅 JBoss EAP 的事务管理器配置选项。

您可以使用管理控制台、管理 CLI 或系统属性来配置许多事务管理器选项。不过，以下选项只能使用系统属性进行配置。它们不能通过管理 CLI 或管理控制台进行配置。

本例演示了如何在 standalone.xml 服务器配置文件中配置这些系统属性。

<system-properties>
    <property name="RecoveryEnvironmentBean.periodicRecoveryPeriod" value="180"/>
    <property name="RecoveryEnvironmentBean.recoveryBackoffPeriod" value="20"/>
    <property name="RecoveryEnvironmentBean.periodicRecoveryInitilizationOffset" value="5"/>
    <property name="RecoveryEnvironmentBean.expiryScanInterval" value="24"/>
</system-properties>

有关如何配置系统属性的更多信息，请参阅《 配置指南》 中的 系统属性。

此任务演示了如何在数据源上启用 Jakarta Transactions。

先决条件

将数据源配置为使用 Jakarta Transactions

您的数据源现在已配置为使用 Jakarta Transactions。

在 JBoss EAP 的默认安装中，针对事务的对象请求代理(ORB)支持被禁用。您可以使用管理 CLI 或管理控制台，在 iiop-openjdk 子系统中配置 ORB 设置。

有关 iiop-openjdk 子系统的可用配置选项列表，请参阅《 配置指南 》 中的 IIOP 子系统属性。

使用管理 CLI 配置 ORB

您可以使用管理 CLI 配置 ORB 的各个方面。这是用于 JTS 的 ORB 的最小配置。

您可以使用 full 配置文件为受管域配置以下管理 CLI 命令：如有必要，请更改配置集，使其适合您需要配置的配置文件。如果您使用的是单机服务器，请省略命令的 /profile=full 部分。

启用安全拦截器

通过将值设置为 identity 来启用 security 属性。

/profile=full/subsystem=iiop-openjdk:write-attribute(name=security,value=identity)

在 IIOP 子系统中启用事务

要为 JTS 启用 ORB，请将 transactions 属性 的值设置为 full，而不是默认的 spec。

/profile=full/subsystem=iiop-openjdk:write-attribute(name=transactions, value=full)

在事务子系统中启用 JTS

/profile=full/subsystem=transactions:write-attribute(name=jts,value=true)

使用管理控制台配置 ORB

管理 CLI 支持浏览和操作事务记录的功能。此功能由 TM 与 JBoss EAP 管理 API 之间的交互来提供。

交易管理器将各项待处理交易和涉及交易的参与者的信息存储在称为对象存储的持久存储中。管理 API 将对象存储作为名为 log-store 的资源公开。探测 操作会读取事务日志，并为每个记录创建一个节点路径。您可以手动调用 探测 操作，每当您需要刷新 日志存储时。事务日志快速出现和消失是正常现象。

刷新日志存储

以下命令可在受管域中刷新服务器组的日志存储，它们使用配置文件 default ：对于单机服务器，请从命令中删除 profile=default。

/profile=default/subsystem=transactions/log-store=log-store:probe

查看所有准备的事务

要查看所有准备的事务，请先 刷新日志存储，然后运行以下命令，该命令的作用类似于文件系统 ls 命令：

ls /profile=default/subsystem=transactions/log-store=log-store/transactions

或者

/host=master/server=server-one/subsystem=transactions/log-store=log-store:read-children-names(child-type=transactions)

显示每项事务及其唯一标识符。单个操作可以针对单个交易运行。如需更多信息 ，请参阅管理交易。

查看交易的属性

要查看事务的相关信息，如 Java 命名和目录接口名称、EIS 产品名称和版本或其状态，请使用 read-resource 操作。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-resource

查看交易参与者的详细信息

每个事务日志包含一个子元素，称为 参与者。使用此元素的 read-resource 操作来查看事务参与者的详细信息。参与者通过其 Java 命名和目录接口名称标识。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=java\:\/JmsXA:read-resource

结果可能类似如下：

{
   "outcome" => "success",
   "result" => {
       "eis-product-name" => "ActiveMQ",
       "eis-product-version" => "2.0",
       "jndi-name" => "java:/JmsXA",
       "status" => "HEURISTIC",
       "type" => "/StateManager/AbstractRecord/XAResourceRecord"
   }
}

此处显示的结果状态为 HEURISTIC 状态，并有资格恢复。如需了解更多详细信息 ，请参阅恢复 交易参与者。

特殊情况下，可以在对象存储中创建孤立记录，即 XAResourceRecords，日志中没有任何对应的事务记录。例如，XA 资源已准备好，但在 TM 记录之前崩溃，域管理 API 无法访问 XA 资源。要访问这些记录，您需要将 management 选项 expose-all-logs 设置为 true。此选项不会保存在管理模型中，并且在服务器重启时恢复到 false。

/profile=default/subsystem=transactions/log-store=log-store:write-attribute(name=expose-all-logs, value=true)

您可以使用这一备用命令，以汇总格式显示事务参与者 ID。

/host=master/server=server-one/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-children-names(child-type=participants)

删除交易参与者

每个事务日志都支持 删除 操作，从而删除代表事务的事务日志。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:delete

这也会删除交易中的所有参与者。

恢复交易参与者

每个交易参与者都支持使用恢复操作进行 恢复。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:recover

如果交易参与者的状态是 HEURISTIC，则 恢复 操作会将状态切换到 PREPARE，并请求定期恢复过程重新播放提交。

如果提交成功，则从事务日志中移除参与者。您可以通过在 日志存储上运行 探测 操作并检查 参与者是否不再列出来进行验证。如果这是最后一个参与者，则交易也将被删除。

刷新交易参与者的状态

如果事务需要恢复，您可以使用 刷新 操作确保在尝试恢复前仍然需要恢复。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:refresh

如果启用了事务管理器统计信息，您可以查看事务管理器处理事务的统计信息。如需有关如何启用 事务管理器 统计信息的信息，请参阅 JBoss EAP 配置指南 中的"配置交易管理器"一节。

您可以使用管理控制台或管理 CLI 查看统计信息。在管理控制台中，可以通过从 Runtime 选项卡导航到 Transaction 子系统来提供事务统计信息。在管理 CLI 中，您可以通过在 read-resource 操作中使用 include-runtime=true 来查看统计信息。例如：

/subsystem=transactions:read-resource(include-runtime=true)

下表显示了管理控制台显示每个事务统计的名称、管理 CLI 属性和描述。

事务需要存储对象的位置。对象存储的一个选项是 JDBC 数据源。如果系统性能特别值得关注，则 JDBC 对象存储可能比文件系统或 ActiveMQ 日志对象存储慢。

使用 JDBC 数据源作为事务对象存储

按照以下步骤，将 JDBC 数据源用作事务对象存储。

事务 JDBC 存储属性

下表列出了与 JDBC 对象存储相关的所有可用属性。

使用 ActiveMQ Journal 对象存储

按照以下步骤，使用 ActiveMQ 日志对象存储：

您可以独立于 JBoss EAP 中的其他日志设置控制与事务相关的日志信息量。您可以使用管理控制台或管理 CLI 配置日志设置。

使用管理控制台配置事务日志记录器

使用管理 CLI 配置交易日志记录器

使用以下命令，从管理 CLI 设置日志级别：对于单机服务器，请从命令中删除 /profile=default。

/profile=default/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=VALUE)

/subsystem=logging/logger=org.jboss.jbossts.txbridge:add(level=ALL)

<logger category="org.jboss.jbossts.txbridge">
  <level name="ALL" />
</logger>

/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=ALL)

<logger category="com.arjuna">
  <level name="ALL" />
</logger>

// Transaction id
Uid tx = new Uid();
. . . .
TransactionStatusConnectionManager tscm = new TransactionStatusConnectionManager();

// Check if the transaction aborted
assertEquals(tscm.getTransactionStatus(tx), ActionStatus.ABORTED);

$ EAP_HOME/bin/standalone.sh -DRecoveryEnvironmentBean.transactionStatusManagerPort=NETWORK_PORT_NUMBER

/subsystem=transactions:write-attribute(name=enable-statistics,value=true)

public class TxStats
{
    /**
     * @return the number of transactions (top-level and nested) created so far.
     */

    public static int numberOfTransactions();

    /**
     * @return the number of nested (sub) transactions created so far.
     *

     public static int numberOfNestedTransactions();

     /**
     * @return the number of transactions which have terminated with heuristic
     *         outcomes.
     */

    public static int numberOfHeuristics();
    /**
     * @return the number of committed transactions.
     */

    public static int numberOfCommittedTransactions();

    /**
     * @return the total number of transactions which have rolled back.
     */

    public static int numberOfAbortedTransactions();

    /**
     * @return total number of inflight (active) transactions.
     */

    public static int numberOfInflightTransactions ();

    /**
     * @return total number of transactions rolled back due to timeout.
     */

    public static int numberOfTimedOutTransactions ();
    /**
     * @return the number of transactions rolled back by the application.
     */

    public static int numberOfApplicationRollbacks ();

    /**
     * @return number of transactions rolled back by participants.
     */

    public static int numberOfResourceRollbacks ();

    /**
     * Print the current information.
     */

    public static void printStatus(java.io.PrintWriter pw);
}

交易超时的原因有很多，例如：

您可以查看日志是否有以下出错信息来识别超时事务：

WARN ARJUNA012117 "TransactionReaper::check timeout for TX {0} in state {1}"

其中 {0} 是事务的 Uid，{1} 是超时事务的状态 {1} 的交易管理器视图。

事务管理器提供以下调试事务超时的选项：

交易管理器的 XML 事务服务(XTS)组件支持在业务交易中协调私有和公共 Web 服务。XTS 为 JBoss EAP 服务器上托管的 Web 服务提供 WS-AT 和 WS-BA 支持。它是可选的子系统，可通过 standalone-xts.xml 配置来启用。

以下属性允许您清除过期的交易：

所有扫描程序模块继承来自 ExpiryScanner 接口的相同行为。此界面提供的扫描方法由所有扫描程序模块实施，包括以下内容：扫描程序线程调用这个扫描方法。

当事务资源在分布式事务的完成阶段做出单边决策以提交或回滚事务更新时，会进行 heuristic completion。这可以使分布式数据处于不确定的状态。网络故障或资源超时可能是造成启发性完成的原因。启发性补全会产生以下启发性结果例外之一：

此流程演示了如何使用 Jakarta Transactions 处理交易的启发式结果。

/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:read-resource

{
   "outcome" => "success",
   "result" => {
       "eis-product-name" => "ArtemisMQ",
       "eis-product-version" => "2.0",
       "jndi-name" => "java:/JmsXA",
       "status" => "HEURISTIC_HAZARD",
       "type" => "/StateManager/AbstractRecord/XAResourceRecord"
   }
}