IBM MQ classes for JMS または IBM MQ classes for Jakarta Messaging を使用するためのモジュラー・アプリケーションの構成

[MQ 9.3.2 2023 年 2 月] アプリケーション内で適切なモジュールを要求し、適切なディレクトリーを module-path に含めることにより、 IBM® MQ classes for JMS および IBM MQ classes for Jakarta Messaging をモジュラー方式で使用できます。

モジュラー・パッケージ

IBM MQ classes for JMS および IBM MQ classes for Jakarta Messaging の統合 JAR ファイルは、自動モジュール名を提供します。これにより、JAR ファイル名から派生したデフォルト名が置き換えられます。

IBM MQ classes for JMS (com.ibm.mq.allclient.jar) には、 com.ibm.mq.javaxというモジュール名が用意されています。
IBM MQ classes for Jakarta Messaging (com.ibm.mq.jakarta.client.jar) には、 com.ibm.mq.jakartaというモジュール名が用意されています。

デフォルトの MQ_HOME/java/lib ディレクトリーは、モジュールが同じパッケージを含むことができず、デフォルト・ディレクトリーに複数の JAR 内の同じパッケージが含まれているため、モジュラー使用には適していません。そのため、JAR 間でパッケージを重複させずに、必要な JAR ファイルのみを含む新規ディレクトリーを使用できます。これらのディレクトリーは、 module-pathに組み込むのに適しています。

注: デフォルトのモジュール名に依存して、使用可能な JAR ファイルをモジュラー・コンテキストで使用するアプリケーションがある場合は、新しいモジュール名を必要とするようにアプリケーションを更新する必要があります。デフォルトのモジュール名は、JAR ファイル名から派生します。

IBM MQ classes for JMS を使用するためのモジュラー・アプリケーションの構成

以下のステップを実行して、 IBM MQ classes for JMS (com.ibm.mq.allclient.jar) を使用するようにモジュラー・アプリケーションを構成できます。

com.ibm.mq.javax モジュールを必要とするようにアプリケーションを構成します。
MQ_HOME/java/lib/modules/javax ディレクトリーを module-path に組み込むようにアプリケーションを構成します。

IBM MQ classes for Jakarta Messaging を使用するためのモジュラー・アプリケーションの構成

以下のステップを実行して、 IBM MQ classes for Jakarta Messaging (com.ibm.mq.jakarta.client.jar) を使用するようにモジュラー・アプリケーションを構成できます。

com.ibm.mq.jakarta モジュールを必要とするようにアプリケーションを構成します。
MQ_HOME/java/lib/modules/jakarta ディレクトリーを module-path に組み込むようにアプリケーションを構成します。

IBM MQ classes for Java を使用するためのモジュラー・アプリケーションの構成

IBM MQ classes for Java をモジュラー・アプリケーションから使用するには、両方のクライアント JAR ファイルが IBM MQ classes for Javaをサポートするため、 IBM MQ classes for JMS の構成または IBM MQ classes for Jakarta Messagingの構成のいずれかを使用できます。ただし、アプリケーションは、これらの構成の両方ではなく、いずれか 1 つのみを使用する必要があります。