此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Framework 6.2.0！spring-doc.cadn.net.cn

JMS 命名空间支持

Spring 提供了一个 XML 名称空间来简化 JMS 配置。使用 JMS namespace 元素，您需要引用 JMS 架构，如下例所示：spring-doc.cadn.net.cn

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:jms="http://www.springframework.org/schema/jms" (1)
	xsi:schemaLocation="
		http://www.springframework.org/schema/beans
		https://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/jms
		https://www.springframework.org/schema/jms/spring-jms.xsd">

	<!-- bean definitions here -->

</beans>

1	引用 JMS 架构。

命名空间由三个顶级元素组成：<annotation-driven/>,<listener-container/>和<jca-listener-container/>.<annotation-driven/>允许使用 Comments-Driven Listener endpoints 。<listener-container/>和<jca-listener-container/>定义共享侦听器容器配置，并且可以包含<listener/>子元素。以下示例显示了两个侦听器的基本配置：spring-doc.cadn.net.cn

<jms:listener-container>

	<jms:listener destination="queue.orders" ref="orderService" method="placeOrder"/>

	<jms:listener destination="queue.confirmations" ref="confirmationLogger" method="log"/>

</jms:listener-container>

前面的示例等效于创建两个不同的侦听器容器 Bean 定义和两个不同的MessageListenerAdapterBean 定义，如下所示在用MessageListenerAdapter.除了显示的属性在前面的示例中，listener元素可以包含多个可选 Element。下表描述了所有可用属性：spring-doc.cadn.net.cn

表 1.JMS <listener> 元素的属性
属性	描述
`id`spring-doc.cadn.net.cn	托管侦听器容器的 Bean 名称。如果未指定，则 Bean 名称为自动生成。spring-doc.cadn.net.cn
`destination`（必填）spring-doc.cadn.net.cn	此侦听器的目标名称，通过`DestinationResolver`策略。spring-doc.cadn.net.cn
`ref`（必填）spring-doc.cadn.net.cn	处理程序对象的 bean 名称。spring-doc.cadn.net.cn
`method`spring-doc.cadn.net.cn	要调用的处理程序方法的名称。如果`ref`属性指向`MessageListener`或 Spring`SessionAwareMessageListener`中，您可以省略此属性。spring-doc.cadn.net.cn
`response-destination`spring-doc.cadn.net.cn	将响应消息发送到的默认响应目标的名称。这是在请求消息不带有`JMSReplyTo`田。这 type 由侦听器容器的`response-destination-type`属性。请注意，这仅适用于具有 return 值，每个 Result 对象都转换为响应消息。spring-doc.cadn.net.cn
`subscription`spring-doc.cadn.net.cn	长期订阅的名称（如果有）。spring-doc.cadn.net.cn
`selector`spring-doc.cadn.net.cn	此侦听器的可选消息选择器。spring-doc.cadn.net.cn
`concurrency`spring-doc.cadn.net.cn	要为此侦听器启动的并发会话数或使用者数。该值可以是一个表示最大数字的简单数字（例如`5`）或指示较低以及上限（例如`3-5`).请注意，指定的最小值只是一个提示，并且在运行时可能会被忽略。默认值是容器提供的值。spring-doc.cadn.net.cn

这<listener-container/>元素也接受多个可选属性。这允许自定义各种策略（例如，taskExecutor和destinationResolver）以及基本的 JMS 设置和资源引用。通过使用这些属性，您可以定义高度自定义的侦听器容器，而仍然受益于命名空间的便利性。spring-doc.cadn.net.cn

您可以自动将此类设置公开为JmsListenerContainerFactory由指定id的 bean 通过factory-id属性如下例所示：spring-doc.cadn.net.cn

<jms:listener-container connection-factory="myConnectionFactory"
		task-executor="myTaskExecutor"
		destination-resolver="myDestinationResolver"
		transaction-manager="myTransactionManager"
		concurrency="10">

	<jms:listener destination="queue.orders" ref="orderService" method="placeOrder"/>

	<jms:listener destination="queue.confirmations" ref="confirmationLogger" method="log"/>

</jms:listener-container>

下表描述了所有可用属性。请参阅类级 javadoc 的AbstractMessageListenerContainer及其具体子类，以获取有关各个属性的更多详细信息。javadoc 还讨论了事务选择和消息重新传递方案。spring-doc.cadn.net.cn

