WebLogic JMS .NET クライアントの概要

以下の節では WebLogic JMS .NET クライアントの概要を示し、JMS .NET クライアントアプリケーションから WebLogic JMS リソースにアクセスする方法について解説します。また、WebLogic JMS .NET API についても簡単に説明します。

ここでは、.NET のプログラミングおよび JMS 1.1 の概念と機能に精通している読者を対象としています。

WebLogic JMS .NET クライアントとは

WebLogic JMS .NET クライアントは完全に管理された .NET 実行時ライブラリとアプリケーションプログラミングインタフェース (API) です。このクライアントを使用すると、プログラマは WebLogic Java Message Service (JMS) のアプリケーションとリソースにアクセスできる .NET C# クライアントアプリケーションを作成できます。

WebLogic JMS は JMS 1.1 仕様を完全にサポートするエンタープライズレベルのメッセージングシステムであり、標準の JMS API に加えて、多数の WebLogic JMS 拡張機能も提供しています。WebLogic JMS の機能を理解するには、edocs Web サイトの「Oracle WebLogic Server 10g リリース 3 メッセージング」を参照してください。WebLogic Server の付加価値 JMS 機能の概要については、『WebLogic JMS のコンフィグレーションと管理』の「WebLogic Server の付加価値 JMS 機能」を参照してください。

サポートされる JMS の機能

標準の JMS 1.1 仕様のサポートに加えて、WebLogic JMS .NET クライアントはいくつかの WebLogic JMS 拡張機能もサポートしています。サポートされる機能の詳細と JMS .NET クライアントでの使用方法については、「WebLogic JMS 拡張機能の使用」を参照してください。

メッセージングモデル

WebLogic JMS .NET クライアントは以下のメッセージングモデルをサポートしています。

メッセージタイプ

WebLogic JMS .NET クライアントは JMS 1.1 仕様で定義されている以下のメッセージタイプをサポートします。

WebLogic JMS で提供されている XMLMessage タイプの拡張機能はこのリリースではサポートされていません。このタイプのメッセージを .NET クライアントで受信した場合は、自動的に TextMessage タイプに変換されます。

WebLogic JMS .NET クライアントの仕組み

次の図では、.NET Framework CLR で実行される JMS .NET クライアントアプリケーションが WebLogic Server にデプロイされている JMS リソースにアクセスする仕組みを示します。

JMS サーバへのトラフィックは常に、.NET クライアントから JMS .NET クライアントホストを通じて接続ホストへ、さらに JMS サーバへとルーティングされます。JMS .NET クライアントへのトラフィックは常に、JMS サーバから接続ホストへ、さらに JMS .NET クライアントホストを通じて .NET クライアントへとルーティングされます。

図 1-1 に示したような、JMS .NET クライアントと JMS サーバの間のメッセージ交換のプロセスを簡単にまとめると、以下のようになります。

WebLogic Server のコンフィグレーション

以下の節では、JMS .NET クライアントアプリケーションが JMS リソースにアクセスするために必要なコンフィグレーションについて説明します。

リスンポートのコンフィグレーション

JMS .NET クライアントでは、JMS .NET クライアントホストをホストしている WebLogic Server インスタンスで、T3 プロトコル用にコンフィグレーションされたリスンポートが有効になっている必要があります。WebLogic Server をインストールしたときに、デフォルトポートは T3 プロトコルを使用するようにコンフィグレーションされます。デフォルトポートのコンフィグレーションは変更したり無効にしたりできるため、システム管理者はサーバのデフォルトポートで T3 プロトコルが有効になっていることを確認するか、T3 プロトコルをサポートするネットワークチャネルを追加する必要があります。コンフィグレーション情報については、以下のトピックを参照してください。

JMS .NET クライアント用の JMS リソースのコンフィグレーション

JMS .NET クライアントアプリケーションが WebLogic Server にデプロイされている JMS リソースにアクセスする前に、WebLogic Server システム管理者は必要な JMS リソース (接続ファクトリ、JMS サーバ、送り先など) をコンフィグレーションしておく必要があります。JMS リソースのコンフィグレーション手順については、以下を参照してください。

以前のリリースの WebLogic Server との相互運用

JMS .NET クライアントは WebLogic Server 10g リリース 3 以降とのみ直接通信できます。図 1-2 に示すように、JMS .NET クライアントホストは WebLogic Server 10g リリース 3 以降で実行する必要がありますが、接続ホストと JMS サーバは WebLogic Server 8.1 以降で実行できます。接続ホストと JMS サーバは両方とも同じクラスタ内に配置する必要があります。

送り先が WebLogic Server 8.1 以降で実行されていて、WebLogic Server 10g リリース 3 以降で実行されている .NET クライアントホストと同じクラスタ内にない場合、その送り先にアクセスするには、WebLogic Server のリモートインスタンスを外部サーバとしてコンフィグレーションする必要があります。詳細については、『WebLogic JMS のコンフィグレーションと管理』の「外部サーバリソースからサードパーティ JMS プロバイダへのアクセスのコンフィグレーション」を参照してください。

WebLogic JMS .NET API について

以下の表では、JMS .NET クライアントアプリケーションの作成に使用できる JMS .NET API の主要なクラスとインタフェースを示します。JMS .NET API のすべてのクラスとインタフェースの詳細については、.NET クライアントの WebLogic メッセージング API リファレンスを参照してください。

