> チュートリアル > チュートリアル 1. 融資申し込みのルーティング

チュートリアル

     前  次    新しいウィンドウで目次を開く     
ここから内容

チュートリアル 1. 融資申し込みのルーティング

AquaLogic Service Bus を使用して、エンタープライズ環境でビジネス サービス間の適応性のあるメッセージ ルーティングを行うことができます。AquaLogic Service Bus を介してクライアントからのメッセージを適切なビジネス サービスにルーティングできます。AquaLogic Service Bus は、メッセージ処理ロジックでコンフィグレーションされたアクションに基づいて 1 つまたは複数の送り先にメッセージをルーティングします。これらのルーティング アクションは、AquaLogic Service Bus Console を使用してコンフィグレーションします。ルーティングは、システム間で多数の静的なポイントツーポイントの Web サービス接続を確立する効率的な方法です。

この節の内容は以下のとおりです。

 

前提条件

このチュートリアルを開始する前に、次のチュートリアルを完了している必要があります。

 

チュートリアルの目的

このチュートリアルの目的は、AquaLogic Service Bus Console のグラフィカル環境を使用してルーティング シナリオを作成およびテストすることです。以下のタスクがあります。

重要な機能

このチュートリアルを通じて、BEA AquaLogic Service Bus の次の機能について学習できます。

 

シナリオの定義

主要な金融会社が、AquaLogic Service Bus を使用して、要求された金利に基づいて融資申し込みを適切なビジネス サービスにルーティングします。5% 未満の金利を要求する申し込みは、管理者の承認が必要であり、その処理を行う適切なビジネス サービスにルーティングされます。それ以外の融資申し込みはすべて、別のビジネス サービスにルーティングされて処理されます。対象のビジネス サービスは、その融資申し込みを承認するか拒否するかを示す応答を返します。

次の図は、このシナリオをサポートする論理アーキテクチャの概要を示しています。AquaLogic Service Bus が企業においてクライアントとビジネス サービスの間のメッセージングを仲介する方法を示します。

図 3-1 AquaLogic Service Bus を介した融資申し込み要求 Web サービスのエクスポーズ

AquaLogic Service Bus を介した融資申し込み要求 Web サービスのエクスポーズ

AquaLogic Service Bus の実行時処理の概要

融資申し込みをクライアントからプロキシ サービス LoanGateway1 に送信します。デフォルト プロキシ サービスには、融資申し込みドキュメントの要求金利の値をチェックする条件付きルーティング ステージがあります。金利が 5% 未満の場合、融資要求は ManagerLoanReview ビジネス サービスにルーティングされ、5% 以上の場合は NormalLoan ビジネス サービスにルーティングされます。対象ビジネス サービスから次のメッセージのような応答が返されます。 

Loan Application Response: APPROVED BY THE <i><b>MANAGER</b></i> LOAN APPLICATION REVIEW SERVICE.
注意 : 融資要求が NormalLoan ビジネス サービスによって処理される場合、生成される応答の MANAGER は NORMAL に置き換えられます。

必要なリソース

次の表は、このチュートリアルの開発および実行に必要なリソースです。

表 3-1 「融資申し込みのルーティング」チュートリアルのリソース
リソース名
説明
normalLoan
WSDL リソース
NormalLoan
AquaLogic Service Bus で使用する外部ビジネス サービス
ManagerLoanReview
AquaLogic Service Bus で使用する外部ビジネス サービス
LoanGateway1
AquaLogic Service Bus のプロキシ サービス

 

このチュートリアルの手順

このチュートリアルでは、AquaLogic Service Bus を使用し、金融会社の融資申し込みを、要求された金利に応じて対象 Web サービスにルーティングします。以下の手順を実行することによって、プロキシ サービスと関連するリソースを AquaLogic Service Bus で設計およびコンフィグレーションし、この使用例のシナリオを実装できます。

手順 1 : 環境の準備

このチュートリアル用に作成したドメインで AquaLogic Service Bus が動作していること、および「チュートリアルのセットアップ」の説明どおりに手順が完了していることを確認します。

手順 2 : セッションの作成とプロジェクトの設定

AquaLogic Service Bus Console を使用して、AquaLogic Service Bus 環境でリソースおよびコンフィグレーションをモニタできます。システムのモニタは、セッションを開始しなくても実行できます。ただし、リソースを更新または削除してコンフィグレーション プロパティを変更するには、まず AquaLogic Service Bus Console でアクティブなセッションを作成する必要があります。

コンソールの [Change Center] からセッションの作成と管理を行えます。現在のセッション中のシステム コンフィグレーションに対するすべての更新は、一時ファイルとして保存されます。これらの変更は、現在のセッションがアクティブ化されたときにのみ有効になります。次の図は、AquaLogic Service Bus Console で利用できる [Change Center] ペインです。

図 3-2 [Change Center] を使用したセッションの管理

[Change Center] を使用したセッションの管理

セッションの作成とアクティブ化に加えて、[Change Center] では次の表に示す追加機能も実行できます。

