標準受信アダプタ

標準受信アダプタであるoracle.bm.ebiadapters.BasicReceivingAdapterは、Oracle AQからのメッセージのデキューに使用します。このアダプタが受信するメッセージはXMLである必要はありません。これらのメッセージは、java.lang.Stringとして表すことができるかぎり、内容は任意です。

標準受信アダプタは、AdapterMessageオブジェクトをキューからデキューするだけです。メッセージ・ペイロードのアンラップまたは任意のカスタム動作が必要な場合は、独自のコードを作成し、デキュー処理の前または後に適用します。アダプタのサブクラス化はできません。

標準受信アダプタは、任意のJavaクラスから使用できます。Business Components for Javaコードへの依存性がないため、このアダプタはどこででも使用できます。Business Components for Javaアプリケーション・モジュールでも使用できますが、Business Components for Java受信アダプタで提供される優れた機能が必要なアプリケーション・モジュールのコンテキストで使用する場合が多く見られます。

アクティビティ・モデラーで、アダプタを初期化および開始するための標準受信アダプタ・クライアント・コードを生成することも、独自のクライアント・コードを作成することもできます。その後、アダプタの使用時にアダプタ・クライアント・コードをコールするための独自のコードを作成する必要があります。

メッセージの受信

次の手順では、標準受信アダプタのコール・スタックについて説明します。この手順で、(receiveMessage()メソッドのコールにより)アダプタが開始した後で何が行われるか、また受信リクエストがどのように処理されるかを説明します。詳細は、「標準受信アダプタ・クライアント・コードの生成」を参照してください。

  1. クライアント・コードで生成されたメソッドは、receiveMessageメソッドをコールします。このメソッドは、プロパティ・ファイルの名前を決定し、プロパティを読み込み、アダプタを開始します。初期値が検証されます。いずれかの値が正しくない場合は、AdapterFailureExceptionがスローされます。値が正しい場合は、アダプタが開始します。
    final public AdapterMessage  receiveMessage(Object this_ref) throws AdapterFailureException
  2. receiveMessage内でAdapterMessageオブジェクトがデキューされます。必要に応じて、メソッドはメッセージ・オブジェクトの到着を待機します。

    データベースへの接続、セッションの作成、JMS接続などの送信プロセス中に例外が発生した場合は、AdapterFailureExceptionがスローされます。

  3. メッセージのデキュー後、制御がreceiveMessageメソッドに戻ります。
  4. receiveMessageメソッドは、制御をクライアント・コードに戻します。

関連項目

メッセージ・アダプタの基本
標準受信アダプタ・クライアント・コードの生成
独自の標準受信アダプタ・クライアント・コードの作成
メッセージ・ペイロードのためのAdapterMessageクラスの使用