| Oracle Fusion Middleware Oracle SOA Suite開発者ガイド 11g リリース1（11.1.1） B56238-01 |
|
 戻る |
 次へ |
この章では、Oracle Mediator（メディエータ）の概要を示し、Oracle Mediatorサービス・コンポーネントの作成方法についても説明します。
項目は次のとおりです。
Oracle Mediatorは、軽量なフレームワークを提供し、コンポジット・アプリケーション内の様々なコンポーネントを仲介します。 また、様々なコンポーネントで公開される様々なインタフェース間での通信が容易になるようにデータを変換します。これらのコンポーネントは接続されて、SOAコンポジット・アプリケーションが構築されます。たとえば、メディエータでは、アプリケーションまたはサービスからテキスト・ファイルに格納されたデータを受け入れ、顧客リポジトリとして使用するデータベースの更新に適した書式に変換し、変換したデータをそのデータベースにルーティングおよび配信できます。
Oracle Mediatorによって、イベントとサービス間の統合が容易になり、この統合によって、サービスの起動とイベントの組合せや調整が可能となります。メディエータ・コンポーネントを使用すると、ビジネス・イベントを処理したり、サービスの起動を受信することができます。 また、ルーティング・ルールの評価、トランスフォーメーションの実行、検証を行い、別のサービスを起動したり、別のビジネス・イベントを発生させることができます。メディエータ・コンポーネントを使用すると、返されたレスポンス、コールバック、フォルトおよびタイムアウトを処理できます。
この項では、Oracle Mediator機能の概要を説明します。
コンテンツ・ベースおよびヘッダー・ベースのルーティング
Oracle Mediatorでは、メッセージ・ペイロードまたはメッセージ・ヘッダーに基づいたルールの設定がサポートされています。 メッセージ・ペイロードまたはメッセージ・ヘッダーから要素または属性を選択し、その値に基づいてアクションを指定できます。たとえば、メディエータで、新規顧客に関するデータが含まれているファイルをアプリケーションまたはサービスから受信したとします。 顧客の住所に記載されている国に基づいて、その特定の国に関するデータが格納されているデータベースにデータをルーティングおよび配信できます。同様に、メッセージ・ヘッダーに基づいてメッセージをルーティングできます。
ヘッダー・アクセスに基づいたルーティングの詳細は、第19.2.2.9項「フィルタおよび割当てのためのヘッダー・アクセス」を参照してください。
同期および非同期の相互作用
Oracle Mediatorでは、同期および非同期のリクエスト・レスポンス相互作用がサポートされています。同期相互作用では、クライアントはサービスをリクエストした後、そのリクエストに対するレスポンスを待機します。非同期相互作用では、クライアントはサービスを起動しますが、そのレスポンスを待機しません。 非同期相互作用に対してはタイムアウト時間を指定できます。このタイムアウト時間は、イベントの発生やプロセスの開始など、一部のアクションの実行に使用できます。
同期および非同期の相互作用の詳細は、第19.2.2.3項「レスポンス・メッセージの処理」および第22章「メディエータのメッセージ交換パターンの理解」を参照してください。
メッセージの順次およびパラレルのルーティング
ルーティング・ルール実行タイプには、パラレルまたは順次のいずれかを指定できます。 実行タイプは「ルーティング・ルール」パネルから構成できます。
メッセージの順次およびパラレルのルーティングの詳細は、第19.2.2.2項「順次実行またはパラレル実行の指定」を参照してください。
トランスフォーメーション
Oracle Mediatorでは、XMLスキーマ間のデータ・トランスフォーメーションがサポートされています。 この機能を使用することで、異なるスキーマを使用しているアプリケーション間でのデータ交換が可能になります。たとえば、カンマ区切りのファイルをデータベース表の構造に変換できます。
トランスフォーメーションの詳細は、第19.2.2.7項「トランスフォメーションの作成」を参照してください。
検証
Oracle Mediatorでは、SchematronまたはXSDファイルを使用した受信メッセージ・ペイロードの検証がサポートされています。 ユーザーは各インバウンド・メッセージ・パートに対してSchematronファイルを指定でき、Oracle Mediatorはこれらのパートに対してSchematronファイル検証を実行できます。
検証の詳細は、第19.2.2.10項「セマンティク検証の使用」およびhttp://www.schematron.com/を参照してください。
Javaコールアウト
Oracle Mediatorでは、Javaコールアウトがサポートされています。 Javaコールアウトを使用すると、Javaコードを正規表現と併用できます。
Javaコールアウトの詳細は、第19.2.2.11項「Javaコールアウトのサポート」を参照してください。
イベント処理
イベントは、ビジネス環境におけるアクティビティの発生の結果として送信されるメッセージ・データです。Oracle Mediatorでは、ビジネス・イベントのサブスクライブや発生がサポートされています。目的の状況が発生したときに発生するビジネス・イベントをサブスクライブできます。 たとえば、新規顧客の作成時に発生するイベントをサブスクライブし、次にこのイベントを使用して、確認電子メールの送信などのビジネス・プロセスを開始できます。同様に、目的の状況が発生した場合は、ビジネス・イベントを発生させることができます。たとえば、顧客作成プロセスの完了後に顧客作成済イベントを発生させます。
イベント処理の詳細は、第44章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
動的ルーティング
動的ルーティングは、プロセスが経由するパスを決定する制御ロジックをプロセスの実行から分離します。 動的ルーティング・ルールは、メディエータ・エディタから作成できます。
動的ルーティングの詳細は、第19.2.3項「動的ルーティング・ルールの作成」を参照してください。
エラー処理
Oracle Mediatorでは、フォルト・ポリシーをベースとしたエラー処理と手動によるエラー処理の両方がサポートされています。フォルト・ポリシーは、複数の条件とアクションで構成されます。 条件によって、特定のエラー状態の場合に実行されるアクションを指定します。
エラー処理の詳細は、第20章「メディエータ・エラー処理の使用」を参照してください。
メディエータ・エコー・サポート
Oracle Mediatorでは、トランスフォーメーション、検証、割当てまたは順序操作の実行後に、ソース・メッセージを初期のコール元にエコーして戻す機能がサポートされています。
メディエータ・エコー・サポートの詳細は、「サービスをエコーする手順」を参照してください。
複数パート・メッセージのサポート
Oracle Mediatorでは、複数のパートで構成されたメッセージがサポートされています。 リモート・プロシージャ・コール（RPC）Webサービスの中には、SOAPメッセージに複数のパートが含まれているものがあります。
複数パート・メッセージのサポートに関する詳細は、第21章「メディエータにおける複数パート・メッセージの使用」を参照してください。
Oracle JDeveloperのSOAコンポジット・アプリケーション内にメディエータ・コンポーネントを作成した後、そのメディエータ・コンポーネントはメディエータ・エディタを使用して構成できます。 メディエータ・エディタを表示するには、SOAコンポジット・エディタで、メディエータ・コンポーネントをダブルクリックします。 SOAコンポジット・エディタの詳細は、第4章「SOAコンポジット・エディタの機能の概要」を参照してください。
図18-1には、メディエータ・エディタが「アプリケーション・ナビゲータ」、「構造」ウィンドウおよび「メッセージ」の各ウィンドウとともに表示されています。
図18-1のビューの各セクションによって、特定の設計やデプロイメント・タスクを実行できます。次のリストではこれらのセクションや機能について説明します。
図18-1の左上にある「アプリケーション・ナビゲータ」には、メディエータのファイルが表示されています。 図18-2に、SOAコンポジット・アプリケーションでメディエータを作成するときに、「SOAコンテンツ」フォルダ内に表示されるファイルを示します。
図18-2に示すように、SOAコンポジット・アプリケーションは次のメディエータ・ファイルで構成されています。
Composite.xml: SOAコンポジット・アプリケーション全体を説明するファイルです。 composite.xmlファイルの詳細は、第4章「SOAコンポジット・エディタの機能の概要」を参照してください。
.componentType: .componentTypeファイルには、サービス・コンポーネントのサービスと参照が記述されています。
.wsdl: Webサービス記述言語（WSDL）は、他のサービスがメディエータを呼び出す方法を指定します。WSDLファイルは、入出力メッセージとメディエータの操作を定義します。
図18-1の中央に表示されるメディエータ・エディタでは、作成したメディエータのビジュアル・ビューが提供されます。このビューは、次のいずれかの処理を実行すると表示されます。
SOAコンポジット・エディタ内のメディエータをダブルクリックします。
「アプリケーション・ナビゲータ」で.mplanファイル名をダブルクリックします。
「ソース」ビューでは、メディエータのソース・コードを表示できます。 図18-1の「設計」ウィンドウの下部にある「ソース」をクリックすると、ソース・コードが表示されます。ソース・ビューのコードは即時に更新され、メディエータ内の変更が反映されます。
次の例は、メディエータ・ソース・コードのサンプルを示しています。
<?xml version = '1.0' encoding = 'UTF-8'?> <!--Generated by Oracle SCA Modeler version 1.0 at [4/16/07 10:05 PM].--> <Mediator name="CustomerDataRouter" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/sca/1.0/mediator"/>
「履歴」ウィンドウをクリックすると、ファイルのリビジョン履歴を表示したり、ファイルの読取り専用バージョンと編集可能バージョンを並べて表示するなどのタスクを実行できます。 図18-1の「設計」ウィンドウ下部にある「履歴」をクリックすると、「履歴」ウィンドウが表示されます。 図18-3に、メディエータ・ファイルの「履歴」ビューを示します。
図18-1の下部にある「プロパティ・インスペクタ」では、メディエータのプロパティに関する詳細を表示できます。
図18-1の左下にある「構造」ウィンドウには、メディエータのデータの構造的なビューが表示されます。
「ログ」ウィンドウには、検証およびコンパイルのステータスに関するメッセージが表示されます。
次のいずれかの方法を使用して、Oracle JDeveloperのSOAコンポジット・アプリケーション内にメディエータを作成できます。
「コンポーネント・パレット」（図18-4を参照）からSOAコンポジット・エディタに「メディエータ」をドラッグ・アンド・ドロップします。
図18-5に示すように、「SOAコンポジットの作成」ダイアログまたは「SOAプロジェクトの作成」ダイアログで、「メディエータを使用するコンポジット」を選択します。
図18-5 「SOAプロジェクトの作成」ダイアログの「メディエータを使用するコンポジット」の選択
「新規ギャラリ」ダイアログで、「カテゴリ」リストから「サービス・コンポーネント」を、「項目」リストから「メディエータ」を選択します（図18-6を参照）。
それぞれの方法で「メディエータの作成」ダイアログを開き、ダイアログでメディエータ名を指定して、テンプレートを選択します。テンプレートにより、メディエータの設計を開始できる基本的な一連のデフォルト・ファイルが提供されます。
空のメディエータは、インタフェース定義を使用せずに作成できます。これによって、目的の順番でSOAコンポーネントを柔軟に作成できます。 たとえば、最初にメディエータを作成し、次にそのメディエータを起動するサービスまたはイベントを作成できます。
「メディエータの作成」ダイアログの「インタフェースを後で定義」テンプレートを使用すると、インタフェース定義を使用しないメディエータを作成できます。
インタフェース定義を使用せずにメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」コンポーネントをドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータ・コンポーネントの名前を入力します。
図18-7に示すように、「テンプレート」リストで、「インタフェースを後で定義」を選択し、「OK」をクリックします。
イベントのサブスクライブまたはサービスの定義によって、インタフェース定義を使用しないメディエータのインタフェースを定義できます。
イベントをサブスクライブする方法
.edlファイルに定義されたイベントを選択してイベントをサブスクライブできます。
SOAコンポジット・エディタ内のメディエータをダブルクリックします。
メディエータ・エディタが表示されます。
「ルーティング・ルール」セクションで、「イベント・サブスクリプションの追加」をクリックします。
「サブスクライブ済イベント」ダイアログが表示されます。
「追加」をクリックします。
「イベント・チューザ」ダイアログが表示されます。
「イベント定義」フィールドの右側にある「検索」をクリックし、.edlファイルを選択します。
「イベント」フィールドに、.edlファイルに定義されているイベントが移入されます。
1つ以上のイベントを選択し、「OK」をクリックします。
「一貫性」リストで、イベントに対する配信一貫性のレベルを選択します。
「ロールとして実行」フィールドに、デフォルトのセキュリティ・ロールとして$publisherが表示されます。 この値をそのまま使用することも、このフィールドを空白にすることもできます。
「フィルタ」フィールドをダブルクリックして、イベントをフィルタリングする式を指定します。
「OK」をクリックします。
イベントの「一貫性」、「ロールとして実行」および「フィルタ」の各フィールドに関する詳細は、第18.3.6項「イベント・サブスクリプション用のメディエータ・コンポーネントの作成」を参照してください。
サービスの定義方法
インタフェース定義を使用しないメディエータのサービスは、次の2つの方法で定義できます。
SOAコンポジット・エディタのワイヤを通じてメディエータをサービスに接続する方法
メディエータ・エディタの「サービスの定義」オプションを使用する方法
ワイヤを通じてメディエータのサービスを定義する方法は、次のとおりです。
SOAコンポジット・エディタで、メディエータからサービスにワイヤをドラッグします。
ワイヤの詳細、およびサービス・コンポーネントをサービスに接続する方法については、第4.2.9項「サービスとサービス・コンポーネントの接続方法」を参照してください。
|
注意: 定義済インタフェースおよび定義済参照があるメディエータは、ワイヤを通じてサービスに接続することもできます。 ただし、メディエータをサービスに接続するには、そのメディエータのインタフェースとサービスが一致している必要があります。 |
ワイヤ・ソースからWSDLファイルを使用することで、メディエータのサービスは自動的に定義されます。 たとえば、図18-8に示すReadFileサービスをCustomerDataRouterメディエータに接続すると、そのCustomerDataRouterメディエータでは自動的にReadFileサービスのサービス定義が継承されます。
メディエータをダブルクリックすると、図18-9に示すメディエータ・エディタが表示されます。
メディエータ・エディタでメディエータのサービスを定義する方法は、次のとおりです。
SOAコンポジット・エディタ内のメディエータをダブルクリックします。
メディエータ・エディタが表示されます。
WSDLファイルの右側にある「追加」をクリックします。
図18-10に示すように、「サービスの定義」ダイアログが表示されます。
「既存のWSDLを検索します。」をクリックして既存のWSDLファイルを使用するか、「スキーマからWSDLを生成します。」をクリックして新規のWSDLファイルを作成します。
WSDLファイルの生成方法は、第18.4項「WSDLファイルの生成」を参照してください。
「ポート・タイプ」リストから、ポートを選択します。
「コールバック・ポート・タイプ」リストで、非同期相互作用のレスポンス・メッセージのポートを選択します。
「OK」をクリックします。
既存のWSDLファイルに基づいてメディエータを作成できます。WSDLファイルは、スキーマや操作などのメディエータのインタフェースについて説明します。
「メディエータの作成」ダイアログの「WSDLからのインタフェース定義」テンプレートを使用すると、WSDLファイルに基づいてメディエータを作成できます。
WSDLファイル・インタフェースに基づいてメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」コンポーネントをドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータ・コンポーネントの名前を入力します。
図18-11に示すように、「テンプレート」リストから、「WSDLからのインタフェース定義」を選択します。
図18-11 「メディエータの作成」ダイアログの「WSDLからのインタフェース定義」テンプレートの選択
メディエータに自動的に接続されるSOAPバインディングを使用した公開済サービスを作成しない場合は、「SOAPバインディングを持つコンポジット・サービスの作成」オプションの選択を解除します。
「WSDLファイル」フィールドに、WSDLファイルの名前を入力します。
既存のWSDLファイルを使用するか、新規のWSDLファイルを作成できます。 既存のWSDLファイルの検索をクリックして既存のWSDLファイルを使用するか、「スキーマからWSDLを生成します。」をクリックして新規のWSDLファイルを作成します。
これらのオプションに関する詳細は、第18.4項「WSDLファイルの生成」を参照してください。
「ポート・タイプ」リストから、ポートを選択します。 「WSDLファイル」フィールドに指定したWSDLファイルが解析され、ポート・タイプのリストが表示されます。
「コールバック・ポート・タイプ」リストで、コールバック・ポートを選択します。コールバック・ポートは、非同期通信によるレスポンス・メッセージの送信先です。
「OK」をクリックします。
メディエータでは、一方向相互作用をサポートしています。一方向相互作用では、クライアントがサービスにメッセージを送信しますが、サービスはリプライする必要がありません。
「メディエータの作成」ダイアログの「一方向インタフェース」テンプレートを使用することで、一方向相互作用のメディエータを作成できます。
一方向インタフェース定義を使用してメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」コンポーネントをドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータ・コンポーネントの名前を入力します。
図18-12に示すように、「テンプレート」リストから、「一方向インタフェース」を選択します。
メディエータ・コンポーネントに自動的に接続されるSOAPバインディングを使用した公開済サービスを作成しない場合は、「SOAPバインディングを持つコンポジット・サービスの作成」オプションの選択を解除します。
「入力」フィールドの右側にある「検索」をクリックして、入力メッセージのスキーマ要素を選択します。デフォルトでは、入力メッセージ用にsingleStringスキーマ要素が選択されています。
|
注意: メディエータで処理する入力文書の形式は、XSDスキーマを使用して指定できます。 たとえば、次のスキーマを使用できます。
<xsd:schema attributeFormDefault="qualified"
elementFormDefault="qualified"
targetNamespace="http://samples.otn.com/helloworld"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://samples.otn.com/helloworld">
<include namespace="http://samples.otn.com/helloworld"
schemaLocation="helloworld.xsd" />
<xsd:element name="name1" type="xsd:string" />
<xsd:element name="result1" type="xsd:string"/>
</xsd:schema>
|
「OK」をクリックします。
メディエータは、同期リクエスト/レスポンス相互作用をサポートしています。同期相互作用では、クライアントはサービスにリクエストを送信し、すぐにレスポンスを受信します。 クライアントはレスポンスが届くまで次へ進みません。
「メディエータの作成」ダイアログの「同期インタフェース」テンプレートを使用することで、同期相互作用のメディエータを作成できます。
同期インタフェース定義を使用してメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」コンポーネントをドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータの名前を入力します。
図18-14に示すように、「テンプレート」リストから、「同期インタフェース」を選択します。
メディエータに自動的に接続されるSOAPバインディングを使用した公開済サービスを作成しない場合は、「SOAPバインディングを持つコンポジット・サービスの作成」オプションの選択を解除します。
「入力」フィールドの右側にある「検索」をクリックして、入力メッセージのスキーマ要素を選択します。デフォルトでは、入力メッセージ用にsingleStringスキーマ要素が選択されています。
「出力」フィールドの右側にある「検索」をクリックして、出力メッセージのスキーマ要素を選択します。 デフォルトでは、出力メッセージ用にsingleStringスキーマ要素が選択されています。
「OK」をクリックします。
メディエータは、非同期リクエスト/レスポンス相互作用をサポートしています。非同期相互作用では、クライアントはサービスにリクエストを送信しますが、リプライをブロックおよび待機しません。
「メディエータの作成」ダイアログの「非同期インタフェース」テンプレートを使用することで、非同期相互作用のメディエータを作成できます。
非同期インタフェース定義を使用してメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」コンポーネントをドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータの名前を入力します。
図18-16に示すように、「テンプレート」リストから、「非同期インタフェース」を選択します。
メディエータ・コンポーネントに自動的に接続されるSOAPバインディングを使用した公開済サービスを作成しない場合は、「SOAPバインディングを持つコンポジット・サービスの作成」オプションの選択を解除します。
「入力」フィールドの右側にある「検索」をクリックして、入力メッセージのスキーマ要素を選択します。デフォルトでは、入力メッセージ用にsingleStringスキーマ要素が選択されています。
「出力」フィールドの右側にある「検索」をクリックして、出力メッセージのスキーマ要素を選択します。デフォルトでは、出力メッセージ用にsingleStringスキーマ要素が選択されています。
「OK」をクリックします。
リクエスト・メッセージとレスポンス・メッセージ用のポート・タイプが定義された、非同期相互作用のメディエータが作成されます。 図18-17は、非同期インタフェースを使用して作成されたメディエータが、メディエータ・エディタ内でどのように見えるかを示しています。 「ポート・タイプ」フィールドには、リクエスト・メッセージが送信されるポートが表示されます。「コールバック・ポート・タイプ」には、レスポンスが送信されるポートが表示されます。 図18-17の実行操作の左側にある複数の矢印は、非同期操作を表しています。
目的の状況が発生したときに発生するビジネス・イベントをサブスクライブするメディエータを作成できます。ビジネス・イベントは、ビジネス環境における発生の結果として送信されるメッセージ・データで構成されています。 ビジネス・イベントの詳細は、第44章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
「メディエータの作成」ダイアログの「イベントのサブスクライブ」テンプレートを使用して、イベントをサブスクライブするためのメディエータを作成できます。
イベントをサブスクライブするメディエータを作成する手順は、次のとおりです。
「コンポーネント・パレット」の「SOA」リストから、「メディエータ」をドラッグし、SOAコンポジット・エディタの「コンポーネント」セクションにドロップします。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータ・コンポーネントの名前を入力します。
図18-18に示すように、「テンプレート」リストから、「イベントのサブスクライブ」を選択します。
図18-18 「メディエータの作成」ダイアログの「イベントのサブスクライブ」テンプレートの選択
「追加」をクリックします。
「イベント・チューザ」ダイアログが表示されます。
「イベント定義」フィールドの右側にある「検索」をクリックします。
「SOAリソース・ブラウザ」ダイアログが表示されます。
イベント定義ファイル（.edl）を選択し「OK」をクリックします。
「イベント」フィールドに、選択した.edlファイルに記述されているイベントが移入されます。 .edlファイルの作成方法の詳細は、第44章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
図18-19に示すように、「イベント」フィールドで1つ以上のイベントを選択し、「OK」をクリックします。
イベントに対する配信一貫性のレベルを選択します。
唯一: イベント配信にはグローバル（JTA）トランザクションが使用されます。 イベント・コールが失敗した場合、トランザクションはロールバックされ、コールは構成可能な回数だけ再試行されます。
保証付き: 配信を保証するためにローカル・トランザクションが使用されます。失敗時の再試行はありません。
即時: イベントは呼び出し側と同じスレッドおよび同じトランザクション上で配信されます。
「ロールとして実行」フィールドに、イベント・サブスクリプションを実行しているセキュリティ・ロールを入力します。デフォルトでは、イベント・サブスクリプションはイベント・パブリッシャ$publisherのセキュリティ下で実行します。 この値をそのまま使用することも、このフィールドを空白にすることもできます。
イベントをフィルタリングするには、次のいずれかを実行します。
選択したイベントの「フィルタ」列をダブルクリックします。
イベントを選択した後、「フィルタ」アイコン（最初のアイコン）をクリックします。
「式ビルダー」ダイアログが表示されます。
「式」フィールドでXPath式を入力し、「OK」をクリックします。
図18-20に、「式ビルダー」ダイアログのサンプルを示します。
「メディエータの作成」ダイアログの「フィルタ」列が、図18-21に示すように移入されます。
「OK」をクリックします。
図18-22に示すように、メディエータが作成されます。メディエータの左側にあるアイコンは、そのメディエータがイベント・サブスクリプション用に構成されていることを示しています。
図18-22 「イベントのサブスクライブ」テンプレートを使用して作成されたメディエータ・コンポーネント
メディエータをダブルクリックすると、図18-23に示すメディエータ・エディタが表示されます。
図18-23 メディエータ・エディタ内にイベント・サブスクリプションがあるメディエータ・コンポーネント
この項では、メディエータ・コンポーネントを作成するために知っておく必要がある概念について説明します。
Oracle SOAが提供するコンポーネントであるメディエータは、様々なメッセージ交換パターン（同期、非同期、イベントの公開またはサブスクリプションなど）に加え、選択的なルーティング、トランスフォーメーションおよび検証の機能などの仲介機能を備えています。
メディエータの作成方法の詳細は、第18.3項「メディエータの作成」を参照してください。
ルーティング・ルールは、必要な仲介を実行するために定義する仲介ロジックまたは実行ロジックです。 ルーティング・ルールの定義に関する詳細は、第19.2項「ルーティング・ルールの定義」を参照してください。
ルーティング・ルールを作成するには、次の内容を指定する必要があります。
操作またはイベント
メディエータ・ルーティング・ルールは、サービス操作またはイベント・サブスクリプションのいずれかでトリガーできます。 サービス操作は、同期、非同期または一方向のいずれかです。
Javaコールアウト
Javaコールアウトは、メディエータの実行における様々なポイントで外部Javaロジックを実行するために使用します。
静的ルーティング・ルール
静的に定義され、起動コンテキストによって変更されることのないメディエータ・ルーティング・ルールです。 この場合のルーティングは、エコー、別のサービスへのルーティングまたはイベントの公開のいずれかです。
静的ルーティング・ルールでは、次の内容を指定します。
リクエスト・ハンドラ
受信リクエストをメディエータが処理する方法を定義します。
リプライ・ハンドラ
コールしたサービスからの同期レスポンスをメディエータが処理する方法を定義します。
フォルト・ハンドラ
コールしたサービスからの名前付きフォルトまたは宣言済フォルトをメディエータが処理する方法を定義します。
コールバック・ハンドラ
コールしたサービスからの非同期レスポンス/コールバックをメディエータが処理する方法を定義します。
コールバックにおけるタイムアウト・ハンドラ
特定の非同期リクエストに対するタイムアウト処理を実行するまでに、メディエータが、非同期レスポンス/コールバックを待機する時間を定義します。
イベントの公開およびサービスの起動
イベントの公開およびサービスの起動では、ハンドラの構成に応じて、他のサービスのコールまたはイベントの公開が実行されます。
順次実行およびパラレル実行
各ルーティング・ルールの実行は、順次（同じスレッド内で実行）またはパラレル（異なるスレッド内で実行）のいずれかに構成できます。
|
注意: 同期サービス起動の場合、ルーティング・ルールは必ず順次にする必要があります。 |
フィルタ式
特定のルーティング・ルールを実行するかどうかを定義します。 この機能はXPath標準を使用し、メディエータ・ルーティング・ルールの選択的な実行を可能にします。
セマンティク検証
受信リクエストのセマンティク検証を可能にし、データが正しいかどうかも検証します。 この機能は、Schematron検証標準を使用します。
トランスフォーメーション
受信データのトランスフォーメーションを可能にし、コールしたサービスまたは公開済イベントに準拠した形式へのトランスフォーメーションを実行します。 この機能は、XSLトランスフォーメーション標準に基づいています。
割当て
コールしたサービスに合わせるために、メッセージのヘッダーおよびプロパティの操作を可能にします。
動的なルーティング・ルール
Oracle Rules Dictionaryへのルーティング・ロジックの外部化を可能にするメディエータ・ルーティング・ルールです。Oracle Rules Dictionaryは、ルーティング・ルール内のルーティング・ロジックの動的変更を可能にします。 この機能は、デシジョン・サービスおよびOracle Rulesを使用して、実行時にルーティング・ロジックを取得します。
|
注意: メディエータのグローバリゼーションを完全にサポートするために、Unicodeデータベースのデータベース・キャラクタ・セットには、AL32UTF8を使用することをお薦めします。 |
次のいずれかの方法を使用して、WSDLファイルを生成できます。
「メディエータの作成」ダイアログの「WSDLからのインタフェース定義」テンプレートを選択する際に表示される「スキーマからWSDLを生成します。」オプションを使用します。
インタフェース定義を使用しないメディエータのサービスの定義中に表示される「サービスの定義」ダイアログの「スキーマからWSDLを生成します。」オプションを使用します。
それぞれの方法で、図18-24に示す「WSDLの作成」ダイアログを開きます。
「WSDLの作成」ダイアログは「リクエスト」、「リプライ」、「フォルト」および「コールバック」の各タブで構成されており、これらのタブを使用してリクエスト、リプライ、フォルトおよびコールバックの各メッセージのスキーマ・ファイルを定義できます。リクエスト、レスポンス、フォルトおよびコールバック・メッセージに対して、同一または異なるスキーマ・ファイルを指定できます。最低でもリクエスト・メッセージのスキーマ・ファイルを指定する必要があります。 デフォルトでは、リクエスト・メッセージ用にsingleString.xsdファイルが選択されています。
メッセージに対するWSDLファイルは、XMLスキーマ定義（XSD）ファイルまたはサンプル・ファイルを使用して生成できます。
XSDファイルからWSDLを生成する手順は、次のとおりです。
「WSDLの作成」タブで「検索」をクリックして、スキーマ・ロケーションにアクセスします。
スキーマ・ファイル（XSDファイル）のリストを含む「タイプ・チューザ」ダイアログが表示されます。
「プロジェクトのスキーマ・ファイル」ノードと「プロジェクトのWSDLファイル」ノードを開いて、使用するスキーマを検索します。
スキーマXSDファイルまたはWSDLファイルは、それぞれ「スキーマ・ファイルのインポート」アイコンまたは「WSDLのインポート」アイコンを使用して、プロジェクトにインポートすることもできます。
|
注意: ローカル・ファイル・システムのスキーマXSDファイルを使用する場合は、必ず、XSDファイルおよびそのファイルによってインポートされるXSDファイルすべてがOracle JDeveloperのプロジェクト・ディレクトリに存在している必要があります。 |
ファイルを指定すると、Oracle Jdeveloperによってファイルが解析されて定義済のスキーマ要素が決定され、リストに選択肢として表示されます。
XSDファイルのルート要素を選択し、「OK」をクリックします。
「操作名」フィールドに操作名を入力します。例: executeQuery。
Oracle JDeveloperによって、指定された操作がWSDLファイルの操作要素に変換されます。
|
注意: 操作名に空白は使用できません。 |
「ポート・タイプ名」フィールドに、ポート名を入力します。
「ネームスペース」フィールドに、ネームスペースを入力するか、現在の値をそのまま使用します。
例: http://oracle.com/esb/namespaces/Mediator
指定するネームスペースは、WSDLファイルのtnsネームスペースとして定義されます。
「リプライ」タブで情報を入力する場合は、「検索」をクリックしてスキーマにアクセスしてから、スキーマ要素を選択します。
「リプライ」タブで同期通信におけるレスポンス・メッセージのスキーマを指定できます。
「フォルト」タブで情報を入力する場合は、「検索」をクリックしてスキーマ・ロケーションにアクセスしてからスキーマ要素を選択します。また、レスポンスを指定しないと、フォルト・メッセージ・スキーマは指定できません。
「コールバック」タブで情報を入力する場合は、「検索」をクリックしてスキーマにアクセスしてから、スキーマ要素を選択します。
「コールバック」タブで非同期通信におけるレスポンス・メッセージのスキーマを指定できます。
「操作名」フィールドに操作名を入力します。
例: returnQuery
「ポート・タイプ名」フィールドに、レスポンスが送信されるポート名を入力します。
「OK」をクリックします。
サンプル・ファイルに基づいたWSDLファイルの生成
WSDLファイルは、カンマ区切り値（CSV）ファイル、固定長ファイル、Document Type Definition（DTD）ファイル、COBOLコピーブック・ファイルなどのネイティブ・ファイル・フォーマットのファイルから生成できます。ネイティブ・フォーマット・ビルダー・ウィザードを使用して、サンプル・ファイルに基づいたWSDLファイルを生成できます。 このネイティブ・フォーマット・ビルダー・ウィザードは、「WSDLの作成」ダイアログの「リクエスト」、「レスポンス」、「フォルト」および「コールバック」タブにある「ネイティブ・フォーマットのスキーマの定義」をクリックすると表示されます。WSDLファイルは、ウィザード完了後に生成されます。
ネイティブ・フォーマット・ビルダー・ウィザードの詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。
メディエータを作成した後は、メディエータ・エディタを使用して、操作またはイベント・サブスクリプションの構文の検証（XSD）プロパティを指定できます。 このオプションを選択して、インバウンド・メッセージのスキーマを検証できます。デフォルトでは、スキーマの検証はfalseに設定されています。
メディエータの操作またはイベント・サブスクリプションは、メディエータ・エディタを使用して変更できます。
操作を追加または削除することで、メディエータのWSDLファイルを変更できます。WSDLファイルの変更後、「WSDLのリフレッシュ」ダイアログを使用して変更を同期化できます。
メディエータの操作を変更する手順は、次のとおりです。
メディエータ・エディタで、「WSDLファイル」フィールドの右側にある「WSDLからの操作のリフレッシュ」アイコン（図18-26でハイライト表示）をクリックします。
「WSDLのリフレッシュ」ダイアログが表示されます。WSDLファイルが変更された場合、「WSDLのリフレッシュ」ダイアログには削除または追加される操作がすべて一覧表示されます。 リフレッシュによって、WSDLファイルから削除された、メディエータの操作フィールド・リストのすべての操作が削除されます。 また、リフレッシュによって、WSDLファイルに追加された、メディエータの操作フィールド・リストのすべての新規操作が追加されます。 図18-27に、「WSDLのリフレッシュ」ダイアログを示します。
別のWSDLファイルを指定するには、「既存のWSDLを検索します。」をクリックして既存のWSDLファイルを使用するか、または「スキーマからWSDLを生成します。」をクリックして新規のWSDLファイルを作成します。
「WSDLのリフレッシュ」ダイアログは、図18-28に示すように、指定のWSDLファイルで定義された操作に基づいて更新されます。
「OK」をクリックします。
「ファイル」メニューから「すべて保存」を選択します。
メディエータ・エディタの「イベント・サブスクリプションの管理」オプションを使用すると、新規イベントのサブスクライブ、既存イベント・サブスクリプションの変更およびサブスクライブ済イベントからのサブスクライブ解除などを実行できます。
メディエータのイベント・サブスクリプションを変更する手順は、次のとおりです。
メディエータ・エディタで、イベント・サブスクリプションの右側にある「イベント・サブスクリプションの管理」アイコンをクリックします。
図18-29に示すように、「サブスクライブ済イベント」ダイアログが表示されます。
次の機能のいずれも実行できます。
新規イベントをサブスクライブします。
イベントからサブスクライブ解除します。
イベントのフィルタ基準を変更または指定します。
イベント・サブスクリプションの「一貫性」または「ロールとして実行」プロパティを変更します。
イベントの「一貫性」、「ロールとして実行」および「フィルタ」の各フィールドに関する詳細は、第18.3.6項「イベント・サブスクリプション用のメディエータ・コンポーネントの作成」を参照してください。
「OK」をクリックします。
「ファイル」メニューから「すべて保存」を選択します。