表 3-2 [Change Center] のオプション
ボタン
説明
[作成]
新しいセッションを作成する。セッションを作成してコンフィグレーションを変更する必要がある。[終了] 機能を使用してこのセッションを終了しても、[編集] をクリックして再開できる。セッションを再開したら、リソースの変更を続行できる。
[編集]
作成して終了したセッションを開始する。[編集] を使用する前に、セッションをアクティブ化する必要がある。
[終了]
セッションを中断し、セッションの状態を保存する。中断されたセッションを再開するには、[編集] をクリックする。
[破棄]
変更を保存しないで現在のセッションを終了する。
[アクティブ化]
現在のコンフィグレーションをランタイムに保存する。
[アクティブ化] をクリックすると、[セッションのアクティブ化] ページが表示される。このページには、アクティブ セッションのユーザとセッション名が表示される。必要であれば、説明を追加することができる。[送信] をクリックすると、現在のセッションのコンフィグレーションがランタイムに保存される。

注意 : [作成] をクリックしてから、コンソールでシステム コンフィグレーション設定を変更することをお勧めします。コンフィグレーションの変更はこまめに保存してください。現在のセッションのコンフィグレーション変更を保存してアクティブ化するには、一連の変更を完了してから [アクティブ化] をクリックする必要があります。

MortgageBroker プロジェクトとファイル フォルダの作成

AquaLogic Service Bus システム環境では、システム コンフィグレーション エンティティはユーザ定義のプロジェクトにグループ化されます。AquaLogic Service Bus Console の [プロジェクト エクスプローラ] ページには、[Projects] フォルダの下にデフォルトのプロジェクトおよびさまざまなユーザ定義のプロジェクトが表示されます。このページから、すべてのプロジェクトのコンフィグレーション タスクを実行できます。各プロジェクトは、コンソール上でプロジェクト フォルダ別に表されます。新しいプロジェクト フォルダを追加し、プロジェクト ツリーを移動できます。必要に応じてフォルダをクリックすることで、フォルダを折りたたんだり展開することができます。

AquaLogic Service Bus システム環境には、事前定義された 3 つのリソース タイプがあります。各リソース タイプは、プロジェクト フォルダ内のサブフォルダとして表されます。リソース タイプのフォルダ内に別のリソース タイプを作成し、コンフィグレーションできます。

この節では、セッションを開始し、[Projects] フォルダの下に MortgageBroker プロジェクトを作成する手順について説明します。このシナリオでは、MortgageBroker プロジェクトに 3 つのリソース フォルダを作成して、事前定義された次のリソース タイプをそれぞれ保持します。

セッションを開始してプロジェクトを作成するには
  1. [Change Center] で [作成] をクリックして新しいセッションを作成します。
  2. AquaLogic Service Bus Console のナビゲーション ペインで [プロジェクト エクスプローラ] を選択します。

    3. ナビゲーション ペインに [プロジェクト エクスプローラ] が開き、コンソールにプロジェクト ページが表示されます。

  3. [プロジェクト] セクションの [新しいプロジェクト名の入力] フィールドに、次の図に示すように「MortgageBroker」と入力します。
    4. 図 3-3 プロジェクトの作成


    プロジェクトの作成

  4. [プロジェクトの追加] をクリックします。

MortgageBroker プロジェクトが作成され、[プロジェクト エクスプローラ] の [Projects] の下に表示されます。

まず WSDL フォルダを作成し、このフォルダに WSDL リソースを追加する必要があります。WSDL はビジネス サービスおよびプロキシ サービスを作成するための基礎となります。次に、このシナリオで使用するその他のフォルダを作成します。

プロジェクト フォルダを作成するには
  1. [プロジェクト エクスプローラ] で MortgageBroker プロジェクトをクリックして関連するプロジェクト ページを開きます。
  2. [プロジェクト] ページの [フォルダ] にあるフィールドにフォルダ名を入力します。この場合は、次の図に示すように「WSDL」と入力します。
    3. 図 3-4 フォルダの作成


    フォルダの作成

  3. [フォルダの追加] をクリックします。

    4. WSDL フォルダが MortgageBroker プロジェクトのプロジェクト フォルダ リストに表示されます。

  4. 手順 2 と手順 3 を繰り返して ProxyService フォルダと BusinessService フォルダを作成します。
  5. 3 つのフォルダをすべて作成したら、[アクティブ化] をクリックし、[送信] をクリックして、プロジェクトのディレクトリ構造を保存します。[Change Center] の環境設定オプションについては、「表 3-2 [Change Center] のオプション」を参照してください。

手順 3 : WSDL リソースの作成

AquaLogic Service Bus リソースをウィザードに従ってコンフィグレーションします。各ウィザードには、リソースに関する情報の入力をユーザに要求し、プロパティのコンフィグレーション オプションを表示する一連のページがあります。

normalLoan WSDL リソースの作成

WSDL は、クライアントとサービスとのパブリック コントラクト (インタフェース仕様) を定義し、サービスがプロキシ サービスまたはビジネス サービスのどちらであるかを示します。WSDL は Web サービスの正式な記述です。WSDL は Web サービスのインタフェースの内容、保存先、呼び出し方法の記述に使用されます。まず、WSDL リソースを作成します。これは、それ以降のサービス登録手順が WSDL リソースに依存するためです。次に、WSDL を使用してビジネス サービスを登録し、プロキシ サービスを作成します。

