7.24. 리소스 어댑터

JBEAP-503

IBM MQ 리소스 어댑터는 Queue.toString() 및 QueueBrowser.getQueue().toString() 메서드에 대해 다른 문자열 값을 반환합니다. queue은 Queue Browser. htmlQueueBrowser.getQueueBrowser.getQueue() 메서드에서 반환하는 com.ibm.mq.jms.MQQueue 클래스와 다른 com.ibm.mq.connector.outbound.MQQueue Proxy 클래스의 인스턴스입니다. 이러한 클래스에는 toString() 메서드의 다양한 구현이 포함됩니다. 이러한 toString() 메서드에 의존하여 동일한 값을 반환할 수 없습니다.

✔

JBEAP-511, JBEAP-550, JBEAP-3686

IBM MQ의 메시지 속성 이름에 다음과 같은 제한 사항이 적용됩니다.

메시지 속성 이름 제한 사항의 전체 목록은 IBM MQ, 버전 9.0 의 속성 이름 제한 사항을 참조하십시오.

✔

JBEAP-549

@ActivationConfigProperty 주석을 사용하여 Cryostat의 대상 속성 이름 값을 지정하는 경우 모든 대문자를 사용해야 합니다. 예를 들면 다음과 같습니다.

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

✔

JBEAP-624

IBM MQ 리소스 어댑터를 사용하여 @JMSConnectionFactoryDefinition 주석을 사용하여 Jakarta EE 배포에 연결 팩토리를 생성하는 데 사용되는 경우 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

< Cryostat -support>XATransaction</ Cryostat-support >가 설정되면 JMSContext 가 항상 JMSContext.SESSION_TRANSACTED 로 설정됩니다. 삽입을 사용하여 생성되었는지 여부에 관계없이 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 인터페이스는 게시/서브스크립션 도메인과 관련된 개체를 생성하는 데 사용할 수 없으며 Session 에서 상속하는 특정 메서드는 javax.jms.IllegalStateException 을 발생시켜야 합니다. 이러한 메서드 중 하나는 이러한 QueueSession.createTemporaryTopic() 입니다. IBM MQ 리소스 어댑터는 javax.jms.IllegalStateException 을 throw하는 대신 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 리소스 어댑터는 잘못된 인증 정보를 사용할 때 JMSSecurity Exception 대신 Detailed JMSException을 생성하고 서버 콘솔에 다음 오류를 기록합니다.

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, MessageProducer.send(Destination destination, int deliveryMode, int priority, long timeToLive, CompletionListener completionListener) 방법의 리소스 어댑터에서 잘못된 클래스 캐스트 변환으로 인해 IBM MQ 리소스 어댑터가 JMSException 을 생성하고 다음 오류 메시지를 서버 콘솔에 기록합니다.

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

컨테이너 관리 트랜잭션(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 헤더가 헤더 message.setJMSReplyTo(queue)를 사용하여 이름이 queue:///MYQUEUE 인 queue 로 설정되고 QM 이라는 큐 관리자가 있는 IBM MQ 9.3 브로커로 전송된 경우 해당 이름이 queue://QM/MYQUEUE 로 변경됩니다.

✔