表 2.JMS <listener-container> 元素的属性
属性	描述
`container-type`spring-doc.cadn.net.cn	此侦听器容器的类型。可用选项包括`default`,`simple`,`default102`或`simple102`（默认选项为`default`).spring-doc.cadn.net.cn
`container-class`spring-doc.cadn.net.cn	作为完全限定类名的自定义侦听器容器实现类。默认值是 Spring 的标准`DefaultMessageListenerContainer`或`SimpleMessageListenerContainer`，根据`container-type`属性。spring-doc.cadn.net.cn
`factory-id`spring-doc.cadn.net.cn	将此元素定义的设置公开为`JmsListenerContainerFactory`替换为指定的`id`以便它们可以与其他终端节点重复使用。spring-doc.cadn.net.cn
`connection-factory`spring-doc.cadn.net.cn	对 JMS 的引用`ConnectionFactory`bean（默认 bean 名称为`connectionFactory`).spring-doc.cadn.net.cn
`task-executor`spring-doc.cadn.net.cn	对 Spring 的引用`TaskExecutor`对于 JMS 侦听器调用程序。spring-doc.cadn.net.cn
`destination-resolver`spring-doc.cadn.net.cn	对`DestinationResolver`解析 JMS 的策略`Destination`实例。spring-doc.cadn.net.cn
`message-converter`spring-doc.cadn.net.cn	对`MessageConverter`将 JMS 消息转换为侦听器的策略 method 参数。默认值为`SimpleMessageConverter`.spring-doc.cadn.net.cn
`error-handler`spring-doc.cadn.net.cn	对`ErrorHandler`处理任何未捕获的异常的策略可能发生在执行`MessageListener`.spring-doc.cadn.net.cn
`destination-type`spring-doc.cadn.net.cn	此侦听器的 JMS 目标类型：`queue`,`topic`,`durableTopic`,`sharedTopic`, 或`sharedDurableTopic`.这可能会启用`pubSubDomain`,`subscriptionDurable`和`subscriptionShared`属性。默认值为`queue`（这会禁用这三个属性）。spring-doc.cadn.net.cn
`response-destination-type`spring-doc.cadn.net.cn	响应的 JMS 目标类型：`queue`或`topic`.默认值是`destination-type`属性。spring-doc.cadn.net.cn
`client-id`spring-doc.cadn.net.cn	此侦听器容器的 JMS 客户端 ID。您必须在使用 Durable Subscriptions 的 Durable Subscriptions 中。spring-doc.cadn.net.cn
`cache`spring-doc.cadn.net.cn	JMS 资源的缓存级别：`none`,`connection`,`session`,`consumer`或`auto`.默认情况下（`auto`），则缓存级别实际上是`consumer`除非已指定外部事务管理器 — 在这种情况下，有效的 default 将为`none`（假设 Jakarta EE 风格的事务管理，其中给定的 ConnectionFactory 是 XA 感知池）。spring-doc.cadn.net.cn
`acknowledge`spring-doc.cadn.net.cn	本机 JMS 确认模式：`auto`,`client`,`dups-ok`或`transacted`.一个值之`transacted`激活本地事务处理`Session`.作为替代方法，您可以指定这`transaction-manager`属性，稍后在表中描述。默认值为`auto`.spring-doc.cadn.net.cn
`transaction-manager`spring-doc.cadn.net.cn	对外部`PlatformTransactionManager`（通常基于 XA 事务协调器，例如 Spring 的`JtaTransactionManager`).如果未指定，则使用本机确认（请参阅`acknowledge`属性）。spring-doc.cadn.net.cn
`concurrency`spring-doc.cadn.net.cn	每个侦听器要启动的并发会话或使用者的数量。它可以是一个表示最大数字的简单数字（例如`5`）或指示下限和上限（例如`3-5`).请注意，指定的最小值只是一个提示，并且可能会在运行时被忽略。默认值为`1`.您应该将并发性限制为`1`在主题侦听器的大小，或者队列排序很重要。考虑将其提高为通用队列。spring-doc.cadn.net.cn
`prefetch`spring-doc.cadn.net.cn	要加载到单个会话中的最大消息数。请注意，引发此 number 可能会导致并发使用者不足。spring-doc.cadn.net.cn
`receive-timeout`spring-doc.cadn.net.cn	用于接收调用的超时（以毫秒为单位）。默认值为`1000`（一 second）。`-1`表示无超时。spring-doc.cadn.net.cn
`back-off`spring-doc.cadn.net.cn	指定`BackOff`用于计算恢复间隔的实例尝试。如果`BackOffExecution`implementation 返回`BackOffExecution#STOP`, 侦听器容器不会进一步尝试恢复。这`recovery-interval`值（value）时，将忽略此属性。默认值为`FixedBackOff`跟间隔为 5000 毫秒（即 5 秒）。spring-doc.cadn.net.cn
`recovery-interval`spring-doc.cadn.net.cn	指定恢复尝试之间的间隔（以毫秒为单位）。它提供了一个方便的创建`FixedBackOff`替换为指定的间隔。为了更多的恢复选项中，请考虑指定`BackOff`实例。默认值为 5000 毫秒（即 5 秒）。spring-doc.cadn.net.cn
`phase`spring-doc.cadn.net.cn	此容器应在其中启动和停止的生命周期阶段。较低的值，则此容器启动得越早，停止得越晚。默认值为`Integer.MAX_VALUE`，这意味着容器会尽可能晚地开始，并在尽快。spring-doc.cadn.net.cn