WSDL をインポートするには
  1. [Change Center] で [作成] をクリックして新しいセッションを作成します。
  2. AquaLogic Service Bus Console のナビゲーション ペインで [プロジェクト エクスプローラ] を選択します。
  3. [プロジェクト エクスプローラ] で MortgageBroker をクリックしてフォルダを展開し、WSDL をクリックして WSDL フォルダを開きます。
  4. [リソース] ペインで、[リソースの種類の選択] ドロップダウン リストから [WSDL] を選択します。
    5. 図 3-5 リソースの種類の選択


    リソースの種類の選択

    [新しい WSDL リソースの作成] ページが表示されます。

  5. [新しい WSDL リソースの作成] ページで以下の情報を入力します。
    1. リソース名を「normalLoan」と入力します。
    2. [参照] をクリックして標準融資プロセスに関連する WSDL の場所を探します。
      3. BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic\normal\NormalLoanApprovalService.wsdl
    3. 必要に応じて、[リソースの説明] にリソースの説明を入力できます。
    4. [保存] をクリックして WSDL リソースを作成します。

      5. リソースが [リソース] ペインに表示されます。表示される [新しい WSDL リソースの作成] ページは、次の図のようになります。

      図 3-6 WSDL リソースの作成


      WSDL リソースの作成

これで、normalLoan WSDL リソースが WSDL フォルダに作成されました。

managerApproval WSDL リソースの作成

「WSDL をインポートするには」の手順を使用して、ManagerApproval サービスと関連する WSDL リソースを作成する必要があります。ManagerApproval サービスの WSDL リソースをインポートするには、次の表に示すコンフィグレーション パラメータを使用します。

表 3-3 ManagerApproval サービスの WSDL
コンフィグレーション パラメータ
値
リソース名
managerApproval
ManagerApprovalService WSDL
BEA_HOME\weblogic92\servicebus\examples\src\examples\webservices\jws_basic\manager\ManagerApprovalService.wsdl

手順 4 : プロキシ サービスの作成

この手順では、プロキシ サービスを作成します。プロキシ サービスを使用して融資申し込みを適切なビジネス サービスにルーティングします。

