チュートリアル

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

BEA AquaLogic Service Bus チュートリアルの準備

この章では、以下の内容について説明します。

チュートリアルを開始する前に、この節の手順を実行します。

AquaLogic Service Bus チュートリアルでは、AquaLogic Service Bus リソースの設計とコンフィグレーション、およびコンフィグレーションのデプロイの手順を説明します。これらのチュートリアルの手順では、AquaLogic Service Bus のサンプル セットを使用します (BEA AquaLogic Service Bus サンプル ガイドを参照してください)。

 


シナリオについて

チュートリアルでは、一般的な融資仲介業者の融資申し込み要求のシナリオを説明します。主要な金融会社が、AquaLogic Service Bus を使用して、融資申し込みを適切なビジネス サービスにルーティングします。融資申し込みは、要求された金利や要求された元本などの条件に基づいて、各種のビジネス サービスにルーティングされます。元本が 2500 万ドルを超える場合、融資要求を完了するには申込者の信用格付け情報が必要になります。

最初のチュートリアルを完了すると、AquaLogic Service Bus に慣れることができます。最初のチュートリアルの学習内容を土台にして、それ以降のチュートリアルを進めていきます。これらのチュートリアルでは、メッセージのルーティングや情報の追加など、AquaLogic Service Bus の基本機能を検証します。

 


チュートリアルのセットアップ

チュートリアル ソリューションのビルドをサポートするファイル (ビルド済みのビジネス サービスを含む) は、次のディレクトリにあります。

BEA_HOME\weblogic92\samples\servicebus\examples

チュートリアル ファイルには、チュートリアルを実行するために設定する必要のあるプロパティが含まれます。チュートリアルでは、4 つのビジネス サービスを使用できます。各ビジネス サービスにも、関連するファイルのセットがあります。各ビジネス サービスのファイル構造は同じです。表 2-1 に、ビジネス サービスの 1 つである normal サービスのディレクトリ構造を示します。他のディレクトリの内容も確認してみてください。

表 2-1 チュートリアルのサポート用に提供されているサンプル ファイル
ファイル名/場所
説明
/src/setEnv.cmd
環境プロパティを設定するファイル。
/src/examples.properties
ビジネス サービスのビルドのプロパティとデプロイメント プロパティが含まれるファイル。
ビジネス サービスごと :
BEA_HOME/weblogic92/samples/servicebus/examples/src/examples/webservices/jws_basic/normal
normal ビジネス サービスで必要なファイルが含まれるフォルダ。このチュートリアルで使用される他の 3 つのビジネス サービス (managerlargecredit) も同じファイル構造である。
SimpleBean.java
jws-181 Web サービス定義。
LoanStruct.java
メッセージの定義。
build.xml
ant を使用した各サービスのビルドに使用されるビルド スクリプト。
*.wsdl
各サービスを定義する Web Service Definition Language (WSDL) ファイル。
/client/Main.java
各ビジネス サービスが対話する Java クライアント。

チュートリアルを設定および実行するには、次の手順を実行する必要があります。

手順 1 : AquaLogic Service Bus のインストール

  1. AquaLogic Service Bus をインストールします。手順については、AquaLogic Service Bus インストール ガイドを参照してください
  2. チュートリアルを作成する新しい AquaLogic Service Bus ドメインを作成します。Configuration Wizard の指示に従うと、コンフィグレーション テンプレートを使用して新しいドメインを作成できます。
  3. このチュートリアルでは、Configuration Wizard で以下の手順を実行します。

手順 2 : コンフィグレーション設定の変更

AquaLogic Service Bus チュートリアルを作成して実行するには、コンフィグレーション プロパティの一部を変更する必要があります。関連ファイルは次のディレクトリにあります。

BEA_HOME\weblogic92\samples\servicebus\examples

\build および \src という 2 つのサブディレクトリがあります。\src ディレクトリのファイルにコンフィグレーションの変更を加えます。