使用jmsschema 支持非常相似，如下例所示：spring-doc.cadn.net.cn

<jms:jca-listener-container resource-adapter="myResourceAdapter"
		destination-resolver="myDestinationResolver"
		transaction-manager="myTransactionManager"
		concurrency="10">

	<jms:listener destination="queue.orders" ref="myMessageListener"/>

</jms:jca-listener-container>

下表介绍了 JCA 变体的可用配置选项：spring-doc.cadn.net.cn

表 3.JMS <jca-listener-container/> 元素的属性
属性	描述
`factory-id`spring-doc.cadn.net.cn	将此元素定义的设置公开为`JmsListenerContainerFactory`替换为指定的`id`以便它们可以与其他终端节点重复使用。spring-doc.cadn.net.cn
`resource-adapter`spring-doc.cadn.net.cn	对 JCA 的引用`ResourceAdapter`bean（默认 bean 名称为`resourceAdapter`).spring-doc.cadn.net.cn
`activation-spec-factory`spring-doc.cadn.net.cn	对`JmsActivationSpecFactory`.默认值是自动检测 JMS provider 及其`ActivationSpec`类（请参阅`DefaultJmsActivationSpecFactory`).spring-doc.cadn.net.cn
`destination-resolver`spring-doc.cadn.net.cn	对`DestinationResolver`解析 JMS 的策略`Destinations`.spring-doc.cadn.net.cn
`message-converter`spring-doc.cadn.net.cn	对`MessageConverter`将 JMS 消息转换为侦听器的策略 method 参数。默认值为`SimpleMessageConverter`.spring-doc.cadn.net.cn
`destination-type`spring-doc.cadn.net.cn	此侦听器的 JMS 目标类型：`queue`,`topic`,`durableTopic`,`sharedTopic`. 或`sharedDurableTopic`.这可能会启用`pubSubDomain`,`subscriptionDurable`, 和`subscriptionShared`属性。默认值为`queue`（这会禁用这三个属性）。spring-doc.cadn.net.cn
`response-destination-type`spring-doc.cadn.net.cn	响应的 JMS 目标类型：`queue`或`topic`.默认值是`destination-type`属性。spring-doc.cadn.net.cn
`client-id`spring-doc.cadn.net.cn	此侦听器容器的 JMS 客户端 ID。使用 Durable Subscriptions 的 Durable Subscriptions 中。spring-doc.cadn.net.cn
`acknowledge`spring-doc.cadn.net.cn	本机 JMS 确认模式：`auto`,`client`,`dups-ok`或`transacted`.一个值之`transacted`激活本地事务处理`Session`.作为替代方法，您可以指定这`transaction-manager`属性。默认值为`auto`.spring-doc.cadn.net.cn
`transaction-manager`spring-doc.cadn.net.cn	对 Spring 的引用`JtaTransactionManager`或`jakarta.transaction.TransactionManager`为每个 incoming message 的 intent 语句。如果未指定，则使用本机确认（请参阅`acknowledge`属性）。spring-doc.cadn.net.cn
`concurrency`spring-doc.cadn.net.cn	每个侦听器要启动的并发会话或使用者的数量。它可以是表示最大数字（例如`5`）或指示下限和上限（例如`3-5`).请注意，指定的最小值只是一个 hint 中，当您使用 JCA 侦听器容器时，通常会在运行时忽略该 Hint 的 TRICK 容器。默认值为 1。spring-doc.cadn.net.cn
`prefetch`spring-doc.cadn.net.cn	要加载到单个会话中的最大消息数。请注意，引发此 number 可能会导致并发使用者不足。spring-doc.cadn.net.cn