プロキシ サービスを作成するには
  1. [プロジェクト エクスプローラ] で MortgageBroker プロジェクトを選択します。プロジェクト フォルダが展開してプロジェクトのディレクトリ構造が表示されます。
  2. ProxyService フォルダを選択します。[MortgageBroker/ProxyService] ページが表示されます。
  3. [リソースの種類の選択] ドロップダウン リストから [プロキシ サービス] を選択します。

    4. [プロキシ サービスの作成 - 全般的なコンフィグレーション] ページが次の図のように表示されます。

    図 3-7 プロキシ サービスの作成


    プロキシ サービスの作成

  4. プロキシの [サービス名] に「LoanGateway1」と入力します。
  5. [サービスの種類] で、[WSDL Web サービス] を選択してから [参照] をクリックします。

    6. [WSDL の選択] ページが表示されます。プロキシ サービスは最初に作成した WSDL リソースに基づいているため、その WSDL リソースをここで参照する必要があります。

  6. normalLoan WSDL を選択します。WSDL 定義ペインに WSDL のコンテンツ カテゴリが表示されます。
    7. 図 3-8 WSDL 定義の選択


    WSDL 定義の選択

    1. [WSDL 定義の選択] ペインの [ポート] カテゴリから、normalLoan WSDL 用の WSDL ポート (helloPort) をクリックします。
    2. [送信] をクリックして選択を終了します。ポート名が、次の図に示すように WSDL ポートのテキスト フィールドに表示されます。
      3. 図 3-9 LoanGateway1 プロキシ サービス


      LoanGateway1 プロキシ サービス

  7. [次へ] をクリックしてプロキシ サービスのコンフィグレーションを続行します。

    8. [プロキシ サービスの作成 - 転送コンフィグレーション] ページが次の図のように表示されます。

    図 3-10 プロキシ サービスの転送コンフィグレーション


    プロキシ サービスの転送コンフィグレーション

  8. デフォルト プロトコルの [http] をそのまま使用します。
    9. 注意 : このページで選択したプロトコルによって、次の手順で指定するエンドポイント URI の形式が決まります。ほとんどのサービスで使用されるため、想定されるデフォルトのプロトコルは http です。
  9. [エンドポイント URI] を /loan/gateway1 に設定します。これはクライアントからのメッセージの送信先 URI です。
  10. [すべてのヘッダを取得] オプションのデフォルト ([いいえ]) をそのまま使用します。
  11. [次へ] をクリックします。

    12. [プロキシ サービスの作成 - HTTP 転送コンフィグレーション] ページが次の図のように表示されます。

    図 3-11 プロキシ サービスの HTTP 転送コンフィグレーション


    プロキシ サービスの HTTP 転送コンフィグレーション

  12. 転送コンフィグレーションのデフォルト設定をそのまま使用します。[次へ] をクリックします。

    13. [プロキシ サービスの作成 - メッセージ レベル セキュリティのコンフィグレーション] ページが次の図のように表示されます。

    図 3-12 プロキシ サービスのメッセージ レベル セキュリティのコンフィグレーション


    プロキシ サービスのメッセージ レベル セキュリティのコンフィグレーション

    Web サービスのセキュリティ ポリシーを定義していないため、このページのカスタム認証設定をコンフィグレーションする必要はありません。

  13. メッセージ レベル セキュリティのコンフィグレーションのデフォルト設定をそのまま使用します。[次へ] をクリックします。

    14. [プロキシ サービスの作成 - 操作選択コンフィグレーション] ページが次の図のように表示されます。このページは、呼び出す Web サービス操作を識別するメッセージのメタデータを選択するページです。

    図 3-13 プロキシ サービスの操作選択コンフィグレーション


    プロキシ サービスの操作選択コンフィグレーション

  14. デフォルトの [SOAP 本体の種類] 選択アルゴリズムをそのまま使用します。
    15. 注意 : デフォルトのサービスは RPC Web サービスです。この結果、SOAP 本体にサービス操作の選択情報が含まれます。Java Web サービスの WSDL の操作は、Java Web サービスの public メソッドに相当します。クライアントで選択できる public メソッドが複数ある場合は、各 public メソッド タイプに WSDL の操作定義があります。SOAP ベースの RPC サービスの場合、SOAP 本体はクライアントで選択された操作 (メソッド) を示します。操作は、SOAP ヘッダで指定することもできますが、通常は SOAP 本体で指定します。
  15. [次へ] をクリックします。

    16. [プロキシ サービスの作成 - 概要] ページが次の図のように表示されます。このページには、プロキシ サービスのコンフィグレーション設定の概要が表示されます。

    図 3-14 プロキシ サービス - コンフィグレーション設定の概要


    プロキシ サービス - コンフィグレーション設定の概要

    プロキシ サービスを登録する前に、コンフィグレーション設定を確認し、必要に応じて [編集] をクリックして変更できます。

  16. プロキシ サービスのコンフィグレーション設定に問題がなければ、[保存] をクリックしてサービスを登録します。
    17. 注意 : [Change Center] でセッションのコンフィグレーションをアクティブ化する前に、必ず [保存] をクリックしてください。

    LoanGateway1 プロキシ サービスが MortgageBroker プロジェクトの ProxyService フォルダの [リソース] ペインに表示されます。

    図 3-15 [リソース] ペインのプロキシ サービス


    [リソース] ペインのプロキシ サービス

  17. LoanGateway1 プロキシ サービスのモニタを有効にするには、[リソース] ペインにある LoanGateway1 プロキシ サービスに対応する [モニタの管理] アイコン [リソース] ペインのプロキシ サービス をクリックします。

    18. [プロキシ サービスの表示] ページが次の図のように表示されます。このページの [操作設定] タブには、プロキシ サービスのモニタを有効にするオプションがあります。

    図 3-16 プロキシ サービスのモニタ コンフィグレーション


    プロキシ サービスのモニタ コンフィグレーション

    モニタを有効にするには、以下の手順を実行します。

    1. [操作設定] タブをクリックします。
    2. [サービスのモニタ] 設定の [有効] チェックボックスを選択します。
    3. サービスの集約間隔を入力します。集約間隔とは、AquaLogic Service Bus Console ダッシュボードに表示される、サービスに関連する集約統計を計算する間隔です。[集約間隔] 設定のデフォルト値は 10 分に設定されています。

      4. AquaLogic Service Bus ダッシュボードの使用とサービスのモニタの詳細については、以下を参照してください。
      AquaLogic Service Bus Console の使い方の「モニタ」
      BEA AquaLogic Service Bus オペレーション ガイドの「モニタ」

    4. [更新] をクリックします。
    5. [モニタ コンフィグレーション] ページの下部にある [戻る] ボタンをクリックして、[MortgageBroker/ProxyService] フォルダ ページに戻ります。

これで、AquaLogic Service Bus Console での LoanGateway1 プロキシ サービスのコンフィグレーションは完了しました。

手順 5 : ビジネス サービスの作成

融資ルーティングのシナリオでは、要求金利が 5% 以上の融資申し込みは、標準融資処理サービスにルーティングされて審査を受けます。要求金利が 5% 未満の融資申し込みは管理者の承認が必要であるため、管理者承認サービスにルーティングされます。

以下の手順を実行します。