表 1-1 WebLogic JMS .NET のクラスとインタフェース
インタフェース/クラス	説明
`Constants`	`Constants` のクラス群は、API で一般的に使用される定数や列挙値を定義するために使用する。
`ContextFactory`	`ContextFactory` はコンテキストの作成に使用する。コンテキストは、.NET クライアントからクライアントホストへのネットワーク接続。
`IContext`	`IContext` オブジェクトは .NET クライアントからクライアントホストへのネットワーク接続を表現する。送り先や接続ファクトリのルックアップ、不要になったネットワーク接続のクローズに使用される。
`IConnectionFactory`	`IConnectionFactory` オブジェクトは JMS 接続コンフィグレーション情報をカプセル化する。JMS .NET クライアントは `IContext` オブジェクトを使用して接続ファクトリをルックアップし、その接続ファクトリを使用して JMS サーバとの `IConnection` を作成する。
`IConnection`	`IConnection` オブジェクトは JMS .NET クライアントホストと JMS 接続ホストの間のアクティブな接続。接続の作成時に認証が行われる場合もある。接続はセッションを作成するために使用する。
`ISession`	`ISession` オブジェクトはメッセージを生成および消費するためのシングルスレッドのエンティティ。セッションでは複数のメッセージプロデューサとコンシューマを作成して処理できる。
`IDestination`	`IDestination` オブジェクトはキューかトピックかを識別する。キュー送り先ではポイントツーポイントメッセージングモデルから、トピック送り先では pub/sub メッセージングモデルから配信されるメッセージを管理する。
`ITopic`	`ITopic` オブジェクトは、プロバイダ固有のトピック名をカプセル化した pub/sub の `IDestination`。クライアントがトピックの ID を JMS API メソッドに指定する方法となる。`IDestination` をパラメータとして使用するメソッドでは、`ITopic` オブジェクトを引数として使用できる。たとえば、以下のメソッドを呼び出すと、`ITopic` を使用して `IMessageConsumer` と `IMessageProducer` を作成できる。 `ISession.CreateConsumer(IDestination destination)` `ISession.CreateProducer(IDestination destination)`
`IQueue`	`IQueue` オブジェクトは、プロバイダ固有のキュー名をカプセル化したポイントツーポイントの `IDestination`。クライアントがキューの ID を JMS API メソッドに指定する方法となる。 `IQueue` と `ITopic` は両方とも `IDestination` を継承しているため、`IDestination` をパラメータとして使用するメソッドでは、`IQueue` オブジェクトを引数として使用できる。たとえば、以下のメソッドを呼び出すと、`IQueue` を使用して `IMessageConsumer` と `IMessageProducer` を作成できる。 `ISession.CreateConsumer(IQueue queue)` `ISession.CreateProducer(IQueue queue)`
`IMessageConsumer`	JMS .NET クライアントは `IMessageConsumer` オブジェクトを使用して、送り先からメッセージを受信する。`IMessageConsumer` オブジェクトを作成するには、セッションで提供されるメッセージコンシューマ作成メソッドに `IDestination` オブジェクトを渡す。
`IMessageProducer`	JMS .NET クライアントは `IMessageProducer` オブジェクトを使用して、送り先にメッセージを送信する。`IMessageProducer` オブジェクトを作成するには、セッションで提供されるメッセージプロデューサ作成メソッドに `IDestination` オブジェクトを渡す。
`IMessage`	`IMessage` インタフェースはすべての JMS メッセージのルートインタフェース。すべてのメッセージで使用されるメッセージヘッダと確認応答メソッドを定義する。 JMS メッセージは以下の部分から構成される。ヘッダ - すべてのメッセージは同じヘッダフィールドのセットをサポートする。ヘッダフィールドには、メッセージの識別やルーティングのためにクライアントとプロバイダの両方で使用される値が格納される。プロパティ - 各メッセージには、アプリケーション定義のプロパティ値をサポートするための組み込みの機能が含まれている。プロパティは、アプリケーション定義のメッセージフィルタリングをサポートするための効率的なメカニズムを提供する。本文 - JMS API では複数のタイプのメッセージ本文を定義している。現在使用されている主要なメッセージング方式に対応している。
`IMapMessage`	`IMapMessage` オブジェクトは名前と値のペアを送信するために使用する。名前は String オブジェクト、値は Java および C# プログラミング言語のプリミティブデータ型。名前には必ず値が必要であり、値を null や空の文字列にすることはできない。このエントリには、名前を指定して順次的またはランダムにアクセスできる。エントリの順序は定義されない。`IMapMessage` は `IMessage` インタフェースを継承し、マップを格納するメッセージ本文を追加したもの。
`IObjectMessage`	`IObjectMessage` オブジェクトは Java および C# プログラミング言語のシリアライズ可能なオブジェクトを格納したメッセージを送信するために使用する。`IMessage` インタフェースを継承し、オブジェクトの 1 つの参照を格納した本文を追加したもの。C# オブジェクトを Java プログラムから、または Java オブジェクトを C# プログラムから読み込むことはできない。詳細については、「異なる言語環境間でのメッセージの交換」を参照。
`IStreamMessage`	`IStreamMessage` オブジェクトは Java プログラミング言語のプリミティブ型のストリームを送信するために使用する。格納と読み取りは順次的に行われる。`IMessage` インタフェースを継承し、ストリームのメッセージ本文を追加したもの。メソッドは主に `java.io.DataInputStream` と `java.io.DataOutputStream` のメソッドに基づいている。
`ITextMessage`	`ITextMessage` オブジェクトは `String` を格納したメッセージを送信するために使用する。`IMessage` インタフェースを継承し、テキストのメッセージ本文を追加したもの。
`IBytesMessage`	`IBytesMessage` オブジェクトは未解釈のバイトストリームを格納したメッセージを送信するために使用する。`IMessage` インタフェースを継承し、バイトのメッセージ本文を追加したもの。メッセージの受信側でバイトの解釈を行う。

Microsoft .NET 対応の WebLogic JMS クライアントの使用