JMSConnectionFactoryProvider

说明

该 Controller Service 作为通用工厂服务，提供厂商特定的 javax.jms.ConnectionFactory 实例。它允许用户配置厂商特定的属性， 并指向厂商提供的 JMS 客户端库的位置，以便能找到、加载、实例化 javax.jms.ConnectionFactory 的正确实现，并提供给依赖它的 Processor（参见 PublishJMS、ConsumeJMS）。

只要配置值可以通过 set 方法设置（详见最后一段），所有 JMS 厂商和 ConnectionFactory 实现都受支持。不过，对以下 JMS 厂商做了一些便利适配：

• Apache ActiveMQ
• IBM MQ
• TIBCO EMS
• Qpid JMS (AMQP 1.0)

该 Controller Service 只暴露一个所有实现都必需的强制静态配置 属性。其余配置属性要么是可选的，要么是厂商特定的。

强制配置属性为：

• JMS Connection Factory Implementation - JMS ConnectionFactory 实现类的全限定名。例如：
  • Apache ActiveMQ - org.apache.activemq.ActiveMQConnectionFactory
  • IBM MQ - com.ibm.mq.jms.MQQueueConnectionFactory
  • TIBCO EMS - com.tibco.tibjms.TibjmsQueueConnectionFactory
  • Qpid JMS (AMQP 1.0) - org.apache.qpid.jms.JmsConnectionFactory

以下静态配置属性是可选的，但在许多情况下是必需的：

• JMS Client Libraries - 要添加到 classpath 的附加资源（例如 JAR、配置文件等）所在目录的路径（定义为逗号分隔的值列表）。 这些资源通常代表 ConnectionFactory 实现的目标 JMS 客户端库。
• JMS Broker URI - 指向 JMS 消息代理网络位置的 URI。例如：
  • Apache ActiveMQ - 单代理为 tcp://myhost:1234，多代理为 failover:(tcp://myhost01:1234,tcp://myhost02:1234)。
  • IBM MQ - 单代理为 myhost(1234)，多代理为 myhost01(1234),myhost02(1234)。
  • TIBCO EMS - 单代理为 tcp://myhost:1234，多代理为 tcp://myhost01:7222,tcp://myhost02:7222。
  • Qpid JMS (AMQP 1.0) - 单代理为 amqp[s]://myhost:1234， 多代理为 failover:(amqp[s]://myhost01:1234,amqp[s]://myhost02:1234)。

其余厂商特定的配置通过动态属性设置，采用 Java Beans 约定：属性名派生自厂商特定 ConnectionFactory 实现的 set 方法。例如，com.ibm.mq.jms.MQConnectionFactory.setChannel(String) 对应 'channel' 属性， com.ibm.mq.jms.MQConnectionFactory.setTransportType(int) 对应 'transportType' 属性。可用属性列表请查阅厂商提供的文档。 以下是此类厂商文档示例：

• Apache ActiveMQ
• IBM MQ
• TIBCO EMS
• Qpid JMS (AMQP 1.0)

除了上一节描述的动态属性和 set 方法，某些提供者还支持通过 Broker URI（以查询参数形式添加到 URI）进行额外配置：

• Qpid JMS (AMQP 1.0)

IBM MQ 的 Controller Service 配置示例