| Oracle® Fusion Middleware Oracle SOA Suite開発者ガイド 11gリリース1 (11.1.1.9) B56238-11 |
|
 前 |
 次 |
この章では、Oracle SOA Suiteアプリケーションにトランスフォーメーション、検証およびルーティング・ロジックを提供するOracle Mediatorについて説明します。また、この章では、Oracle JDeveloperでメディエータ・コンポーネントおよび関連するWSDLドキュメントを作成する方法についても説明します。
この章では、次の項目について説明します。
Oracle SOA Suiteのサービス・コンポーネントであるOracle Mediatorは、様々なメッセージ交換パターン(同期、非同期、イベントの公開またはサブスクリプションなど)に加え、選択的なルーティング、トランスフォーメーションおよび検証の機能などの仲介機能を備えています。
メディエータは、Web Services Description Language (WSDL)ドキュメントをインタフェースとして使用してコンポジット・アプリケーション内の様々なコンポーネント間(ビジネス・プロセスやヒューマン・ワークフローなど)を仲介する軽量のフレームワークを提供します。また、様々なコンポーネントで公開される様々なインタフェース間での通信が容易になるようにデータを変換します。これらのコンポーネントは接続されて、SOAコンポジット・アプリケーションが構築されます。たとえば、メディエータでは、アプリケーションまたはサービスからテキスト・ファイルに格納されたデータを受け入れ、顧客リポジトリとして使用するデータベースの更新に適した書式に変換し、変換したデータをそのデータベースにルーティングおよび配信できます。
メディエータによって、イベントとサービス間の統合が容易になり、この統合によって、サービスの起動とイベントの組合せや調整が可能となります。メディエータ・サービス・コンポーネントを使用すると、ビジネス・イベントを処理したり、サービスの起動を受信できます。メディエータ・サービス・コンポーネントは、ルーティング・ルールの評価、変換の実行、検証を行い、別のサービスを起動したり、別のビジネス・イベントを発生させることができます。メディエータ・サービス・コンポーネントを使用すると、返されたレスポンス、コールバック、フォルトおよびタイムアウトを処理できます。
次の各項では、Oracle MediatorがOracle SOA Suiteアプリケーションに提供する主な機能について説明します。
メディエータでは、メッセージ・ペイロードまたはメッセージ・ヘッダーに基づいてルールを定義できます。メッセージ・ペイロードまたはメッセージ・ヘッダーから要素または属性を選択し、その要素または属性の値に基づいてアクションを指定できます。たとえば、メディエータで、新規顧客に関するデータが含まれているファイルをアプリケーションまたはサービスから受信したとします。顧客の住所に記載されている国に基づいて、その特定の国に関するデータが格納されているデータベースにデータをルーティングおよび配信できます。同様に、メッセージ・ヘッダーに基づいてメッセージをルーティングできます。
ヘッダーに基づいたルーティングの詳細は、第20.3.2.12項「フィルタおよび割当てのためのヘッダー・アクセス方法」を参照してください。
メディエータでは、同期と非同期、両方のリクエストとレスポンスの相互作用がサポートされています。同期相互作用では、クライアントはサービスをリクエストした後、そのリクエストに対するレスポンスを待機します。非同期相互作用では、クライアントはサービスを起動しますが、そのレスポンスを待機しません。非同期相互作用に対してはタイムアウト時間を指定できます。このタイムアウト時間には、イベントの発生やプロセスの開始など、タイムアウト時間後に実行するアクションを指定できます。
同期および非同期の相互作用の詳細は、第20.3.2.4項「レスポンス・メッセージの構成方法」および第24章「Oracle Mediatorのメッセージ交換パターンの理解」を参照してください。
メディエータでは、ルーティング・ルールをパラレルまたは順次のいずれかで実行するように指定できます。実行タイプは、メディエータ・エディタの「ルーティング・ルール」セクションから構成できます。
メッセージの順次およびパラレルのルーティングの詳細は、第20.3.2.3項「順次実行またはパラレル実行の指定方法」を参照してください。
メディエータの再シーケンサを使用すると、再シーケンサにより、関連がありながらも順序が正しくないメッセージは、使用されている再シーケンサのタイプと定義されているルールに基づいて適切な順序に並べ替えられます。受信メッセージがランダムな順番で着信した場合、再シーケンサは、メッセージを順次または時系列の情報に基づいて並べ替え、再順序付けの構成に基づいた正しい順序でメッセージをターゲット・サービスに送信します。
メッセージの再順序付けの詳細は、第23章「Oracle Mediatorにおける再順序付け」を参照してください。
メディエータでは、XMLスキーマ間のデータ・トランスフォーメーションを定義できます。この機能を使用することで、異なるスキーマを使用しているアプリケーション間でのデータ交換が可能になります。たとえば、カンマ区切りのファイルをデータベース表の構造に変換できます。
トランスフォーメーションの詳細は、第20.3.2.9項「トランスフォメーションの作成方法」を参照してください。
SchematronまたはXSDファイルを使用して受信メッセージ・ペイロードを検証するようにメディエータを構成できます。ユーザーは各インバウンド・メッセージ・パートに対してSchematronファイルを指定でき、メディエータはこれらのパートに対してSchematronファイル検証を実行します。
検証の詳細は、第20.3.2.13項「セマンティク検証の使用方法」およびhttp://www.schematron.com/を参照してください。
メディエータでは、ルーティング・ルールにJavaコールアウトを追加できます。Javaコールアウトは、正規表現を使用したJavaコードを使用する方法です。
Javaコールアウトの詳細は、第20.3.2.15項「Javaコールアウトの使用方法」を参照してください。
イベントは、ビジネス環境でアクティビティが発生すると送信されるメッセージです。メディエータでは、ビジネス・イベントのサブスクライブと発生の両方を実行できます。目的の状況が発生したときに生成されるビジネス・イベントをサブスクライブできます。たとえば、新規顧客の作成時に生成されるイベントをサブスクライブし、次にこのイベントを使用して、確認電子メールの送信などのビジネス・プロセスを開始できます。同様に、目的の状況が発生した場合は、ビジネス・イベントを生成することができます。たとえば、新規顧客プロファイルの作成後に顧客作成済イベントを生成できます。
イベント処理の詳細は、第41章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
動的ルーティングは、プロセスの制御ロジックをプロセスの実行から分離します。制御ロジックは、プロセスが経由するパスを決定します。動的ルーティング・ルールは、メディエータ・エディタを使用して作成できます。
動的ルーティングの詳細は、第20.3.3項「動的ルーティング・ルールの作成方法」を参照してください。
メディエータでは、手動によるエラー処理とフォルト・ポリシーに基づくエラー処理の両方がサポートされています。フォルト・ポリシーは複数の条件とアクションで構成され、条件によって、特定のエラー状態の場合に実行されるアクションを指定します。
エラー処理の詳細は、第22章「Oracle Mediatorエラー処理の使用」を参照してください。
メディエータでは、トランスフォーメーション、検証、割当てまたは順序操作の実行後に、ソース・メッセージを最初のコール元にエコーして戻すことができます。
メディエータのエコー・サポートの詳細は、第20.3.2.1項「メディエータ・サービスまたはイベントの指定方法」の「サービスをエコーする手順」を参照してください。
メディエータでは、複数のパートで構成されたメッセージを処理できます。リモート・プロシージャ・コール(RPC) Webサービスの中には、SOAPメッセージに複数のパートが含まれているものがあります。
複数パート・メッセージのサポートに関する詳細は、第21章「Oracle Mediatorにおける複数パート・メッセージの使用」を参照してください。
Oracle JDeveloperのSOAコンポジット・アプリケーション内にメディエータ・サービス・コンポーネントを作成した後、そのメディエータ・サービス・コンポーネントはメディエータ・エディタを使用して構成できます。メディエータ・エディタを表示するには、SOAコンポジット・エディタで、メディエータ・サービス・コンポーネントをダブルクリックします。SOAコンポジット・エディタの詳細は、第2章「Oracle SOA Suiteを使用したSOAコンポジット・アプリケーションの開発」を参照してください。
図19-1には、メディエータ・エディタが「アプリケーション・ナビゲータ」、「構造」および「メッセージ」の各ウィンドウとともに表示されています。
|
注意: メディエータのグローバリゼーションを完全にサポートするために、Unicodeデータベースのデータベース文字セットには、AL32UTF8を使用することをお薦めします。 |
図19-1のビューの各セクションによって、特定の設計やデプロイメント・タスクを実行できます。このビューのセクションは次のとおりです。
図19-1の左上にある「アプリケーション・ナビゲータ」は、メディエータのファイル構造を示しています。これらのファイルは、メディエータを作成したプロジェクトの「SOAコンテンツ」フォルダの下に表示されます。アプリケーション・ナビゲータおよびコンポジット・ファイルの詳細は、表2-3「SOAコンポジット・エディタ」を参照してください。
図19-1の中央に表示されているメディエータ・エディタでは、メディエータのビジュアル・ビューが提供されます。このビューは、次のいずれかの処理を実行すると表示されます。
SOAコンポジット・エディタで、Oracle Mediatorアイコンをダブルクリックした場合。
「アプリケーション・ナビゲータ」で、メディエータの.mplanファイルをダブルクリックします。
「ソース」ビューに、メディエータのソース・コードが表示されます。メディエータ・エディタの下部にある「ソース」をクリックすると、ソース・コードが表示されます。「ソース」ビューのコードは即時に更新され、メディエータ内のすべての変更が反映されます。
例19-1は、メディエータのソース・コードのサンプルを示しています。
「履歴」ウィンドウには、リビジョン履歴や、ファイルの読取り専用バージョンと編集可能バージョンを並べた比較など、メディエータ・ファイルの履歴情報を表示できます。図19-1の「設計」ウィンドウ下部にある「履歴」をクリックすると、「履歴」ウィンドウが表示されます。図19-2に、メディエータ・ファイルの「履歴」ビューを示します。
図19-1の下部にあるプロパティ・インスペクタには、メディエータのプロパティに関する詳細が表示されます。
図19-1の左下にある「構造」ウィンドウには、メディエータのデータの構造的なビューが表示されます。
「ログ」ウィンドウには、検証およびコンパイル・ステータスに関するメッセージが表示されます。
アプリケーション開発プロセスの現在の段階に応じて、複数の方法でメディエータを作成できます。コンポーネントを作成するには、次の項の該当する指示に従ってください。
開発サイクルの次のどの時点でも、Oracle JDeveloperでSOAコンポジット・アプリケーション内にメディエータを作成できます。
コンポジット・アプリケーションの作成時
既存のコンポジット・アプリケーションの変更時
プロジェクトの作成時
既存のプロジェクトの変更時
メディエータの作成時には、「メディエータの作成」ダイアログが表示され、メディエータの名前を決定してインタフェースのテンプレートを選択できます。
メディエータを使用するコンポジット・アプリケーションを作成する手順は、次のとおりです。
SOAアプリケーションの作成ウィザードを使用して、SOAアプリケーションおよびプロジェクトを作成し、名前を指定します。
図19-3に示すように、「SOA設定の構成」ページが表示されたら、「コンポジット・テンプレート」リストから「メディエータを使用するコンポジット」を選択します。
図19-3 「SOAプロジェクトの作成」ウィザードの「メディエータを使用するコンポジット」の選択
「終了」をクリックします。
「メディエータの作成」ダイアログが表示されます。
第19.5項「メディエータのインタフェース定義の構成」の説明に従って、メディエータのインタフェースを構成します。
第20章「Oracle Mediatorルーティング・ルールの作成」の説明に従って、メディエータのルーティング・ルールを定義します。
既存のコンポジット・アプリケーション内にメディエータを作成する手順は、次のとおりです。
SOAコンポジット・エディタで、メディエータを追加するコンポジット・アプリケーションを開きます。
「コンポーネント・パレット」(図19-4を参照)からエディタの「コンポーネント」セクションにメディエータをドラッグ・アンド・ドロップします。
|
ヒント: 「コンポーネント・パレット」は、SOAコンポジット・エディタの右側にあります。 |
「メディエータの作成」ダイアログが表示されます。
第19.5項「メディエータのインタフェース定義の構成」の説明に従って、メディエータのインタフェースを構成します。
第20章「Oracle Mediatorルーティング・ルールの作成」の説明に従って、メディエータのルーティング・ルールを定義します。
メディエータを使用する新規プロジェクトを作成する手順は、次のとおりです。
アプリケーション・ナビゲータを右クリックして、「新規」を選択します。
「新規ギャラリ」ウィザードが表示されます。
「SOA層」カテゴリに新規SOAプロジェクトを作成し、名前を付けます。
図19-5に示すように、「新規ギャラリ」ダイアログの「SOA設定の構成」ページで、「コンポジット・テンプレート」リストから「メディエータを使用するコンポジット」を選択します。
図19-5 表示される「メディエータを使用するコンポジット」テンプレートを使用した「SOAプロジェクトの作成」ウィザード
「終了」をクリックします。
「メディエータの作成」ダイアログが表示されます。
第19.5項「メディエータのインタフェース定義の構成」の説明に従って、メディエータのインタフェースを構成します。
既存のプロジェクト内にメディエータを作成する手順は、次のとおりです。
「アプリケーション・ナビゲータ」で、メディエータを追加するプロジェクトを選択します。
ナビゲータ・ペインを右クリックし、「新規」を選択します。
図19-6に示すように、「カテゴリ」で「サービス・コンポーネント」を選択し、次に「項目」リストから「メディエータ」を選択します。
「OK」をクリックします。
「メディエータの作成」ダイアログが表示されます。
第19.5項「メディエータのインタフェース定義の構成」の説明に従って、メディエータのインタフェースを構成します。
第20章「Oracle Mediatorルーティング・ルールの作成」の説明に従って、メディエータのルーティング・ルールを定義します。
新規のメディエータを作成するときに、メディエータ・プロジェクトの基本的な一連のデフォルト・ファイルを生成するインタフェース・テンプレートを指定できます。これらのファイルは、メディエータを設計および構成できるフレームワークを提供します。次のインタフェース・オプションを使用して、メディエータを作成できます。
インタフェース定義を使用しないメディエータ
空のメディエータを作成し、WSDLファイルは作成しません。この方法を使用すると、目的の順番でSOAコンポーネントを柔軟に作成できます。インタフェース定義を使用せずにメディエータを作成した後、そのコンポーネントを起動するサービスまたはイベントを作成する必要があります。
WSDLファイルで定義されているインタフェースを使用したメディエータ
インタフェース定義は、メディエータのインタフェース(ポート・タイプ、操作、サービス、スキーマなど)が記述されているWSDLファイルに基づきます。WSDLファイルは、既存のものを使用するか、スキーマ・ファイルから生成できます。
一方向インタフェースを使用したメディエータ
クライアントはサービスにメッセージを送信するが、サービスからのリプライは不要の一方向相互作用のインタフェースを定義します。
同期インタフェースを使用したメディエータ
同期リクエスト/レスポンス相互作用のインタフェースを作成します。同期相互作用では、クライアントはサービスにリクエストを送信し、すぐにレスポンスを受信します。クライアントはレスポンスが届くまで次へ進みません。
非同期インタフェースを使用したメディエータ
非同期リクエスト/レスポンス相互作用のインタフェースを作成します。非同期相互作用では、クライアントはサービスにリクエストを送信しますが、リプライをブロックおよび待機しません。
イベントをサブスクライブするメディエータ
目的の状況が発生したときに生成されるビジネス・イベントをサブスクライブするメディエータを作成します。ビジネス・イベントは、ビジネス環境における発生の結果として送信されるメッセージ・データで構成されています。ビジネス・イベントの詳細は、第41章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
イベントをサブスクライブするには、イベント定義(EDL)ファイルでイベントを定義する必要があります。
メディエータのインタフェース定義の構成は、「メディエータの作成」ダイアログで行います。
メディエータのインタフェース定義を構成する手順は、次のとおりです。
第19.4項「メディエータの作成」に記載されているいずれかの方法で、メディエータを作成します。
「メディエータの作成」ダイアログが表示されます。
「名前」フィールドに、メディエータ・サービス・コンポーネントの名前を入力します。
「テンプレート」リストで、次のいずれかを選択します。それぞれの詳細は、この項の最初の説明を参照してください。
インタフェースを後で定義
WSDLからのインタフェース定義
一方向インタフェース
同期インタフェース
非同期インタフェース
イベントのサブスクライブ
図19-7および図19-8は、インタフェース・タイプが異なる場合に「メディエータの作成」ダイアログのプロパティがどのように変わるかを示しています。
図19-8 「メディエータの作成」ダイアログの「WSDLからのインタフェース定義」テンプレートの選択
「イベントのサブスクライブ」以外のインタフェース・タイプの場合は、適切なプロパティを構成します。各タイプで表示されるプロパティの詳細は、この手順の後の表19-1を参照してください。
「イベントのサブスクライブ」を選択した場合は、次の手順を実行します。
「メディエータの作成」ダイアログで「追加」をクリックします。図19-9に詳細を示します。
「イベント・チューザ」ダイアログが表示されます。
「イベント定義」フィールドの右側にある「検索」をクリックします。
「SOAリソース・ブラウザ」ダイアログが表示されます。
イベント定義ファイル(.edl)を選択し「OK」をクリックします。
「イベント」フィールドに、選択した.edlファイルに記述されているイベントが移入されます。.edlファイルの作成方法の詳細は、第41章「ビジネス・イベントおよびイベント配信ネットワークの使用」を参照してください。
図19-10に示すように、「イベント」フィールドで1つ以上のイベントを選択し、「OK」をクリックします。
イベントと一貫性がある配信のレベルを選択します。
唯一: イベント配信にはグローバル(JTA)トランザクションが使用されます。イベント・コールが失敗した場合、トランザクションはロールバックされ、コールは構成可能な回数だけ再試行されます。
保証付き: 配信を保証するためにローカル・トランザクションが使用されます。失敗時の再試行はありません。
即時: イベントはコール元と同じスレッドおよび同じトランザクション上で配信されます。
「パブリッシャとして実行」フィールドで、イベント・パブリッシャのセキュリティ下でイベント・サブスクリプションを実行するかどうかを選択します。
デフォルトでは、イベント・サブスクリプションはイベント・パブリッシャのセキュリティ下で実行します。
イベントをフィルタリングするには、選択したイベントの「フィルタ」列をダブルクリックするか、またはイベントを選択して「フィルタ」アイコン(最初のアイコン)をクリックします。
「式ビルダー」ダイアログが表示されます。
「式」フィールドでXPath式を入力し、「OK」をクリックします。
図19-11に、「式ビルダー」ダイアログのサンプルを示します。
「メディエータの作成」ダイアログの「フィルタ」列に、作成した式が表示されます。
「OK」をクリックします。
「メディエータの作成」ダイアログで「OK」をクリックします。
インタフェースなしのメディエータを作成するように選択した場合は、第19.6.1項「メディエータのインタフェースの定義方法」の説明に従って、後でインタフェースを作成する必要があります。
表19-1に、インタフェースを定義するために構成可能なプロパティをリストして説明します。選択したインタフェース・タイプによって使用可能なプロパティは異なるため、リストされているすべてのプロパティがすべてのインタフェース・タイプに適用されるわけではありません。
表19-1 メディエータのインタフェースのプロパティ
| プロパティ | 説明 |
|---|---|
|
SOAPバインディングを持つコンポジット・サービスの作成 |
このオプションを選択すると、インタフェースが生成されたときに自動的にメディエータに接続されるSOAPバインディングを使用した公開されたサービスが作成されます。 |
|
WSDL URL |
WSDLファイルからインタフェースを作成する場合に、使用するWSDLファイルの場所を入力します。次のいずれかを実行します:
これらのオプションに関する詳細は、第19.7項「WSDLファイルの生成」を参照してください。 |
|
ポート・タイプ |
WSDLファイルのポート・タイプ名を入力します。使用可能なポート・タイプは、「WSDL URL」フィールドに指定したWSDLファイルから解析されます。 |
|
コールバック・ポート・タイプ |
非同期通信のレスポンス・メッセージが送信されるポート・タイプ名を入力します。使用可能なポート・タイプは、「WSDL URL」フィールドに指定したWSDLファイルから解析されます。 |
|
入力 |
入力メッセージ用のスキーマ要素を入力します。フィールドの右側にある「検索」をクリックして、要素を選択します。デフォルトでは、入力メッセージ用にsingleStringスキーマ要素が選択されています。 サンプル・スキーマについては、例19-2を参照してください。 |
|
出力 |
出力メッセージ用のスキーマ要素を入力します。フィールドの右側にある「検索」をクリックして、要素を選択します。デフォルトでは、入力メッセージ用にsingleStringスキーマ要素が選択されています。 |
例19-2 一方向インタフェースのサンプル・スキーム
メディエータで処理する入力文書の形式は、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>
メディエータ・ファイルは「アプリケーション・ナビゲータ」で指定されたアプリケーションおよびプロジェクトの下に生成され、設計ビューのメディエータ・エディタに新規のメディエータが表示されます。インタフェース定義を使用したメディエータを作成し、WSDLファイルが存在しなかった場合は、新しいWSDLファイルがメディエータと同じ名前で一緒に生成されます。指定したWSDLファイルがプロジェクト・ファイルと異なるディレクトリに格納されている場合は、ファイルおよび関連するスキーマ・ファイルがメディエータ・プロジェクトにコピーされます。
このメディエータはWSDLファイル、ポート・タイプまたは操作に関連付けられていません。第19.6項「メディエータのインタフェースの定義」の説明に従って、これらを個別に定義する必要があります。図19-12は、インタフェース定義を使用せずに作成したメディエータがメディエータ・エディタ内でどのように表示されるかを示しています。
このメディエータの外観およびソース・コードは、WSDLファイルの名前、およびWSDLファイルで定義されているポート・タイプおよび操作によって異なります。図19-13は、WSDLファイルから作成されたメディエータのサンプルを示しています。
図19-14は、一方向インタフェースを使用して作成したメディエータがメディエータ・エディタ内でどのように表示されるかを示しています。「execute」操作の左側にある矢印は、一方向操作を表しています。
同期相互作用ではレスポンスがリクエストと同じポートに送信されるため、ポートは1つのみ定義されます。図19-15は、同期インタフェースを使用して作成したメディエータがメディエータ・エディタ内でどのように表示されるかを示しています。図19-15の「execute」操作の左側にある矢印は、同期操作を表しています。
図19-16は、非同期インタフェースを使用して作成したメディエータがメディエータ・エディタ内でどのように表示されるかを示しています。「ポート・タイプ」フィールドには、リクエスト・メッセージが送信されるポートが表示されます。「コールバック・ポート・タイプ」フィールドには、レスポンスが送信されるポートが表示されます。図19-16の「execute」操作の左側にある矢印は、非同期操作を表しています。
インタフェース定義を使用せずにメディエータを作成した後、イベントのサブスクライブまたはサービスの定義によって、インタフェースを定義する必要があります。サービスの定義は、次の2つの方法で行えます。
SOAコンポジット・エディタのワイヤを通じてメディエータをサービスに接続します。
メディエータ・エディタの「サービスの定義」オプションを使用します。
次の手順は、既存のメディエータのインタフェースを定義するために、イベントをサブスクライブして定義する方法、コンポジット内にワイヤを作成するサービスを定義して定義する方法、メディエータ・エディタを使用してサービスを定義して定義する方法を示しています。
イベントをサブスクライブする手順は、次のとおりです。
イベントをサブスクライブするには、イベント定義(EDL)ファイルでイベントを定義する必要があります。
メディエータ・エディタで編集するメディエータを開きます。
「ルーティング・ルール」セクションで、「イベント・サブスクリプションの追加」をクリックします。
「サブスクライブ済イベント」ダイアログが表示されます。
「追加」をクリックします。
「イベント・チューザ」ダイアログが表示されます。
第19.5項「メディエータのインタフェース定義の構成」のステップ5b以降の手順に従います。
「OK」をクリックします。
ワイヤを使用してメディエータのサービスを定義する手順は、次のとおりです。
SOAコンポジット・エディタで、メディエータからサービスにワイヤをドラッグします。
ワイヤの詳細、およびサービス・コンポーネントをサービスに接続する方法については、第2.5.1項「サービスとサービス・コンポーネントの接続方法」を参照してください。
|
注意: 定義済インタフェースおよび定義済参照があるメディエータも、ワイヤを通じてサービスに接続できます。ただし、メディエータをサービスに接続するには、そのメディエータとサービスのインタフェースが一致している必要があります。 |
ワイヤを使用してサービスを定義した場合、メディエータのサービスは、ワイヤのソースのWSDLファイルを使用して自動的に定義されます。たとえば、図19-19に示すReadFileサービスをCustomerDataRouterメディエータに接続すると、そのCustomerDataRouterメディエータでは自動的にReadFileサービスのサービス定義が継承されます。
2つのメディエータ・サービス・コンポーネントを接続したときに無限ループが発生するケースに関する必知事項は、第2.5.3項「ワイヤの追加と削除に関する必知事項」を参照してください。
メディエータ・エディタでメディエータのサービスを定義する手順は、次のとおりです。
メディエータ・エディタで編集するメディエータを表示します。
「WSDL URL」フィールドの右側にある「サービスの定義」をクリックします。
図19-20に示すように、「サービスの定義」ダイアログが表示されます。
次のいずれかを実行します:
既存のWSDLファイルを使用するには、「WSDL URL」フィールドの右側にある「既存のWSDLを検索します。」をクリックします。
WSDLファイルを作成するには、「WSDL URL」フィールドの右側にある「スキーマからWSDLを生成します。」をクリックします。
WSDLファイルの生成方法は、第19.7項「WSDLファイルの生成」を参照してください。
「ポート・タイプ」リストから、ポートを選択します。
「コールバック・ポート・タイプ」リストから、非同期相互作用のレスポンス・メッセージのポートを選択します。
「OK」をクリックします。
メッセージに対するWSDLファイルは、XMLスキーマ定義(XSD)ファイルまたはサンプル・ファイルを使用して生成できます。メディエータを使用する場合は、次のいずれかのタイミングでWSDLファイルを生成できます。
メディエータの作成時に「メディエータの作成」ダイアログの「WSDLからのインタフェース定義」テンプレートを選択した場合は、「WSDL URL」フィールドの横にある「スキーマからWSDLを生成します。」を選択すると、「WSDLの作成」ダイアログが開きます。
インタフェース定義を使用しないメディエータで、メディエータ・エディタの「WSDL URL」フィールドの横にある「サービスの定義」をクリックした場合は、「WSDL URL」フィールドの横にある「スキーマからWSDLを生成します。」を選択すると、「WSDLの作成」ダイアログが開きます。
「WSDLの作成」ダイアログでファイル名、ディレクトリ、ネームスペースなどの標準フィールドが移入され、選択するインタフェース・タイプに応じてダイアログが変更されます。入力メッセージに対して、同一または異なるスキーマ・ファイルを指定できます。
WSDLファイルの構成方法は、WSDLファイルで定義されているインタフェースのタイプによって異なります。一方向インタフェース、同期インタフェースまたは非同期インタフェースを定義できます。
XSDファイルから一方向インタフェース用のWSDLファイルを生成する手順は、次のとおりです。
メディエータを作成する場合や、メディエータのサービスを定義する場合は、「WSDLの作成」ダイアログが表示された後に、これらの手順を実行します。
「WSDLの作成」ダイアログで、デフォルト値を受け入れるか、表19-2に示すWSDLファイルの情報を入力します。
表19-2 WSDLのプロパティ
| プロパティ | 説明 |
|---|---|
|
ファイル名 |
WSDLファイルの一意の名前。 |
|
ディレクトリ |
WSDLファイルを格納するディレクトリ。デフォルトでは、メディエータ・ファイルと同じ場所に格納されます。これは現在のプロジェクトのディレクトリまたはそのサブディレクトリの1つである必要があります。指定したディレクトリが存在しない場合は、Oracle JDeveloperにより作成されます。 |
|
ネームスペース |
WSDLファイルのネームスペース・アドレス。例: 指定するネームスペースは、WSDLファイルの |
|
ポート・タイプ |
使用する操作が含まれるWSDLファイルのポート・タイプの名前。 |
|
操作 |
実行するアクションの名前。例: |
|
注意: 操作名またはポート・タイプに空白および特殊文字は使用できません。英数字のみがサポートされ、最初の文字を数値にすることはできません。 |
「インタフェース・タイプ」フィールドで、「一方向インタフェース」を選択します。
図19-21に示すように、「入力」フィールドが表示されます。
「入力」フィールドの右上で、「新規メッセージ・パートを追加します。」をクリックします。
図19-22に示すように、「メッセージ・パートの追加」ダイアログが表示されます。
「パート名」フィールドに、メッセージ・パートの名前を入力します。
「URL」フィールドの右側にある「スキーマ・ファイルを参照」アイコンをクリックして、URLを参照します。
図19-23に示すように、「タイプ・チューザ」ダイアログが表示され、これにはスキーマ・ファイル(XSDファイル)のリストが含まれます。
「タイプ・エクスプローラ」ツリーを開き、検索して使用するスキーマ要素を選択します。
使用するスキーマが作業中のプロジェクトにない場合は、ダイアログの右上にある「スキーマ・ファイルのインポート」または「WSDLのインポート」アイコンを使用して、スキーマXSDファイルまたはWSDLファイルをプロジェクトにインポートできます。
|
注意: ローカル・ファイル・システムのスキーマXSDファイルを使用する場合は、必ず、XSDファイルおよびそのファイルによってインポートされるXSDファイルすべてがOracle JDeveloperのプロジェクト・ディレクトリに存在している必要があります。これにより、スキーマがプロジェクトにデプロイされ、実行時に使用可能になります。 |
ファイルを指定すると、Oracle JDeveloperによってファイルが解析されて定義済のスキーマ要素が決定され、選択するリストに表示されます。
XSDファイルのルート要素を選択し、「OK」をクリックします。
「タイプ・チューザ」ダイアログから「URL」および「スキーマ要素」フィールドが移入された状態の「メッセージ・パートの追加」ダイアログが再表示されます。XSDの単純型を選択した場合、これらのフィールドは、「単純型」フィールドに置換されます。
「メッセージ・パートの追加」ダイアログで、「OK」をクリックします。
「WSDLの作成」ダイアログの「入力」フィールドに、入力情報が表示されます。
必要に応じて、前述の手順を繰り返し、追加のメッセージ・パートを定義します。
「OK」をクリックします。
|
注意: パートナ・リンク・タイプは通常BPELで使用されるため、メディエータに「partnerlinkType拡張機能の生成」を選択する必要はありません |
XSDファイルから同期インタフェース用のWSDLファイルを生成する手順は、次のとおりです。
メディエータを作成する場合や、メディエータのサービスを定義する場合は、「WSDLの作成」ダイアログが表示された後に、これらの手順を実行します。
「WSDLの作成」ダイアログで、表19-2「WSDLのプロパティ」にリストされているプロパティの情報を入力します。
「インタフェース・タイプ」フィールドで、「同期インタフェース」を選択します。
図19-24に示すように、「入力」、「出力」および「フォルト」フィールドが表示されます。
「入力」フィールドの右上で、「新規メッセージ・パートを追加します。」をクリックします。
図19-25に示すように、「メッセージ・パートの追加」ダイアログが表示されます。
「パート名」フィールドに、メッセージ・パートの名前を入力します。
「URL」フィールドの右側にある「スキーマ・ファイルを参照」アイコンをクリックして、URLを参照します。
図19-26に示すように、「タイプ・チューザ」ダイアログが表示され、これにはスキーマ・ファイル(XSDファイル)のリストが含まれます。
「タイプ・エクスプローラ」ツリーを開き、検索して使用するスキーマ要素を選択します。
使用するスキーマが作業中のプロジェクトにない場合は、ダイアログの右上にある「スキーマ・ファイルのインポート」または「WSDLのインポート」アイコンを使用して、スキーマXSDファイルまたはWSDLファイルをプロジェクトにインポートできます。
|
注意: ローカル・ファイル・システムのスキーマXSDファイルを使用する場合は、必ず、XSDファイルおよびそのファイルによってインポートされるXSDファイルすべてがOracle JDeveloperのプロジェクト・ディレクトリに存在している必要があります。これにより、スキーマがプロジェクトにデプロイされ、実行時に使用可能になります。 |
ファイルを指定すると、Oracle JDeveloperによってファイルが解析されて定義済のスキーマ要素が決定され、リストに選択肢として表示されます。
XSDファイルのルート要素を選択し、「OK」をクリックします。
「タイプ・チューザ」ダイアログから「URL」および「スキーマ要素」フィールドが移入された状態の「メッセージ・パートの追加」ダイアログが再表示されます。XSDの単純型を選択した場合、これらのフィールドは、「単純型」要素に置換されます。
「メッセージ・パートの追加」ダイアログで、「OK」をクリックします。
「WSDLの作成」ダイアログの「入力」フィールドに、入力情報が表示されます。
前述の手順を繰り返して、「出力」および「フォルト」フィールドのメッセージ・パートを定義します。
出力はレスポンス・メッセージを表し、同期トランザクションに必要です。オプションは「フォルト」です。
「OK」をクリックします。
|
注意: パートナ・リンク・タイプは通常BPELで使用されるため、メディエータに「partnerlinkType拡張機能の生成」を選択する必要はありません |
XSDファイルから非同期インタフェース用のWSDLファイルを生成する手順は、次のとおりです。
メディエータを作成する場合や、メディエータのサービスを定義する場合は、「WSDLの作成」ダイアログが表示された後に、これらの手順を実行します。
「WSDLの作成」ダイアログで、表19-2「WSDLのプロパティ」にリストされているプロパティの情報を入力します。
「インタフェース・タイプ」フィールドで、「非同期インタフェース」を選択します。
図19-27に示すように、「入力」フィールドおよび「コールバック」セクションが表示されます。
最初に、「入力」フィールドの右上で、「新規メッセージ・パートを追加します。」をクリックします。
図19-28に示すように、「メッセージ・パートの追加」ダイアログが表示されます。
「パート名」フィールドに、メッセージ・パートの名前を入力します。
「URL」フィールドの右側にある「スキーマ・ファイルを参照」アイコンをクリックして、URLを参照します。
図19-29に示すように、「タイプ・チューザ」ダイアログが表示され、これにはスキーマ・ファイル(XSDファイル)のリストが含まれます。
「タイプ・エクスプローラ」ツリーを開き、検索して使用するスキーマ要素を選択します。
使用するスキーマが作業中のプロジェクトにない場合は、ダイアログの右上にある「スキーマ・ファイルのインポート」または「WSDLのインポート」アイコンを使用して、スキーマXSDファイルまたはWSDLファイルをプロジェクトにインポートできます。
|
注意: ローカル・ファイル・システムのスキーマXSDファイルを使用する場合は、必ず、XSDファイルおよびそのファイルによってインポートされるXSDファイルすべてがOracle JDeveloperのプロジェクト・ディレクトリに存在している必要があります。これにより、スキーマがプロジェクトにデプロイされ、実行時に使用可能になります。 |
ファイルを指定すると、Oracle JDeveloperによってファイルが解析されて定義済のスキーマ要素が決定され、リストに選択肢として表示されます。
XSDファイルのルート要素を選択し、「OK」をクリックします。
「タイプ・チューザ」ダイアログから「URL」および「スキーマ要素」フィールドが移入された状態の「メッセージ・パートの追加」ダイアログが再表示されます。XSDの単純型を選択した場合、これらのフィールドは、「単純型」要素に置換されます。
「メッセージ・パートの追加」ダイアログで、「OK」をクリックします。
「WSDLの作成」ダイアログの「入力」フィールドに、入力情報が表示されます。
前述の手順を繰り返して、「コールバック」セクションの入力メッセージ・パートを定義します。
|
注意: コールバック入力はレスポンス・メッセージを表し、非同期トランザクションに必要です。 |
「コールバック」セクションで、レスポンス・メッセージに関する次の情報を指定します。
ポート・タイプ: 使用する操作が含まれるWSDLファイルのポート・タイプの名前。
操作: 実行するアクションの名前。例: executeResponse。
|
注意: 操作名またはポート・タイプに空白および特殊文字は使用できません。英数字のみがサポートされ、最初の文字を数値にすることはできません。これらのフィールドの両方が必要です。 |
「OK」をクリックします。
|
注意: パートナ・リンク・タイプは通常BPELで使用されるため、メディエータに「partnerlinkType拡張機能の生成」を選択する必要はありません |
サンプル・ファイルに基づいたWSDLファイルの生成
WSDLファイルは、カンマ区切り値(CSV)ファイル、固定長ファイル、Document Type Definition (DTD)ファイル、COBOLコピーブック・ファイルなどのネイティブ・フォーマットのファイルから生成できます。ネイティブ・フォーマット・ビルダー・ウィザードを使用して、サンプル・ファイルに基づいたWSDLファイルを生成します。このネイティブ・フォーマット・ビルダー・ウィザードは、「WSDLの作成」ダイアログの「リクエスト」、「レスポンス」、「フォルト」および「コールバック」タブにある「ネイティブ・フォーマットのスキーマの定義」をクリックすると表示されます。WSDLファイルは、ウィザード完了後に生成されます。
ネイティブ・フォーマット・ビルダー・ウィザードの詳細は、『Oracle Fusion Middlewareテクノロジ・アダプタ・ユーザーズ・ガイド』を参照してください。
メディエータを作成した後は、そのコンポーネントに指定されている操作またはイベント・サブスクリプションのプロパティを構成できます。メディエータ・エディタで、インバウンド・メッセージのスキーマを検証するかどうかを指定し、操作またはイベント・サブスクリプションの優先度を指定できます。
インバウンド・メッセージのスキーマを検証するには、メディエータ・エディタの「ルーティング・ルール」セクションで、操作またはイベント・サブスクリプションの「有効な構文(XSD)の検証」チェック・ボックスを選択します。
Oracle Mediatorコンポーネントの優先度を指定するには、メディエータ・エディタの「ルーティング・ルール」セクションの「優先度」フィールドで0から9の間の値を選択します。これにより、すべてのOracle Mediatorサービス・コンポーネントにおいてメッセージが取得される順序が決まります。このプロパティは、パラレルのルーティング・ルールの場合のみ有効で、順次ルーティング・ルールの場合は無効です。優先度の詳細は、「パラレルのルーティング・ルールの基本原則」を参照してください。
メディエータの操作またはイベント・サブスクリプションは、メディエータ・エディタを使用して変更できます。
操作を追加または削除することで、Oracle MediatorのWSDLファイルを変更できます。WSDLファイルの変更後、「WSDLのリフレッシュ」ダイアログを使用して変更を同期化します。
操作を変更する手順は、次のとおりです。
メディエータ・エディタで、「WSDL URL」フィールドの右側にある「WSDLからの操作のリフレッシュ」アイコンをクリックします。
「WSDLのリフレッシュ」ダイアログが表示されます。WSDLファイルが変更された場合、「WSDLのリフレッシュ」ダイアログには削除または追加される操作がすべて一覧表示されます。「リフレッシュにより、次のメディエータ操作が削除されます」フィールドには、WSDLファイルから削除された操作がすべて一覧表示されます。「リフレッシュにより、次のメディエータ操作が追加されます」フィールドに、WSDLファイルに追加された新規操作がすべて一覧表示されます。図19-30に、「WSDLのリフレッシュ」ダイアログを示します。
別のWSDLファイルを指定するには、「WSDL URL」フィールドの右側にある「既存のWSDLを検索します。」をクリックして既存のWSDLファイルを使用するか、または「スキーマからWSDLを生成します。」をクリックしてWSDLファイルを作成します。
「WSDLのリフレッシュ」ダイアログは、指定のWSDLファイルで定義された操作に基づいて更新されます。
「OK」をクリックします。
「ファイル」メニューから「すべて保存」を選択します。
メディエータ・エディタの「イベント・サブスクリプションの管理」オプションを使用すると、新規イベントのサブスクライブ、既存イベント・サブスクリプションの変更およびサブスクライブ済イベントからのサブスクライブ解除などを実行できます。
イベント・サブスクリプションを変更する手順は、次のとおりです。
メディエータ・エディタで、「イベント・サブスクリプション」の右側にある「イベント・サブスクリプションの管理」アイコンをクリックします。
図19-31に示すように、「サブスクライブ済イベント」ダイアログが表示されます。
次の機能のいずれも実行できます。
新規イベントをサブスクライブします。
イベントからサブスクライブ解除します。
イベントのフィルタ基準を変更または指定します。
イベント・サブスクリプションの「一貫性」または「ロールとして実行」プロパティを変更します。
イベントの「一貫性」、「ロールとして実行」および「フィルタ」フィールドの詳細は、第19.5.1項「メディエータのインタフェース定義の構成方法」を参照してください。
「OK」をクリックします。
「ファイル」メニューから「すべて保存」を選択します。
