Java: Changes to IBM MQ classes for Java

For IBM® MQ 8.0, an unwanted dependency on connector.jar has been removed and changes have been made to APIs for public classes.

Unwanted dependency on connector.jar has been removed

Using JCA causes an unwanted dependency on the connector.jar file, which has been removed. The effects of this removal are as follows:

  • javax.resource.ResourceException and its subclasses are no longer thrown or caught in the IBM MQ classes for Java. MQException is thrown in place of ResourceException.
  • javax.resource.spi.ConnectionRequestInfo is no longer used in the IBM MQ classes for Java. The MQConnectionRequestInfo abstract class and its subclasses are used in contexts where ConnectionRequestInfo was previously used.
  • javax.resource.spi.ConnectionManager is no longer used in the IBM MQ classes for Java. The MQConnectionManager interface is used in contexts where ConnectionRequestInfo was previously used.

Changes to APIs for public classes

  • com.ibm.mq.MQEnvironment:
    • The setDefaultConnectionManager(ConnectionManager) method has been removed.
    • The getDefaultConnectionManager() method now returns an MQConnectionManager.
  • com.ibm.mq.MQQueueManager:
    • The MQQueueManager(String, ConnectionManager) constructor has been removed. It is replaced by the existing MQQueueManager(String, MQConnectionManager) method.
    • The MQQueueManager(String, Hashtable, ConnectionManager) constructor has been removed. It is replaced by the existing MQQueueManager(String,Hashtable, MQConnectionManager) method.
    • The MQQueueManager(String, int, ConnectionManager) constructor has been removed. It is replaced by the existing MQQueueManager(String, int, MQConnectionManager) method.
  • com.ibm.mq.MQSimpleConnectionManager:
    • The allocateConnection(MQManagedConnectionFactory,ConnectionRequestInfo) method has been removed. It is replaced by the allocateConnection(MQManagedConnectionFactory,MQConnectionRequestInfo) method which throws MQException in place of ResourceException to indicate failure.
    • The createConnection(MQManagedConnectionFactory,ConnectionRequestInfo) method has been removed. It is replaced by the createConnection (MQManagedConnectionFactory,MQConnectionRequestInfo) method that throws MQException in place of ResourceException to indicate failure.
    • The recycleConnection(MQManagedConnectionFactory,ConnectionRequestInfo) method has been removed. It is replaced by the recycleConnection(MQManagedConnectionFactory,MQConnectionRequestInfo) method that throws MQException in place of ResourceException to indicate failure.

Changes to CipherSuite support

See Java and JMS: changes to CipherSuite support for further information.