チュートリアル

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

この節では、チュートリアルに提示されているビジネスケースを実装するソリューションを作成できるように、環境の設定、リソースのコンフィグレーション、および BEA AquaLogic Service Bus の起動の方法について説明します。他のチュートリアルを開始する前に、この節の手順を実行する必要があります。

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

シナリオについて

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

チュートリアルの使い方

このチュートリアルでは、AquaLogic Service Bus の一般的な使い方を示します。AquaLogic Service Bus をコンフィグレーションして使用し、特定の場面で示されるビジネスシナリオを解決する方法を学習します。

最初のチュートリアルを完了すると、AquaLogic Service Bus をよく理解できます。それ以降のチュートリアルを完了することにより、最初のチュートリアルで学習した内容を強化できます。これらのチュートリアルでは、メッセージのルーティングや情報の追加など、AquaLogic Service Bus の基本機能を検証します。

以下のチュートリアルがあります。

「チュートリアル 1. 融資申し込みのルーティング」では、AquaLogic Service Bus を使用して企業でのメッセージのルーティングを容易にする方法を実証します。
「チュートリアル 2. 融資申し込みの変換」では、プロキシサービスにルーティングノード、トランスフォーメーション、および Web サービスコールアウト (サービスコールアウト) をコンフィグレーションして、AquaLogic Service Bus を通じたコンテンツベースのルーティングとメッセージへの情報の追加を可能にする方法を説明します。
「チュートリアル 3. 融資申し込みの検証」では、クライアントからビジネスサービスに渡すメッセージを検証するために、BEA AquaLogic Service Bus プロキシサービスをコンフィグレーションする方法について説明します。

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

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

BEA_HOME\weblogic91\samples\servicebus\examples

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

表 2-1 チュートリアルのサポート用に提供されているサンプルファイル

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

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

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

AquaLogic Service Bus をインストールします。インストール手順については、BEA Products の『インストールガイド』を参照してください。

チュートリアルを作成する新しい AquaLogic Service Bus ドメインを作成します。Configuration Wizard の指示に従うと、コンフィグレーションテンプレートを使用して新しいドメインを作成できます。

このチュートリアルでは、Configuration Wizard で以下の手順を実行します。

ドメインソースを選択するときに [AquaLogic Service Bus] チェックボックスをチェックします。
[開発モード] とデフォルトの PointBase データベースを選択します。
ServiceBusTutorial という名前のドメインを作成します。

Configuration Wizard の使用方法については、『コンフィグレーションウィザードを使用した WebLogic ドメインの作成』を参照してください。

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

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

BEA_HOME\weblogic91\samples\servicebus\examples

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

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

examples.properties ファイルの編集

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

BEA_HOME\weblogic91\samples\servicebus\examples\src\examples.properties

examples.properties ファイルを変更するには

ホスト名を、ServiceBusTutorial ドメインを実行中のマシンの名前に変更します。

ポート番号を、チュートリアルドメインのポート番号に変更します。

ドメインの作成時に指定したユーザ名を入力します。

ドメインの設定時に指定したパスワードを入力します。

サーバ名を、ドメインの作成時に指定した名前に変更します (Configuration Wizard で割り当てられたデフォルト名 (xbusServer) 以外の名前を指定した場合)。

コードリスト 2-1 examples.properties ファイルの抜粋

###  WebLogic configuration  ###

-- Configure per your WLS installation.

wls.hostname=localhost

wls.port=7001

wls.username=weblogic

wls.password=weblogic

wls.server.name=AdminServer

setEnv.cmd ファイルの編集と実行

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

BEA_HOME\weblogic91\samples\servicebus\examples\src

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

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

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

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

Windows の場合 :

コマンドウィンドウを開きます。

次のディレクトリに移動します。

BEA_HOME\weblogic91\samples\servicebus\examples\src\examples

examples ディレクトリから、コマンドラインで次のコマンドを実行します。

..\setEnv.cmd

UNIX の場合 :

% cd BEA_HOME/weblogic91/samples/servicebus/examples/src/examples

% ../setEnv

ここで、BEA_HOME は AquaLogic Service Bus をインストールしたディレクトリを表します。

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

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

Service Bus ドメインのインストールディレクトリ BEA_HOME\user_projects\domains\ServiceBusTutorial\bin\ にある setDomainEnv.cmd ファイルを編集します。

setDomainEnv.cmd ファイルで、PRE_CLASSPATH を設定する命令を検索します。この命令は次のようになっています。

set PRE_CLASSPATH=%PRE_CLASSPATH%;%WL_HOME%\servicebus\lib\sb-public.jar;%

未使用ドライブ文字を 3 つ (X、Y、Z など) 確認し、ファイルの先頭に次のコードを追加します。

subst X: %WL_HOME%\servicebus\lib
subst Y: %WL_HOME%\integration\common\lib
subst Z: %WL_HOME%\server\lib

PRE_CLASSPATH エントリを編集し、パスを適切なドライブ文字に置き換えます。次に例を示します。

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

変更内容を保存し、setDomainEnv.cmd を閉じます。

setDomainEnv.cmd を実行します。

cd コマンドで BEA_HOME\user_projects\domains\ServiceBusTutorial\bin\ に移動します。

setDomainEnv.cmd を実行します。

手順 3 : BEA AquaLogic Service Bus の起動

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

Windows の [スタート] メニューから、次のように選択する。

[スタート｜プログラム｜BEA Products｜User Projects｜domain_name｜Start Server for AquaLogic Service Bus Domain]
ここで、domain_name は、AquaLogic Service Bus ドメインを作成したときに指定した名前を表します。

Windows システムでは、AquaLogic Service Bus ドメインのルートから startWebLogic.cmd を呼び出す。
UNIX システムでは、AquaLogic Service Bus ドメインのルートから startWebLogic.sh を呼び出す。

サーバコマンドコンソールウィンドウが開き、Weblogic Server に関する状態情報が表示されます。

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

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

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

Web サービスをビルドしてデプロイする
Web サービスをテストするために Java クライアントを作成する
ant run を使用して Java クライアントを実行する

ビジネスサービスをビルドしてデプロイするには

コマンドウィンドウで、「setEnv スクリプトを実行するには」の説明に従って setEnv スクリプトを実行したことを確認します。

webservices\jws_basic ディレクトリに移動します。

cd BEA_HOME\weblogic91\samples\servicebus\examples\src\examples\webservices\jws_basic

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

normal ディレクトリに移動します (cd normal)。

他のビジネスサービス (credit、large、および manager) をビルドするときは、対応するビジネスサービスフォルダに移動します。

Web サービスをデプロイするには、ant と入力し、〔Enter〕を押します。

コマンドが正常に実行されたかどうかを示すメッセージがコンソールに表示されます。

デプロイされた Web サービスをテストするには、ant run と入力し、〔Enter〕を押します。

ビジネスサービスからのメッセージがコマンドラインに出力されます。メッセージは、Web サービスが正常に実行されたかどうかを示します。

このチュートリアルで使用する残りの 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:7001/sbconsole

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

チュートリアルの開始

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

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