第 31 章 JMS


支持生成者和消费者

此组件允许消息发送到(或从中消耗) JMS Queue 或 Topic。它使用 Spring 的 JMS 支持声明事务,包括用于发送的 Spring 的 JmsTemplateMessageListenerContainer 以供使用。

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 提供了很多选项来配置性能,以及集群环境。

31.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&…​

31.1.1. 使用 ActiveMQ

JMS 组件重复使用 Spring 2 的 JmsTemplate 来发送消息。这不是在非J2EE 容器中使用的理想的选择,通常需要 JMS 供应商中的一些缓存以避免 性能不佳

如果要使用 Apache ActiveMQ 作为您的消息代理,建议您进行以下操作之一:

  • 使用 ActiveMQ 组件,该组件已优化为高效地使用 ActiveMQ
  • 在 ActiveMQ 中使用 PoolingConnectionFactory

31.1.2. 事务和缓存级别

如果您使用消息并使用事务(transacted=true),缓存级别的默认设置可能会影响性能。

如果您使用 XA 事务,则无法缓存,因为它可能会导致 XA 事务无法正常工作。

如果您不使用 XA,那么您应该考虑缓存以加快性能,例如设置 cacheLevelName=CACHE_CONSUMER

cacheLevelName 的默认设置是 CACHE_AUTO。这个默认自动检测模式,并相应地设置缓存级别:

  • CACHE_CONSUMER if transacted=false
  • CACHE_NONE if transacted=true

因此,您可以说默认设置比较保守。如果您使用非 XA 事务,请考虑使用 cacheLevelName=CACHE_CONSUMER

31.1.3. 可写订阅

如果要使用持久主题订阅,则需要同时指定 clientIddurableSubscriptionNameclientId 的值必须是唯一的,且只能供整个网络中的单个 JMS 连接实例使用。您可能希望使用 Virtual Topics 来避免这个限制。此处 有关持久消息传递的更背景。

31.1.4. 消息标头映射

在使用消息标头时,JMS 规格指出标头名称必须是有效的 Java 标识符。因此,请尝试将您的标头命名为有效的 Java 标识符。执行此操作的一个优点是,您可以在 JMS Selector 中使用您的标头(其 SQL92 语法强制使用标头的 Java 标识符语法)。

默认使用映射标头名称的简单策略。策略是替换标头名称中的任何点和连字符,如下所示,并在标头名称从通过线发送的 JMS 消息中恢复时反向替换。这意味着什么?在 bean 组件上没有更多调用的方法名称,不再丢失 File 组件的文件名标头,以此类推。

接受 Camel 中的标头名称的当前标头名称策略如下:

  • 点被 'DOT' 替换,当 Camel 使用消息时,替换将被撤销
  • 连字符由 'HYPHEN' 替代,并在 Camel 使用消息时撤销替换

您可以在 JMS 端点上配置许多不同的属性,该端点映射到 JMSConfiguration 对象上的属性。

注意

映射到 Spring JMS
的许多属性映射到 Spring JMS 的属性,Camel 用来发送和接收信息。因此,您可以通过咨询相关的 Spring 文档来获取有关这些属性的更多信息。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.