第 14 章 配置事务
14.1. 事务子系统配置
14.1.1. 配置 Transaction Manager
您可以使用基于 Web 的管理控制台或命令行管理 CLI 配置事务管理器。
使用管理控制台配置事务管理器
以下步骤解释了如何使用基于 Web 的管理控制台配置事务管理器:
- 从屏幕的顶部选择 Configuration 选项卡。
- 如果您将 JBoss EAP 作为受管域运行,请选择要修改的配置文件。
- 从 Subsystem 列表中,选择 Transactions,再单击 View。
- 对于您要编辑的设置,在适当的标签页上点 Edit,如 恢复 恢复选项。
- 进行必要的更改,然后单击 Save 以保存更改。
- 单击 Need Help? 以显示帮助文本。
使用管理 CLI 配置事务管理器
使用管理 CLI,您可以使用一系列命令配置事务管理器。对于单机服务器,所有命令都以 /subsystem=transactions
开头,对于受管域中默认配置集,都以 /profile=
开头。
default
/subsystem=transactions/
有关所有事务管理器配置选项的详细列表,请参阅 JBoss EAP 的 Transaction Manager 配置选项。
14.1.2. 将您的数据源配置为使用 JTA
此任务演示了如何在数据源上启用 Java Transaction API (JTA)。
先决条件
- 您的数据库必须支持 Java 事务 API。如果有疑问,请查阅您的数据库文档。
- 注意
XA datasources 已默认支持 JTA。
将数据源配置为使用 Java Transaction API
使用以下管理 CLI 命令将
jta
属性设置为true
。/subsystem=datasources/data-source=DATASOURCE_NAME:write-attribute(name=jta,value=true)
注意在受管域中,在此命令前带有
/profile=PROFILE_NAME
。重新加载服务器以使更改生效。
reload
您的数据源现在配置为使用 JTA。
14.1.3. 关于事务日志消息
您可以跟踪事务状态,同时将 DEBUG
日志级别用于事务日志记录器来保持日志文件可读。若要进行详细的调试,请使用 TRACE
日志级别。有关配置事务日志记录器的信息 ,请参阅为 Transactions subsystem 配置 日志记录。
当配置为登录 TRACE
日志级别时,事务管理器(TM)可以生成大量日志信息。以下是一些最常见的消息。此列表不全面,因此您可能看到它们以外的消息。
transaction Begin |
当事务开始时,执行类 |
事务提交 |
当事务提交时,执行类 |
事务回滚 |
当事务回滚时,类 |
事务超时 |
当事务超时时,将执行一个 |
14.1.4. 为 Transactions 子系统配置日志记录
您可以控制记录事务的信息量,独立于 JBoss EAP 中的其他日志记录设置。您可以使用管理控制台或管理 CLI 配置日志设置。
使用管理控制台配置事务日志
导航到 Logging 子系统配置。
- 在管理控制台中,单击 Configuration 选项卡。如果使用受管域,您必须首先选择适当的服务器配置文件。
- 选择 Logging 子系统,再点 View。
编辑
com.arjuna
属性。选择 Log Categories 选项卡。
com.arjuna
条目已存在。选择com.arjuna
,再单击 Attributes 部分中的 Edit。您可以更改日志级别,并选择是否使用父处理程序。日志级别:
因为事务可能会生成大量日志输出,默认的日志记录级别被设置为
WARN
,因此服务器日志不会被事务输出造成大量。如果您需要检查事务处理详细信息,请使用TRACE
日志级别,以便显示事务 ID。使用 Parent Handlers:
父处理程序指示日志记录器是否应该将其输出发送到其父日志记录器。默认行为是
true
。
- 点 Save 保存更改。
使用管理 CLI 配置事务日志
使用以下命令,从管理 CLI 设置日志级别。对于单机服务器,请从命令中删除 /profile=default
。
/profile=default/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=VALUE)