表 2-2 コンフィグレーション設定
フォルダ名
説明
\build
このフォルダには、AquaLogic Service Bus サンプル ドメインに用意されているコンフィグレーション済みの AquaLogic Service Bus サンプルの実行に必要なファイルが含まれる。
\src
このフォルダには、AquaLogic Service Bus チュートリアルの作成と実行をサポートするファイルが含まれる。チュートリアルの作成時に、このフォルダに含まれる一部のファイル (examples.properties など) を変更する。

examples.properties ファイルの編集

実行中のチュートリアル ドメインにビジネス サービスをデプロイするには、WebLogic Server の動作を指定するプロパティを変更する必要があります。プロパティは、次のファイルの WebLogic configuration セクションで変更できます

BEA_HOME\weblogic92\samples\servicebus\examples\src\examples.properties  
examples.properties ファイルを変更するには
  1. ホスト名を、ServiceBusTutorial ドメインを実行中のマシンの名前に変更します。
  2. ポート番号を、チュートリアル ドメインのポート番号に変更します。
  3. ドメインの作成時に指定したユーザ名を入力します。
  4. ドメインの作成時に指定したパスワードを入力します。
  5. サーバ名を、ドメインの作成時に指定した名前に変更します (Configuration Wizard で割り当てられたデフォルト名 (xbusServer) 以外の名前を指定した場合)。
  6. コード リスト 2-1 examples.properties ファイルの抜粋
    ###  WebLogic configuration  ###
    -- Configure per your WLS installation.
    wls.hostname=localhost
    wls.port=7021
    wls.username=weblogic
    wls.password=weblogic
    wls.server.name=xbusServer

setEnv スクリプトの編集と実行

次のディレクトリにある setEnv スクリプト (Windows の場合は setEnv.cmd、UNIX システムの場合は setEnv.sh) を編集して、デフォルト パスをチュートリアル ドメインの setDomainEnv スクリプトへのパスに置き換えます。

BEA_HOME\weblogic92\samples\servicebus\examples\src

新しいパスは次のとおりです。

BEA_HOME\user_projects\domains\ServiceBusTutorial\bin\setDomainEnv.cmd.

BEA_HOME\user_projects は、ServiceBusTutorial ドメインを作成したデフォルト ディレクトリです (オペレーティング システムに応じて setDomainEnv.cmd または setDomainEnv.sh を使用します)。

setEnv スクリプトを実行するには

Windows の場合 :

  1. コマンド ウィンドウを開きます。
  2. 次のディレクトリに移動します。
  3. BEA_HOME\weblogic92\samples\servicebus\examples\src\examples
  4. examples ディレクトリから、コマンド ラインで次のコマンドを実行します。
  5. ..\setEnv.cmd

UNIX の場合 :

% cd BEA_HOME/weblogic92/samples/servicebus/examples/src/examples
% ../setEnv
ここで、

setDomainEnv.cmd ファイルの編集 - Windows 2000 ユーザのみ

この手順は、Windows 2000 ユーザ専用です。Windows 2000 マシンでは、クラス パスの長さの問題により、ant タスクとチュートリアルを実行できません。これを回避するには、subst コマンドを使用して ant から渡されるクラスパスを短くします。クラスパスを短くするには、次の手順に従います。

  1. Service Bus ドメインのインストール ディレクトリ BEA_HOME\user_projects\domains\ServiceBusTutorial\bin\ にある setDomainEnv.cmd ファイルを編集します。
  2. setDomainEnv.cmd ファイルで、PRE_CLASSPATH を設定する命令を検索します。この命令は次のようになっています。
  3. set PRE_CLASSPATH=%PRE_CLASSPATH%;%WL_HOME%\servicebus\lib\sb-public.jar;%
  4. 未使用ドライブ文字を 3 つ (X、Y、Z など) 確認し、ファイルの先頭に次のコードを追加します。
  5. subst X: %WL_HOME%\servicebus\lib
    subst Y: %WL_HOME%\integration\common\lib
    subst Z: %WL_HOME%\server\lib
  6. PRE_CLASSPATH エントリを編集し、パスを適切なドライブ文字に置き換えます。次に例を示します。
  7. set PRE_CLASSPATH=%PRE_CLASSPATH%;X:\sb-public.jar;X:\sb-internal.jar;Y:\wlicommon.jar;Y:\qs_p13n_system.jar;X:\xbus-core.jar;Z:\wlxbean.jar;Z:\xquery.jar;Z:\apache_xbean.jar;Z:\binxml.jar
  8. 変更内容を保存し、setDomainEnv.cmd ファイルを閉じます。
  9. 次のコマンドを入力して setDomainEnv.cmd スクリプトを実行します
    1. cd BEA_HOME\user_projects\domains\ServiceBusTutorial\bin\
    2. run setDomainEnv.cmd