NormalLoan ビジネス サービスの作成
  1. [プロジェクト エクスプローラ] で、[MortgageBroker] プロジェクト ツリーから [BusinesService] フォルダを選択します。
    2. 注意 : このフォルダがプロジェクト ツリーに表示されない場合は、[アクティブ化] をクリックし、[送信] をクリックして、セッションの変更を登録します。MortgageBroker プロジェクト用に作成したフォルダが表示されます。[作成] をクリックしてセッションを開始し、システム コンフィグレーションを変更します。
  2. [リソースの種類の選択] ドロップダウン リストから [ビジネス サービス] を選択します。

    3. [ビジネス サービスの作成 - 全般的なコンフィグレーション] ページが次の図のように表示されます。

    図 3-17 ビジネス サービスの作成


    ビジネス サービスの作成

  3. サービスの名前を入力します。ここでは「NormalLoan」と入力します。
  4. [サービスの種類] で [WSDL Web サービス] を選択して [参照] をクリックし、ビジネス サービスで使用する WSDL とポートを以下のように指定します。
    1. [WSDL ブラウザ] で [normalLoan] WSDL を選択します。
    2. WSDL のポート (helloPort) を選択します。
    3. [送信] をクリックします。

      4. [WSDL ポート] (サービスの種類) のテキスト フィールドに、[ビジネス サービスの作成 - 全般的なコンフィグレーション] ページで選択した値が表示されます。

  5. [次へ] をクリックします。

    6. [ビジネス サービスの作成 - 転送コンフィグレーション] ページが次の図のように表示されます。

    図 3-18 ビジネス サービスの転送コンフィグレーション


    ビジネス サービスの転送コンフィグレーション

  6. デフォルト プロトコルの [http] をそのまま使用します。
  7. [ロード バランシング アルゴリズム] に [なし] を選択します。これは、ロード バランシングが関係するのは、サービスが複数のエンドポイントを指定する場合のみであるためです。

    8. 複数のエンドポイントとロード バランシング アルゴリズムを指定した場合、1 つのエンドポイントが実行時に過負荷状態または使用できない状態であれば、エンドポイント URI のリスト上の次のサービスにメッセージをディスパッチできます。この例はサービスが 1 つしか存在しないため、デフォルトの動作をそのまま使用するか、または [なし] を選択しても、実行時のプロキシ サービスの動作に影響しません。

  8. ビジネス サービスのエンドポイント URI は、サービスがデプロイされているサーバのエンドポイント URI です。[既存の URI] フィールドに表示されているエンドポイント URI の値が http://<host:port>/njws_basic_ejb/NormalSimpleBean であることを確認します。

    9. <host:port> で指定されたホストとポートの値は、AquaLogic Service Bus サーバが動作するマシンとポートを表します。これらの値は、プロパティ ファイル BEA_HOME\weblogic92\samples\servicebus\examples\src\examples.properties に指定された値と同じである必要があります。

    詳細については、「examples.properties ファイルのコンフィグレーション」を参照してください。

    注意 : [既存の URI] リストの無効なエンドポイント URI を削除してください。
  9. このページの他のオプションにはデフォルト設定をそのまま使用します。[次へ] をクリックします。

    10. [ビジネス サービスの作成 - HTTP 転送コンフィグレーション] ページが次の図のように表示されます。

    図 3-19 ビジネス サービスの HTTP 転送コンフィグレーション


    ビジネス サービスの HTTP 転送コンフィグレーション

  10. このページのデフォルト設定をそのまま使用します。[次へ] をクリックします。

    11. [ビジネス サービスの作成 - SOAP バインディング コンフィグレーション] ページが次の図のように表示されます。

    図 3-20 ビジネス サービスの SOAP バインディング コンフィグレーション


    ビジネス サービスの SOAP バインディング コンフィグレーション

  11. このページのデフォルト設定をそのまま使用します。[次へ] をクリックします。

    12. [ビジネス サービスの作成 - 概要] ページが次の図のように表示されます。ここで、ビジネス サービスのすべての設定が適切に実装されているかどうかを確認できます。

    図 3-21 ビジネス サービス - コンフィグレーション設定の概要


    ビジネス サービス - コンフィグレーション設定の概要

  12. [保存] をクリックしてコンフィグレーションを設定します。

    13. NormalLoan ビジネス サービスのモニタを有効にするには、[リソース] ペインにある NormalLoan ビジネス サービスに対応する [モニタの管理] アイコン ビジネス サービス - コンフィグレーション設定の概要 をクリックします。[ビジネス サービスの表示] ページが次の図のように表示されます。このページの [操作設定] タブには、ビジネス サービスのモニタを有効にするオプションがあります。

    図 3-22 ビジネス サービスの表示ページ


    ビジネス サービスの表示ページ

    モニタを有効にするには、以下の手順を実行します。

    1. [操作設定] タブをクリックします。
    2. [モニタを有効化] チェック ボックスを選択します。
    3. 集約間隔を入力します。集約間隔とは、AquaLogic Service Bus Console (ダッシュボード) に表示される、サービスに関連する集約統計を計算する間隔です。

      4. AquaLogic Service Bus のダッシュボードの使用方法およびサービスのモニタの詳細については、以下を参照してください。
      AquaLogic Service Bus Console の使い方の「モニタ」

      BEA AquaLogic Service オペレーションズ ガイドの「モニタ」

    4. [更新] をクリックします。
    5. [モニタ コンフィグレーション] ページの [戻る] ボタンをクリックして、MortgageBroker プロジェクトの BusinessService フォルダのページに戻ります。

AquaLogic Service Bus Console での NormalLoan ビジネス サービスのコンフィグレーションが完了しました。

ManagerLoanReview ビジネス サービスの作成

要求金利が 5% 未満の融資申し込みのルーティング先ビジネス サービスの作成方法について説明します。

以下の表のコンフィグレーション パラメータを使用して、前述の「NormalLoan ビジネス サービスの作成」の手順を実行します。

