第 26 章 JMS
支持制作者和使用者
此组件允许消息发送到 JMS 队列或主题。它使用 Spring 的 JMS 支持声明式事务，包括 Spring 的 JmsTemplate 用于 发送和接收消息ListenerContainer。
Maven 用户需要将以下依赖项添加到此组件的 pom.xml 中：
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-jms</artifactId>
<version>{CamelSBVersion}</version>
<!-- use the same version as your Camel core version -->
</dependency>
如果使用 ActiveMQ
，如果您正在使用 Apache ActiveMQ，您应该像 ActiveMQ 进行了优化时首选 ActiveMQ 组件。此页面上的所有选项和示例也对 ActiveMQ 组件有效。
如果您使用 JMS 的事务处理并缓存
，请参阅下面的部分交易和 缓存级别，因为它可能会影响性能。
请求/通过 JMS
，确保阅读本页中进一步的 Request-reply 一节，以获得有关请求/恢复的重要备注，因为 Camel 提供了多个选项来配置性能和集群环境。
26.1. URI 格式
jms:[queue:|topic:]destinationName[?options]
其中 destinationName 是 JMS 队列或主题名称。默认情况下，destinationName 解释为队列名称。例如，要连接到队列，FOO.BAR 使用：
jms:FOO.BAR
如果愿意，您可以包含可选的 queue: 前缀：
jms:queue:FOO.BAR
要连接到某个主题，您必须 包含 topic: 前缀。例如，要连接到主题，Stocks .Prices，请使用：
jms:topic:Stocks.Prices
您可以使用以下格式将查询选项附加到 URI 中，
?option=value&option=value&…
26.1.1. 使用 ActiveMQ
JMS 组件重复使用 Spring 2 的 JmsTemplate 来发送消息。这不是适用于非J2EE 容器的理想选择，通常需要 JMS 提供程序中的一些缓存来避免 性能不佳。
如果要将 Apache ActiveMQ 用作您的消息代理，则建议您进行以下操作之一：
- 使用 ActiveMQ 组件，该组件已优化为高效地使用 ActiveMQ
-
在 ActiveMQ 中使用
PoolingConnectionFactory。
26.1.2. 事务和缓存级别
如果您使用消息并使用事务(transacted=true)，则缓存级别的默认设置可能会影响性能。
如果您使用 XA 事务，那么您无法缓存，因为它可能会导致 XA 事务无法正常工作。
如果您不使用 XA，则应考虑缓存，因为它会加快性能，如设置 cacheLevelName=CACHE_CONSUMER。
cacheLevelName 的默认设置是 CACHE_AUTO。这个默认自动检测模式，并相应地设置缓存级别：
-
CACHE_CONSUMERiftransacted=false -
CACHE_NONEiftransacted=true
因此，您可以说默认设置比较保守。如果您使用非 XA 事务，请考虑使用 cacheLevelName=CACHE_CONSUMER。
26.1.3. 持久化订阅
如果要使用持久主题订阅，则需要指定 clientId 和 durableSubscriptionName。clientId 的值必须是唯一的，且只能供整个网络中的单个 JMS 连接实例使用。您可能更喜欢使用 Virtual Topics 来避免此限制。此处，有关可持久化消息传递的更多背景信息.
26.1.4. 消息标头映射
在使用消息标头时，JMS 规范指出标头名称必须是有效的 Java 标识符。因此，尝试将标头命名为有效的 Java 标识符。执行此操作的一个优点是，您可以在 JMS Selector 中使用您的标头（其 SQL92 语法强制使用标头的 Java 标识符语法）。
默认使用映射标头名称的简单策略。该策略是替换标头名称中的任何句点和连字符，如下方所示，并从通过线发送的 JMS 消息恢复标头名称时反向替换。这意味着什么？在 bean 组件上调用的更多方法名称，不再丢失 File 组件的文件名，以此类推。
Camel 中接受标头名称的当前标头名称策略如下：
- 点由 'DOT' 替代，当 Camel 使用消息时，会撤销替换点
- hyphen 被 'HYPHEN' 替代，当 Camel 使用消息时替换会被撤销
您可以在 JMS 端点上配置许多不同的属性，它映射到 JMSConfiguration 对象上的属性。
映射到这些属性的 Spring JMS
很多属性映射到 Spring JMS 上的属性，Camel 用来发送和接收信息。因此，您可以通过咨询相关的 Spring 文档来获取这些属性的更多信息。
