WebLogic JMS .NETクライアント・ライブラリのインストールおよびコピー

2 WebLogic JMS .NETクライアント・ライブラリのインストールおよびコピー

この章では、WebLogic ServerプラットフォームにインストールされているJMS .NETクライアント・コンポーネントについて説明します。インストール先の場所と.NET Frameworkマシンへのコピー方法も示します。

この章の内容は次のとおりです。

WebLogic JMS .NETクライアントのインストール

WebLogic JMS .NETクライアントはWebLogic Server 10gリリース3以降にバンドルされています。(Windows以外のプラットフォームを含む)サポート対象のプラットフォーム上でWebLogic Serverの完全なインストールを実行すると、WebLogic JMS .NETクライアントがデフォルトでインストールされます。カスタム・インストール・オプションを選択した場合は、WebLogic ServerのWebLogic Serverクライアント・コンポーネントが選択されていることを確認してください。このコンポーネントを選択解除した場合、WebLogic JMS .NETクライアントはインストールされません。

WebLogic Serverのサポート対象プラットフォームのリストについては、「Oracle Fusion Middlewareでサポートされるシステム構成」を参照してください。

WebLogic Serverのインストールの詳細は、『Oracle WebLogic ServerおよびCoherenceのインストールと構成』を参照してください。

親トピック: WebLogic JMS .NETクライアント・ライブラリのインストールおよびコピー

インストールされたコンポーネントの場所

WebLogic JMS .NETクライアントは、次の2つのディレクトリのOracle WebLogic Serverインストールに含まれています。これらのディレクトリには、ライブラリのバージョン1とバージョン2がそれぞれ含まれています。

ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient

ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient_v2

ORACLE_HOMEは、インストール・プロセス中にユーザーが選択した最上位のインストール・ディレクトリです。バージョン1とバージョン2ディレクトリの違いについては、「インストール・バージョンの選択」を参照してください。

DLLファイルとPDBファイルは、次の2つの各ディレクトリに含まれています。

WebLogic.Messaging.dll - JMSクライアント・アプリケーションでクライアントが使用する、完全に管理されたJMS .NETクライアント・ライブラリ。
WebLogic.Messaging.pdb - JMS .NETクライアント・アプリケーションをデバッグするために、クライアントがWebLogic.Messaging.dllと一緒に使用できるJMS .NETクライアント・ライブラリのデバッグ・バージョン。

また、バージョン1ディレクトリにはjms.dotnet.api.zipファイルも含まれます。このファイルには、バージョン1とバージョン2の両方に適用可能なWebLogic JMS .NET APIのHTMLおよびWindowsヘルプ・スタイルのドキュメントが含まれています。『Oracle WebLogic ServerのためのMicrosoft .NETメッセージングAPI』を参照してください。

親トピック: WebLogic JMS .NETクライアントのインストール

インストール・バージョンの選択

次の表に、各.Net JMSクライアント・バージョンでサポートされているアプリケーション、.Net環境およびOSプラットフォームを示します。

ライブラリ・バージョンライブラリの場所アプリケーション .Netバージョン OSプラットフォーム

ライブラリ・バージョン	ライブラリの場所	アプリケーション	.Netバージョン	OSプラットフォーム
バージョン1	`ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient`	.Net Framework	.Net Framework 2.0から.Net Framework 3.5 .Net framework 4.8	Windows
バージョン1*	`ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient`	.Net Core	.Net Core 3.1および.Net 5.0	WindowsおよびLinux
バージョン2**	`ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient_v2`	.Net Core	.Net Core 3.1および.Net 5.0	WindowsおよびLinux

バージョン1

ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient

.Net Framework

.Net Framework 2.0から.Net Framework 3.5

.Net framework 4.8

Windows

バージョン1*

ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient

.Net Core

.Net Core 3.1および.Net 5.0

WindowsおよびLinux

バージョン2**

ORACLE_HOME/wlserver/modules/com.bea.weblogic.jms.dotnetclient_v2

.Net Core

.Net Core 3.1および.Net 5.0

WindowsおよびLinux

ノート:

WebLogic JMS .Net Client DLLのバージョン番号は、DLLにファイル・プロパティとして埋め込まれ、値形式は'N.N.N.N'です。上記の表で'1.N.N.N'はバージョン1に対応し、'2.N.N.N'はバージョン2に対応しています。DLLのファイル・プロパティを取得する1つの方法は、Windowsファイル・エクスプローラ内からファイルを右クリックすることです。
(*) .Net Coreアプリケーションではバージョン1ライブラリを使用できますが、Oracleでは、.Net Coreアプリケーションでバージョン2ライブラリを使用することをお勧めします。ただし、なんらかの理由により.Net Coreアプリケーションでバージョン1を使用する必要がある場合は、次の点に注意してください。
- アプリケーション構成ファイルの<system.diagnostics>部分が.Net Coreでサポートされていないため、app.configのクライアント側のロギングおよびデバッグ設定は適用されません。「ロギングとデバッグの構成」を参照してください。
- System.Configuration.ConfigurationManagerに関するランタイム・エラーが発生する場合があります。例:
```
WebLogic.Messaging.MessageException: Problem creating context
```
```
System.IO.FileNotFoundException: Could not load file or assembly 'System.Configuration.ConfigurationManager, Version=4.0.3.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51'. The system cannot find the file specified.
```
  このようなエラーは、Visual StudioのManage NuGetパッケージを使用してプロジェクトにSystem.Configuration.ConfigurationManagerパッケージをインストールするか、次の例に示すように.csprojファイルにパッケージを直接追加することで解決できます。
```
<ItemGroup>

            <PackageReference Include="System.Configuration.ConfigurationManager" Version="6.0.0-preview.5.21301.5" />

       </ItemGroup>
```
(**) バージョン2ライブラリを使用する場合、アプリケーションは次のような追加のパッケージをインストールすることが必要な場合があります。
- System.Configuration.ConfigurationManager
- Microsoft.Extensions.Configuration
- Microsoft.Extensions.Configuration.Binder
- Microsoft.Extensions.Configuration.Json

親トピック: WebLogic JMS .NETクライアントのインストール

クライアント・マシンへのライブラリのコピー

サポート対象のプラットフォームにWebLogic Serverをインストールした後で、「インストールされたコンポーネントの場所」で示されたインストール・ディレクトリから、サポートされる.NETクライアント・マシン上の開発ディレクトリに、WebLogic.Messaging.dllライブラリをコピーする必要があります。また、.NETアプリケーションがそのライブラリを参照するようにする必要があります。JMS .NETクライアントは、完全に管理された実行時ライブラリであり、Microsoft .NET Frameworkを実行するWindowsプラットフォーム上でサポートされます。

Visual Studioを使用している場合は、次の手順に従うと、WebLogic.Messaging.dllを参照アセンブリとしてプロジェクトに追加できます。

「プロジェクト」を選択し、「参照」を選択します。
「参照の追加」を選択し、上記でコピーした.NETマシン上のディレクトリのWebLogic.Messaging.dllを指定します。

また、JMS .NETクライアント・ライブラリのデバッグ・バージョンであるWebLogic.Messaging.pdbとAPIドキュメントもクライアント・マシンにコピーできますが、必須ではありません。

親トピック: WebLogic JMS .NETクライアント・ライブラリのインストールおよびコピー