表 3-4 ManagerLoanReview ビジネス サービス
コンフィグレーション パラメータ
値
ビジネス サービス名
ManagerLoanReview
ManagerApprovalService WSDL
BEA_HOME\weblogic92\servicebus\examples\src\examples\webservices\jws_basic\manager\ManagerApprovalService.wsdl に基づいて作成した managerApproval WSDL を選択する。

注意 : [helloPort] ポートを選択すること。
エンドポイント URI
http://<host:port>/mjws_basic_ejb/ManagerSimpleBean

まとめ

「手順 1 : 環境の準備」から「手順 5 : ビジネス サービスの作成」までを完了することで、このチュートリアルに必要なリソースである 2 つのビジネス サービス (NormalLoan と ManagerLoanReview)、1 つのプロキシ サービス (LoanGateway1)、および WSDL (normalLoan) を作成しました。

プロキシ サービスに基本コンフィグレーションを設定したら、次の手順 (手順 6 : LoanGateway1 プロキシ サービスのコンフィグレーション) に進み、融資申し込みのルーティング動作を追加してプロキシ サービスのコンフィグレーションを完了できます。

手順 6 : LoanGateway1 プロキシ サービスのコンフィグレーション

AquaLogic Service Bus のメッセージ フローは、プロキシ サービスの実装を定義します。メッセージ フローには、パイプライン ペア (プロキシ サービス、またはサービスの処理用の要求パイプラインと応答パイプライン) と、ステージ、パイプライン、およびプロキシ サービスに対して定義できるエラー ハンドラ パイプラインをゼロ個以上入れることができます。パイプラインには、1 つまたは複数のステージを入れることができ、ステージにはアクションを入れることができます。LoanGateway1 プロキシ サービスのルーティング動作をコンフィグレーションするには、メッセージ フローに対して次の操作を行います。

メッセージ フローのルーティング動作のコンフィグレーション
  1. [プロジェクト エクスプローラ] で、[MortgageBroker] プロジェクト ツリーから [ProxyService] フォルダを選択します。
    2. 注意 : リソースの編集はセッション内で行う必要があります。セッションを開始していない場合は、[Change Center] で [作成] をクリックしてセッションを開始し、プロキシ サービスのコンフィグレーションやメッセージ フローの編集ができるようにします。
  2. LoanGateway1 プロキシ サービスに対応する [アクション] カラムで、[メッセージ フローの編集] アイコン ビジネス サービスの表示ページ をダブルクリックします。プロキシ サービス LoanGateway1 の [メッセージ フローの編集] ページが表示されます (次の図を参照)。
    3. 図 3-23 LoanGateway1 プロキシ サービスのメッセージ フローの編集


    LoanGateway1 プロキシ サービスのメッセージ フローの編集

  3. [LoanGateway1] をクリックし、プルダウン メニューのオプションから [ルートの追加] を選択します。
    4. 図 3-24 LoanGateway1 プロキシ サービスのメッセージ フローのコンフィグレーション


    LoanGateway1 プロキシ サービスのメッセージ フローのコンフィグレーション

    RouteNode1 がコンフィグレーションのページに追加されます (次の図を参照)。

    図 3-25 ルート ノードの追加


    ルート ノードの追加

  4. [RouteNode1] をクリックし、ドロップダウン メニューのオプションから [ルートの編集] を選択します。

    5. [ステージ コンフィグレーションの編集 : ルート ノード] ページが、図 3-27 に示すように表示されます。このページには、[アクションの追加] という 1 つのリンクがあります。

    注意 : ステージはパイプラインの要素であり、パイプラインに定義されたアクションのコンテナです。アクションとは、実行時にプロキシ サービスを流れるメッセージの処理を定義するパイプライン ステージの要素です。
    図 3-26 [アクションの追加] リンク


    [アクションの追加] リンク

  5. [アクションの追加] リンクをクリックし、プルダウン メニューのオプションから [通信｜ルーティング テーブル] を選択します。
    6. 図 3-27 ルーティング テーブル要素の追加


    ルーティング テーブル要素の追加

    [ステージ コンフィグレーションの編集] ページにルーティング テーブルのコンフィグレーション ページが表示されます。

    図 3-28 ルーティング テーブルのコンフィグレーション ページ


    ルーティング テーブルのコンフィグレーション ページ

    着信メッセージの金利要素の値に基づいてビジネス サービスにメッセージをルーティングするように、ルーティング テーブルをコンフィグレーションする必要があります。XQuery 式エディタを使用して XQuery 式を作成することで、コンテンツ ベースのルーティングをコンフィグレーションできます。

  6. [ルーティング テーブル] の [<式>] をクリックします。[XQuery 式エディタ] ページが表示されます。
    7. 図 3-29 XQuery 式エディタ


    XQuery 式エディタ

  7. このページのデフォルトである [XQuery テキスト] をそのまま使用します。
  8. [ネームスペース定義] ペインで、[変数の構造] をクリックします。
    9. 図 3-30 [ネームスペース定義] ペイン


    [ネームスペース定義] ペイン

  9. [変数の構造] ペインが表示されます。[変数の構造] ペインの [構造の選択] ドロップダウン リストで [body] を選択します。
    10. 図 3-31 [変数の構造] ペイン


    [変数の構造] ペイン

  10. body 要素の構造が [変数の構造] ペインに表示されます。
  11. [+] をクリックして、[$body - processLoanApp (request)] 要素内にある [processLoanApp] 要素を展開します。
    12. 図 3-32 processLoanApp 要素


    processLoanApp<span style= Element" id="wp1103797"/>

  12. [+] をクリックして、[loanRequest] 要素を展開します。loanRequest ドキュメントの構造がグラフィカル表示されます。実行時に、プロキシ サービスは、メッセージの Rate 要素の値に基づいてルーティングを決定します。
    13. 図 3-33 loanRequest 要素


    loanRequest 要素

  13. Rate 要素に対応する円形アイコンを選択します。アイコンを右側の XQuery 式のテキスト ボックスにドラッグ アンド ドロップします。次の XQuery 式がテキスト ボックスに書き込まれます。
    14. $body/exam:processLoanApp/loanRequest/java:Rate
