標準送信アダプタ

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

標準送信アダプタは、単にアプリケーション・データをAdapterMessageオブジェクトの配列として受け入れます。各AdapterMessageオブジェクトは、Stringペイロードをラップします。したがって、StringペイロードをAdapterMessageオブジェクトにラップし、それらを配列にするコードを用意する必要があります。続いて、アダプタがAdapterMessage配列をエンキューします。カスタム動作が必要な場合は、独自のコードを作成し、エンキュー処理の前または後に適用します。アダプタのサブクラス化はできません。

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

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

メッセージの送信

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

  1. クライアント・コードで生成されたメソッドは、sendMessageメソッドをコールします。このメソッドは、プロパティ・ファイルの名前を決定し、プロパティを読み込み、アダプタを開始します。初期値が検証されます。いずれかの値が正しくない場合は、AdapterFailureExceptionがスローされます。値が正しい場合は、アダプタが開始します。
    final public void sendMessage(Object this_ref, AdapterMessage[] messages) throws AdapterFailureException
  2. sendMessageメソッドでは、AdapterMessage[]配列パラメータ内のメッセージが指定されたキューに一度にエンキューされます。

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

  3. すべてのメッセージが送信されると、制御がクライアント・コードに戻ります。

関連項目

メッセージ・アダプタの基本

標準送信アダプタ・クライアント・コードの生成

独自の標準送信アダプタ・クライアント・コードの作成

メッセージ・ペイロードのためのAdapterMessageクラスの使用