手順 3 : BEA AquaLogic Service Bus の起動

以下のいずれかの方法に従って、AquaLogic Service Bus を起動します。

注意 : プロダクション モードのドメインを作成した場合、サーバを起動するには有効なユーザ名とパスワードを入力します。ドメインの詳細については、『コンフィグレーション ウィザードを使用した WebLogic ドメインの作成』を参照してください

手順 4 : ビジネス サービスのビルドとデプロイ

Web サービスをビルドする前に、サーバを起動する必要があります。「手順 3 : BEA AquaLogic Service Bus の起動」を参照してください。サーバの起動後に、ビルド スクリプトを実行して次の処理を行う必要があります。

ビジネス サービスをビルドしてデプロイするには
  1. コマンド ウィンドウで、「setEnv スクリプトを実行するには」の説明に従って setEnv スクリプトを実行したことを確認します。
  2. webservices\jws_basic ディレクトリに移動します。
  3. cd BEA_HOME\weblogic92\samples\servicebus\examples\src\examples\webservices\jws_basic

    このディレクトリには 4 つのビジネス サービス フォルダがあります。手順 3 から手順 5 に従って各ビジネス サービスをビルドして実行します。

  4. normal ディレクトリに移動します。
    cd normal
  5. 注意 : 他のビジネス サービス (credit、large、および manager) をビルドするときは、対応するビジネス サービス フォルダに移動します。
  6. Web サービスをデプロイするには、「ant」と入力し、〔Enter〕を押します。
  7. コマンドが正常に実行されたかどうかを示すメッセージがコンソールに表示されます。

  8. デプロイされた Web サービスをテストするには、「ant run」と入力し、〔Enter〕を押します。
  9. ビジネス サービスからのメッセージがコマンド ラインに表示されます。メッセージには、Web サービスが正常に実行されたかどうかが示されます。

  10. このチュートリアルで使用する残りの Web サービス (credit、large、および manager) をビルドするには、ビルドとデプロイの手順 3 から手順 5\jws_basic ディレクトリ内の各フォルダについて繰り返します。

手順 5 : AquaLogic Service Bus Console へのログイン

AquaLogic Service Bus Console にログインするには、ブラウザ ウィンドウを開き、ブラウザに次の URL を入力します。

http://host:port/sbconsole

ここで、host:port は WebLogic Server が実行されているマシンの名前とポート番号を表します。たとえば、WebLogic Server がローカル マシンで、デフォルトのポート コンフィグレーションを使用して実行されている場合は、ブラウザで以下の URL を入力してください。

http://localhost:7021/sbconsole

AquaLogic Service Bus Console ログイン ページが表示されます。AquaLogic Service Bus ドメインの作成時に指定したユーザ名とパスワードを入力します。

チュートリアルの開始

チュートリアルの設定に必要な手順を完了すると、「チュートリアル 1. 融資申し込みのルーティング」に進むことができます。このチュートリアルでは、ルーティング シナリオに必要なリソースを BEA AquaLogic Service Bus にコンフィグレーションする方法について説明します。

各チュートリアルには、AquaLogic Service Bus リソースの設計とコンフィグレーションの手順に続いて、完了したコンフィグレーションのテストに使用できるテスト セクションがあります。


  ページの先頭       前  次