注意 : ドラッグ アンド ドロップ機能を使用できるのは Internet Explorer (IE) ブラウザのみです。IE 以外のブラウザを使用している場合は、[変数の構造] ペインで [Rate] 要素を選択します。式が [プロパティ インスペクタ] パレットに表示されます。XQuery 式のテキスト ボックスにカーソルを置いて、[プロパティのコピー] をクリックします。式がテキスト ボックスにコピーされます。パレットの式をコピーし、XQuery 式のテキスト ボックスに貼り付けることもできます。
図 3-34 XQuery 式エディタ

XQuery 式エディタ

  1. [検証] をクリックして、XQuery を検証します。式を送信する前に検証することをお勧めします。式の構文が検証されます。式にエラーがある場合は、[検証] ボタンのすぐ上に表示されます。
    2. 図 3-35 XQuery の検証


    XQuery の検証

  2. [保存] をクリックします。ルーティング テーブルが [ステージ コンフィグレーションの編集] ページに表示されます。<式> は、メッセージの Rate 要素の値を返す式に置き換えられています。
    3. 図 3-36 ルーティング テーブルの表示 - 式


    ルーティング テーブルの表示 - 式

  3. [演算子] ドロップダウン リストで [<] を選択します。関連付けられているテキスト フィールドに数字の「5」と入力します。

    4. これで、ルーティング テーブルにルーティング動作を決める式が含まれました。rate 要素の値が 5 未満の場合は、ルーティング テーブルのコンフィグレーションに従ってルーティングする必要があります。

    図 3-37 ルーティング テーブルの表示 - ルーティング条件


    ルーティング テーブルの表示 - ルーティング条件

  4. 金利が 5 未満の場合のメッセージのルーティング先サービスを定義するために、[サービス] リンクをクリックします。[サービスの選択] ページが表示されます。
    1. [ManagerLoanReview] ビジネス サービスを選択します。
    2. [送信] をクリックします。
  5. [ルーティング テーブル] の [操作] ドロップダウン リストで、[processLoanApp] 操作を選択します。これは、融資要求の金利の値が 5 未満の場合に、ManagerLoanReview ビジネス サービスで実行時に呼び出される操作です。

これで、ManagerLoanReview ビジネス サービスへの融資申し込みのルーティング ケースが定義されました。融資申し込みの要求金利が 5% 以上の場合、そのメッセージは NormalLoan ビジネス サービスにルーティングされます。次の節では、このケース (デフォルト ケース) の説明のために、ルーティング テーブルに条件を追加する方法を示します。

ルーティング テーブルへのデフォルト (else) 条件の追加
  1. [ケース] アイコン ルーティング テーブルの表示 - ルーティング条件 をクリックし、[デフォルト ケースの挿入] を選択します。else 条件 (デフォルト ケース) がルーティング テーブルに追加されます。
    2. 図 3-38 ルーティング テーブルのデフォルトの条件


    ルーティング テーブルのデフォルトの条件

  2. デフォルト (else) 条件の [サービス] リンクをクリックします。[サービスの選択] ページが表示されます。
    1. NormalLoan ビジネス サービスを選択します。
    2. [送信] をクリックします。
  3. デフォルト操作のドロップダウン リストで、サービスの操作として [processLoanApp] を選択します。

    4. この手順で、ルート ノード RouteNode1 のメッセージ フローのコンフィグレーションは完了です。

    これらの手順を完了すると、[ステージ コンフィグレーションの編集] ページが次の図のように表示されます。

    図 3-39 メッセージ フローのルーティング動作
  4. [検証] をクリックして、RouteNode1 ルーティング コンフィグレーションを検証します。
    5. 注意 : ルーティング動作の変更を検証してからコンフィグレーションを保存することをお勧めします。
  5. [ステージ コンフィグレーションの編集] ページで [保存] をクリックして、コンフィグレーションを保存し、[メッセージ フローの編集] ページに戻ります。
    6. 図 3-40 LoanGateway1 プロキシ サービスのメッセージ フローのマップ


    LoanGateway1 プロキシ サービスのメッセージ フローのマップ

  6. [メッセージ フローの編集] ページで [保存] をクリックし、[MortgageBroker/ProxyService] ページに戻ります。
  7. [Change Center] で [アクティブ化] をクリックし、[送信] をクリックしてセッションを保存し、セッションで行ったコンフィグレーションへの変更をすべてインスタンス化します。

