7.24. 资源适配器

JBEAP-503

IBM MQ 资源适配器返回 Queue.toString （） 和 QueueBrowser.getQueue （）.toString （） 方法的不同 String 值。队列 是 com.ibm.mq.connector.outbound.MQQueueProxy 类的实例，它与 com.ibm.mq.jms.MQQueue 类不同，后者由 QueueBrowser.htmlQueueBrowser.getQueue （） 方法返回。这些类包含 toString （） 方法的不同实现。请注意，您无法依赖这些 toString （） 方法返回相同的值。

✔

JBEAP-511, JBEAP-550, JBEAP-3686

以下限制适用于 IBM MQ 的消息属性名称。

有关消息属性名称 限制的完整列表，请参阅 IBM 知识库网站上的 Property 名称 限制。

✔

JBEAP-549

使用 @ActivationConfigProperty 注释为 MDB 指定 destination 属性值时，您必须使用所有大写字母。例如：

@ActivationConfigProperty(propertyName = "destination", propertyValue = "QUEUE")

✔

JBEAP-624

如果使用 IBM MQ 资源适配器在 Jakarta EE 部署中使用 @JMSConnectionFactoryDefinition 注解创建连接工厂，您必须指定 resourceAdapter 属性。否则，部署将失败。

@JMSConnectionFactoryDefinition(
    name = "java:/jms/WMQConnectionFactory",
    interfaceName = "javax.jms.ConnectionFactory",
    resourceAdapter = "wmq.jmsra",
    properties = {
        "channel=<channel>",
        "hostName=<hostname_wmq_broker>",
        "transportType=<transport_type>",
        "queueManager=<queue_manager>"
    }
)

✔

JBEAP-2339

IBM MQ 资源适配器可以从队列和主题读取消息，即使在连接启动前也是如此。这意味着消费者可以在连接启动前使用消息。要避免遇到这个问题，请使用远程 IBM MQ 代理使用 external-context 而不是 IBM MQ 资源适配器创建的连接工厂。

✔

JBEAP-3685

设置了 <transaction-support>XATransaction</transaction-support > 后，一个 JMSContext 始终为 JMSContext.SESSION_TRANSACTED，无论是使用注入还是手动创建。

在以下代码示例中，@JMSSessionMode (JMSContext.DUPS_OK_ACKNOWLEDGE) 被忽略，JMSContext 仍然保持在 JMSContext.SESSION_TRANSACTED。

@Inject
@JMSConnectionFactory("jms/CF")
@JMSPasswordCredential(userName="myusername", password="mypassword")
@JMSSessionMode(JMSContext.DUPS_OK_ACKNOWLEDGE)
transient JMSContext context3;

✔

JBEAP-14633

根据 JMS 规范，QueueSession 接口无法用于创建特定于 publish/subscribe 域的对象，以及从 Session 继承的特定方法应抛出 javax.jms.IllegalStateException。一个这样的方法是 QueueSession.createTemporaryTopic （）。IBM MQ 资源适配器不抛出 javax.jms.IllegalStateException，而是抛出 java.lang.NullPointerException。

✔

JBEAP-14634

MQTopicProxy.getTopicName （） 返回不同的主题名称，而不是由 IBM MQ 代理设置。例如，如果主题名称被设置为 topic://MYTOPIC?XMSC_WMQ_BROKER_PUBQ_QMGR=QM，则 MQTopicProxy 返回 topic://MYTOPIC。

✔

JBEAP-14636

JMSContext 的默认 autoStart 设置为 false，这意味着在创建消费者时不自动启动 JMSContext 使用的底层连接。此设置应默认为 true。

✔

JBEAP-14640

当使用无效凭证时，IBM MQ 资源适配器会抛出 DetailedJMSException 而不是 JMSSecurityException，并将以下错误记录到服务器控制台。

WARN  [org.jboss.jca.core.connectionmanager.pool.strategy.PoolByCri] (EJB default - 7) IJ000604: Throwable while attempting to get a new connection: null: com.ibm.mq.connector.DetailedResourceException: MQJCA1011: Failed to allocate a JMS connection., error code: MQJCA1011 An internal error caused an attempt to allocate a connection to fail. See the linked exception for details of the failure.

以下是可能导致此问题的代码示例。

QueueConnection qc = queueConnectionFactory.createQueueConnection("invalidUserName", "invalidPassword");

✔

JBEAP-14642

由于 MQMessageProducer.send (Destination destination, Message message) 和 MQMessageProducer.send (Destination destination, Message message, int deliveryMode, int priority, CompletionListener completionListener) 方法中的资源适配器的无效类 cast 转换，并将以下错误消息记录到服务器控制台。

SVR-ERROR: Expected JMSException, received com.ibm.mq.connector.outbound.MQQueueProxy cannot be cast to com.ibm.mq.jms.MQDestination

这是因为队列或主题查找中使用的 JNDI 名称是 com.ibm.mq.connector.outbound.MQQueueProxy/MQTopicProxy。

✔

JBEAP-14643

JMSProducer 接口上的 setDeliveryDelay (expDeliveryDelay) 方法不会改变设置。调用此方法后，它保留在默认设置 0。

✔

JBEAP-14670

如果在 UserTransaction.begin （） 之前创建的 QueueSession 上完成工作，则该工作不被视为事务的一部分。这意味着，使用此会话发送到队列的任何消息都不会由 UserTransaction.commit （） 提交，在 UserTransaction.rollback （） 后，消息将保留在队列中。

✔

JBEAP-14675

如果您关闭连接，然后立即使用相同的 clientID 创建 JMSContext，IBM MQ 资源适配器会间歇性将以下错误记录到服务器控制台。

ERROR [io.undertow.request] (default task-1) UT005023: Exception handling request to /jmsServlet-1.0-SNAPSHOT/: com.ibm.msg.client.jms.DetailedJMSRuntimeException: MQJCA0002: An exception occurred in the IBM MQ layer. See the linked exception for details.
A call to IBM MQ classes for Java(tm) caused an exception to be thrown.

当与同一 clientID 的连接关闭后创建新的 JMSContext 时，不会出现这个问题。

✔

JBEAP-15535

如果有状态会话 bean 会尝试在容器管理事务(CMT)中发送消息到主题，则消息发送会失败，并显示以下信息：

SVR-ERROR: com.ibm.msg.client.jms.DetailedJMSException: JMSWMQ2007: Failed to send a message to destination 'MDB_NAME TOPIC_NAME'

堆栈追踪显示由以下异常导致的：

com.ibm.mq.MQException: JMSCMQ0001: IBM MQ call failed with compcode '2' ('MQCC_FAILED') reason '2072' ('MQRC_SYNCPOINT_NOT_AVAILABLE')

JBEAP-25561

当消息通过 JMSReplyTo 标头集发送到目的地时，会在到达 IBM MQ 9 代理后修改该消息。因此，响应的回复消息会被定向到修改后的 JMS_REPLY 标头中定义的目的地。

例如，如果 JMSReplyTo 标头被设置为队列，名称为 queue:///MYQUEUE，使用标头 message.setJMSReplyTo (queue); 并发送到名为 QM 的队列管理器的 IBM MQ 9.3 代理，其名称更改为 queue://QM/MYQUEUE。

✔