標準送信アダプタ

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

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

標準送信アダプタは、任意のJavaクラスから使用できます。 ビジネス・コンポーネント・コードへの依存性がないため、このアダプタは任意の場所で使用できます。 ビジネス・コンポーネント・アプリケーション・モジュールでも使用できますが、アプリケーション・モジュールのコンテキスト内で使用する場合はビジネス・コンポーネント送信アダプタがより優れた機能を提供します。

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

メッセージの送信

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

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

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

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

関連項目

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

 

Copyright © 1997, 2004, Oracle. All rights reserved.