まとめ

「手順 6 : LoanGateway1 プロキシ サービスのコンフィグレーション」によって、LoanGateway1 ルーティング テーブルの実行時メッセージ ルーティング動作のコンフィグレーションが完了します。融資申し込みで指定された金利が 5% 未満の場合、メッセージは ManagerLoanReview ビジネス サービスにルーティングされます。それ以外の場合は、NormalLoan ビジネス サービスにルーティングされます。

手順 7 : 融資申し込みのルーティング コンフィグレーションのテスト

AquaLogic Service Bus でクライアントと対象ビジネス サービスを使用するためのコンフィグレーションが完了したので、コンフィグレーションをテストできます。このシナリオのプロキシ サービスのルーティング動作は、融資申し込みメッセージの要求金利に基づいています。金利の値を変更すると、ルーティング動作は次のように変更されます。

この節では、これらの 2 つのケースのプロキシ サービスをテストする方法について説明します。テストはコマンドラインで行います。build.xml ファイルの金利フィールドの値を変更し、ant を実行します。テストの実行後にコマンド ウィンドウに返されるメッセージに、テストの成功または失敗と、要求を処理したビジネス サービスが示されます。

この節のテスト シナリオは以下のとおりです。

注意 : テストを正しく実行するため、WebLogic Server が AquaLogic Service Bus 2.6 (ServiceBusTutorial) ドメインで起動していることを確認します。
ManagerLoanReview ビジネス サービスのテスト
  1. コマンド ウィンドウを開きます。
  2. 次のように setEnv.cmd を実行して環境を設定します。
    1. 次のディレクトリに移動します。
      2. BEA_HOME\weblogic92\samples\servicebus\examples\src\
    2. このディレクトリで、コマンドラインから次のコマンドを実行します。 
      3. setEnv.cmd
      注意 : UNIX システムでコンフィグレーションをテストする場合は、コマンド プロンプトで setEnv.sh スクリプトを実行します。
  3. 次のディレクトリに移動します。
    4. BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic\normal
  4. プロキシ サービスのルーティング動作をテストするには、次のように、build.xml ファイルで実行対象を編集する必要があります。
    1. build.xml を開きます。
    2. 金利は入力パラメータとして指定されます。build.xml ファイルを最後までスクロールして、次の文字列を探します。
      3. <arg line="http://$...
    3. 見つかった文字列を次のように変更し、ファイルを保存します。
      4. <arg line="http://${wls.hostname}:${wls.port}/loan/gateway1 steve 555 2500 20 4.9 notes" />

      これで、チュートリアル ドメインで実行されているプロキシ サービスの URI が変更され、金利の値が 4.9 に指定されます。

      arg line で指定されるすべての入力パラメータの内容を次の表に示します。

      表 3-5 入力パラメータ
      パラメータ
      説明
      steve
      クライアント名を示す文字列
      555
      クライアント ID
      2500
      要求融資額
      20
      融資期間
      4.9
      要求金利
      notes
      その他の備考を示す文字列
      .

  5. ビジネス サービスが、次のようにデプロイされていることを確認します。
    1. コマンド ウィンドウで、次のディレクトリに移動します。
      2. cd BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic\normal
    2. 「ant」と入力し、〔Enter〕を押します。「BUILD SUCCESSFUL」メッセージが出力として表示されます。
  6. テストを実行するには、コマンド プロンプトで次のように入力します。
    7. ant run

    これで、プロキシ サービスのルーティング ロジックがテストされます。Web サービスからの応答メッセージがコマンド プロンプトに表示されます。 

    [java] Loan Application Response: APPROVED BY THE <i><b>MANAGER</b></i> LOAN APPLICATION REVIEW SERVICE
    [java] Rate: 4.9
    BUILD SUCCESSFUL

この応答メッセージは、要求金利が 4.9 (5 未満) であるため、ManagerLoanReview ビジネス サービスで要求が処理されたことを示します。

NormalLoan ビジネス サービスのテスト
  1. 「ManagerLoanReview ビジネス サービスのテスト」の手順に従います。以下のディレクトリにある build.xml ファイルを編集します。
    2. BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic\normal
    注意 : NormalLoan ビジネス サービスをテストするために、build.xml ファイルの金利の値を 5.1 に設定し、変更を保存します。
  2. ビジネス サービスをまだデプロイしていない場合は、次のようにデプロイします。
    1. コマンド ウィンドウで、次のディレクトリに移動します。
      2. BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic\normal
    2. 「ant」と入力し、〔Enter〕を押します。「BUILD SUCCESSFUL」メッセージが出力として表示されます。
  3. プロキシ サービスのルーティング ロジックをテストするため、コマンドラインで次のように入力します。
    4. ant run

    Web サービスからの応答メッセージがコマンド プロンプトに表示されます。 

    java] Loan Application Response: APPROVED BY THE <i><b>NORMAL</i></b> LOAN APPLICATION PROCESSING SERVICE
    java] Rate: 5.1
    BUILD SUCCESSFUL

この応答メッセージは、要求金利が 5.1 であるため、Normal Loan ビジネス サービスで要求が処理されたことを示します。


  ページの先頭       前  次