標準受信アダプタである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()メソッドのコールにより)アダプタが開始した後で何が行われるか、また受信リクエストがどのように処理されるかを説明します。詳細は、「標準受信アダプタ・クライアント・コードの生成」を参照してください。
final public AdapterMessage receiveMessage(Object this_ref) throws AdapterFailureException
データベースへの接続、セッションの作成、JMS接続などの送信プロセス中に例外が発生した場合は、AdapterFailureExceptionがスローされます。