HOME / Docs & Support / NetBeans 5.5

ローン処理複合アプリケーションの作成

最終更新日: 2006 年 11 月 14 日

寄稿者: Sherry Barkodar、保守担当: Alyona Stashkova

このチュートリアルでは、単純なローン要求複合アプリケーションの概要を説明し、NetBeans Enterprise Pack 5.5 バンドルと必要なすべての実行環境を使用して、複合アプリケーションを配備、実行、およびテストする例を示します。

このローン要求複合アプリケーションは、次のビジネス用途の事例に利用できます。

ユーザーは、個人識別情報、要望するローンの金額、クレジット履歴などの情報をローン要求に入力し、ローンを申請します。
ローン要求が受信されると、ユーザーから提供された個人情報は既存のデータベース全体にわたって検証され、その情報と要求された金額に基づいて、承認が与えられるか拒否されます。
一定の手続きが済んだあと、承認書面の形でレポートが生成され、ユーザーへ送信されてローンの承認を確認します。
ローンが何らかの理由で拒否された場合は、拒否の理由を示すレポートが生成され、表示されます。

Loanprocessing 図
(表示を拡大)

前提条件

このチュートリアルは、Java の言語とプラットフォーム、および NetBeans IDE についての基本的な知識またはプログラミング経験を持つユーザーを想定しています。

システム要件

このチュートリアルでは、ユーザーのシステムが、『NetBeans Enterprise Pack 5.5 リリースノート』の「システム要件」の項で指定された要件を満たしていることを想定しています。

このチュートリアルに必要なソフトウェア

開始する前に、コンピュータに次のソフトウェアをインストールしておく必要があります。

NetBeans IDE 5.5 と NetBeans Enterprise Pack 5.5 (ダウンロード)
このチュートリアルの配備の手順を実行するには、Sun Java System Application Server Platform Edition 9 Update 1 が必要です。この Application Server は、NetBeans Enterprise Pack 5.5 のダウンロードに付属しています。

チュートリアル環境の構成
BPEL プロジェクトの作成
XML スキーマの作成
WSDL ドキュメントの作成
パートナーサービス
BPEL プロセスの作成
複合アプリケーションの作成と配備
複合アプリケーションのテスト
BPEL Web サービスクライアントの作成
付録

ページの先頭へ

チュートリアル環境の構成

アプリケーションを配備できるよう、前もって Sun Java System Application Server および JBI 実行環境を正しく構成し、稼動させておく必要があります。

チュートリアル環境を構成するには、次の手順に従います。

「実行時」タブをクリックして「実行時」ウィンドウを開きます。
「実行時」ウィンドウで「サーバー」ノードを展開します。
「サーバー」ノードにすでに「Sun Java System Application Server 9」ノードが含まれている場合は、手順 5 へ進みます。
「サーバー」ノードに「Sun Java System Application Server 9」ノードが含まれていない場合は、次のようにしてアプリケーションサーバーを追加します。
1. 「サーバー」ノードを右クリックし、ポップアップメニューから「サーバーを追加」を選択します。
  「サーバーインスタンスを追加」ダイアログが開きます。
2. 「サーバーを選択」ページで、「サーバー」ドロップダウンリストから「Sun Java System Application Server」を選択します。
3. (省略可能)「名前」フィールドで、IDE 内でこのサーバーを識別するために使用する任意の名前を入力するか、デフォルト値のままにします。
4. 「次へ」をクリックします。
  「プラットフォームフォルダの場所」ページが開きます。
5. 「プラットフォームの場所」フィールドの「参照」ボタンを使用して、Application Server のインストール場所に移動して選択します。
  インストール時にデフォルト値のままにした場合、インストール場所は C:\Sun\Appserver です。
6. 「ローカルのデフォルトドメインを登録」オプションを選択します。
7. 「次へ」をクリックします。
8. ドメインの管理者のユーザー名とパスワードを入力します。
  インストール時にデフォルト値のままにした場合、ユーザー名は admin で、パスワードは adminadmin です。
9. 「完了」をクリックします。
「実行時」ウィンドウで、「Sun Java System Application Server 9」ノードを右クリックし、「起動」を選択します。
開始オプションが使用可能でない場合、サーバーはすでに稼動しており、次の手順は省略できます。
「出力」ウィンドウに次のメッセージが表示されるまで待ちます。
アプリケーションサーバーの起動は完了しました。
サーバーが稼動している場合は、「Sun Java System Application Server 9」ノード上に緑色の矢印が表示されます。

アプリケーションサーバー稼動中
(表示を拡大)

ページの先頭へ

BPEL プロジェクトの作成

この節では、LoanRequestor という BPEL モジュールプロジェクトを作成します。

LoanRequestor プロジェクトを作成するには、次の手順に従います。

IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。
「新規プロジェクト」ウィザードが開きます。
「カテゴリ」リストで、「サービス指向アーキテクチャー」ノードを選択します。
「プロジェクト」リストで、「BPEL モジュール」ノードを選択します。
「次へ」をクリックします。
「プロジェクト名」フィールドに「LoanRequestor」と入力します。
(省略可能)「プロジェクトの場所」フィールドの「参照」ボタンを使用して、IDE がプロジェクトファイルを格納する別のフォルダに移動して選択します。
「完了」をクリックします。
この時点で、「プロジェクト」ウィンドウに、LoanRequestor という BPEL モジュールプロジェクト用のプロジェクトノードが含まれます。

LoanRequestor プロジェクト

ページの先頭へ

XML スキーマの作成

この節では、BPEL モジュールプロジェクトに新しい XML スキーマファイルを追加したあと、スキーマに XML スキーマコンポーネントを追加します。

LoanRequestor.xsd を作成するには、次の手順に従います。

「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを展開して「プロセスファイル」ノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。
「新規ファイル」ウィザードが開きます。
「新規ファイル」ウィザードで、次の手順を実行します。
1. 「ファイルの種類を選択」ページの「カテゴリ」リストで「XML」ノードを選択してから、「ファイルの種類」リストで「XML スキーマ」ノードを選択し、「次へ」をクリックします。
2. 「ファイル名」フィールドに「LoanRequestor」と入力します。
3. 「完了」をクリックします。
この時点で、「プロジェクト」ウィンドウの「プロセスファイル」ノードに、「LoanRequestor.xsd」というサブノードが含まれます。ソースエディタには、XML スキーマファイル LoanRequestor.xsd のタブが含まれており、スキーマビューが開かれています。
スキーマビューで「デザイン」ボタンをクリックし、XML スキーマエディタのデザインビューを開きます。

XML スキーマエディタのデザインビュー

XML スキーマに複合型を追加するには、次の手順に従います。

デザインビューの「パレット」で、「XML スキーマコンポーネント」セクションを展開し、「複合型」アイコンを選択します。
「パレット」ウィンドウが表示されない場合は、メインメニューから「ウィンドウ」>「パレット」を選択します。
選択したアイコンを、「複合型」ノードの直下のスキーマデザイン領域までドラッグします。
「複合型」ノードが追加され、その複合型の名前 (newComplexType) が選択され、変更できるようになっています。
新しいノードに「processApplication」と入力し、Enter キーを押します。
この時点で、デザイン領域に processApplication という新しい複合型が表示されます。
手順 1 〜 3 を繰り返し、別の新しい複合型に processApplicationResponse という名前を付けます。

XML スキーマに追加された複合型

processApplication および processApplicationResponse にローカル要素を追加するには、次の手順に従います。

「パレット」の「XML コンポーネント」セクションで、「要素」アイコンを選択し、選択したアイコンをスキーマデザイン領域の「processApplication」ノード上へドラッグします。
「newElement」という要素ノードが追加されます。
「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
スキーマデザイン領域で、「newElement」ノードを選択します。
「プロパティー」ウィンドウで、「名前」プロパティーの値フィールドを選択して編集可能にし、「socialSecurityNumber」と入力します。
「プロパティー」ウィンドウで、「nil 化可能」プロパティーの値フィールドを True に設定します。
「プロパティー」ウィンドウで、「定義」プロパティーの省略符号ボタン (...) をクリックします。
「定義」ダイアログが開きます。
リスト内で「組み込み型」ノードを展開し、「string」ノードを選択します。
「了解」をクリックします。

手順 1 〜 8 を繰り返し、次の要素を追加します。

名前	nil 化可能	定義
`applicantName`	`True`	`string`
`applicantAddress`	`True`	`string`
`applicantEmailAddress`	`True`	`string`
`applicantAge`	`True`	`int`
`applicantGender`	`True`	`string`
`annualSalary`	`True`	`double`
`amountRequested`	`True`	`double`

「パレット」の「XML コンポーネント」セクションで、「要素」アイコンを選択し、選択したアイコンをスキーマデザイン領域の「processApplicationResponse」ノード上へドラッグします。
「newElement」という要素ノードが追加されます。
スキーマデザイン領域で、「newElement」ノードを選択します。
「プロパティー」ウィンドウで、「名前」プロパティーの値フィールドを選択して編集可能にし、「return」と入力します。
「プロパティー」ウィンドウで、「定義」プロパティーの省略符号ボタン (...) をクリックします。
「定義」ダイアログが開きます。
リスト内で「組み込み型」ノードを展開し、「string」ノードを選択します。
「了解」をクリックします。

複合型に追加されたローカル要素

大域要素を追加するには、次の手順に従います。

「パレット」の「XML コンポーネント」セクションで、「要素」アイコンを選択し、選択したアイコンを「要素」ノードの直下のデザイン領域までドラッグします。
newElement コンポーネントがスキーマデザイン領域の「要素」ノードの下に追加されます。
デザインビューのスキーマデザイン領域で、「newElement」ノードを選択します。
「プロパティー」ウィンドウで、「名前」プロパティーの値フィールドを選択して編集可能にし、「processApplication」と入力します。
「プロパティー」ウィンドウで、「定義」プロパティーの省略符号ボタン (...) をクリックします。
「要素の定義 - 定義」ダイアログが開きます。
型の一覧で、「複合型」ノードを展開し、「processApplication」複合型ノードを選択します。
「了解」をクリックします。
手順 1 〜 6 を繰り返し、次の要素を追加します。

名前複合型

processApplicationResponse processApplicationResponse
変更を保存するには、「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを選択し、IDE のメインメニューから「ファイル」>「すべてを保存」を選択します。

XML スキーマに追加された大域要素

ページの先頭へ

WSDL ドキュメントの作成

この節では、BPEL モジュールプロジェクトに WSDL ファイルを追加したあと、WSL ドキュメントのコンポーネントを構成します。

LoanRequestor.xsd を作成するには、次の手順に従います。

「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを展開して「プロセスファイル」ノードを右クリックし、「新規」>「WSDL ドキュメント」を選択します。
「新規 WSDL ドキュメント」ウィザードが開きます。
「名前と場所」ページで、次の操作を実行します。
1. 「ファイル名」フィールドに「LoanRequestor」と入力します。
2. 「XML スキーマファイルをインポート」チェックボックスを選択します。
3. 「XML スキーマ」フィールドで、「参照」ボタンをクリックします。
  「スキーマを選択」ダイアログが開きます。このダイアログには、プロジェクト内の XML スキーマが表示されます。
4. 「src/LoanRequestor.xsd」を選択し、「了解」をクリックします。
5. 「次へ」をクリックします。
「抽象構成」ページが開きます。
「抽象構成」ページの「入力」領域で、次の操作を実行します。
1. 「メッセージ部分名」列で、デフォルト値をダブルクリックし、フィールドを編集可能にします。
2. 「requestLoanMessage」と入力し、Enter キーを押します。
3. 「要素または型」列で、省略符号ボタン (...) をクリックします。
  「要素または型を選択」ダイアログが開きます。
4. 「LoanRequestor」ノード、「src/LoanRequestor.xsd」ノード、「要素」ノードを順に展開します。
5. 「要素」ノードの下で、「processApplication」ノードを選択して「了解」をクリックします。
「抽象構成」ページの「出力」領域で、次の操作を実行します。
1. 「メッセージ部分名」列で、デフォルト値をダブルクリックし、フィールドを編集可能にします。
2. 「responsePart」と入力し、Enter キーを押します。
3. 「要素または型」列で、省略符号ボタン (...) をクリックします。
  「要素または型を選択」ダイアログが開きます。
4. 「LoanRequestor」ノード、「src/LoanRequestor.xsd」ノード、「要素」ノードを順に展開します。
5. 「要素」ノードの下で、「processApplicationResponse」を選択して「了解」をクリックします。
「次へ」をクリックします。
「具象構成」ページが開きます。
注:次の手順を実行すると、ページ下部のエラーメッセージの表示が消えます。
「結合サブタイプ」で、「DOCUMENT リテラル」オプションを選択します。
「完了」をクリックします。この時点で、「プロジェクト」ウィンドウの「プロセスファイル」ノードに、「LoanRequestor.wsdl」というサブノードが含まれます。ソースエディタには、WSDL ファイル LoanRequestor.wsdl のタブが含まれており、新しい「WSDL」ビューが開かれています。

(表示を拡大) ページの先頭へパートナーサービスこの「ローン申請」は、公開インタフェースを介してパートナーサービスと通信します。それらのインタフェースは、パートナー固有の WSDL ファイル内で定義されます。このチュートリアルには、zip 形式で圧縮した LoanProcessor という J2EE プロジェクトと、EJB を新規に作成するための説明が「付録」に含まれています。LoanRequestor プロジェクトには、パートナーサービスの非常に基本的な EJB 実装が含まれています。 LoanRequestorCompositeApp をテスト実行するためには、前もってパートナー Web サービスを、バンドルされている Sun Java Application Server に配備する必要があります。この実装は、ローンサービスプロセス用のテストハーネスとして機能することのみを意図しています。 LoanProcessor プロジェクトを開くには、次の手順に従います。ファイルシステム内に LoanTut という名前のディレクトリを作成します。 loanejb.zip ファイルをダウンロードし、LoanTut ディレクトリの中へ抽出します。 IDE のメインメニューから、「ファイル」>「プロジェクトを開く」を選択します。「プロジェクトを開く」ウィザードが開きます。作成したばかりの「LoanTut」ディレクトリに移動し、「LoanProcessor」プロジェクトを選択して「プロジェクトフォルダを開く」をクリックします。進捗状況を示すダイアログが表示されたあと、「プロジェクト」ウィンドウにプロジェクトが表示されます。 LoanProcessor プロジェクトを配備するには、次の手順に従います。「LoanProcessor」を右クリックし、「プロジェクトを配備」を選択します。「出力」ウィンドウに「構築成功」というメッセージが表示されるまで待ちます。 LoanProcessor エンタープライズアプリケーションが正常に配備されたことを確認するために、「実行時」ウィンドウに切り替えます。「Sun Java System Application Server」ノード、「アプリケーション」ノード、「EJB モジュール」ノードを順に展開します。「LoanProcessor」ノードが追加されています。ページの先頭へ BPEL プロセスの作成 LoanRequestor.bpel を作成するには、次の手順に従います。「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを展開して「プロセスファイル」ノードを右クリックし、「新規」>「BPEL プロセス」を選択します。「新規 BPEL プロセス」ウィザードが開きます。「ファイル名」フィールドに「LoanRequestor」と入力します。「完了」をクリックします。この時点で、「プロジェクト」ウィンドウの「プロセスファイル」ノードに、「LoanRequestor.bpel」というサブノードが含まれます。ソースエディタには、BPEL プロセス LoanRequestor.bpel のタブが含まれており、BPEL Designer のデザインビューが開かれています。パートナーリンクを追加するには、次の手順に従います。「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを展開して、「プロセスファイル」ノードを展開し、「LoanRequestor.wsdl」ノードを選択します。選択した項目 (LoanRequestor.wsdl) を、「プロジェクト」ウィンドウからデザインビューまでドラッグします。「Partnerlink1 [パートナーリンク] - プロパティーエディタ」が開きます。「名前」フィールドに「BpelImplementation」と入力します。デフォルト値のままにして、「了解」をクリックします。「プロジェクト」ウィンドウで、「LoanProcessor」プロジェクトノードを展開してから「Web サービス」ノードを展開し、「LoanProcessor」Web サービスノードを選択します。「プロジェクト」ウィンドウからデザインビューに、選択した項目 (「LoanProcessor」Web サービスノード) をドラッグします。「Partnerlink1 [パートナーリンク] - プロパティーエディタ」が開きます。「名前」フィールドに「EjbImplementation」と入力します。デフォルト値のままにして、「了解」をクリックします。「プロジェクト」ウィンドウで、「プロセスファイル」の下に「Partners」フォルダが作成されます。「Partners」ノードを展開します。このフォルダには、LoanProcessor.wsdl ファイルと LoanProcessorService_schema1.xsd ファイルを含む「LoanProcessor」ノードがあります。受信アクティビティーを追加するには、次の手順に従います。「パレット」の「Web サービス」セクションで受信アイコンを選択し、選択したアイコンをプロセス開始 (Process Start) アクティビティーと空アクティビティーの間のデザイン領域までドラッグします。選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。このアクションにより、デザインビューに Receive1 という受信アクティビティーが配置されます。 Receive1 アクティビティーをダブルクリックします。「Receive1 [受信] - プロパティーエディタ」が開きます。「名前」フィールドの値を ReceiveFromCustomer に変更します。「パートナーリンク」ドロップダウンリストから、「BpelImplementation」を選択します。「操作」フィールドは IDE によって記入されます。次の手順に従って、新しい入力変数を作成します。「入力変数」フィールドの隣の「作成」ボタンをクリックします。「新規入力変数」ダイアログが開きます。「名前」フィールドの値を requestLoanInput に変更します。「了解」をクリックします。「了解」をクリックして「Receive1 [受信] - プロパティーエディタ」を閉じます。この時点で、デザインビュー内の受信アクティビティーに ReceiveFromCustomer というラベルが付きます。呼び出しアクティビティーを追加するには、次の手順に従います。「パレット」の「Web サービス」セクションで Invoke アイコンを選択し、選択したアイコンを受信アクティビティーの後ろの「デザイン」領域までドラッグします。選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。このアクションにより、デザインビューに Invoke1 という呼び出しアクティビティーが配置されます。 Invoke1 アクティビティーをダブルクリックします。「Invoke1 [呼び出し] - プロパティーエディタ」が開きます。「名前」フィールドの値を InvokeLoanProcessorEJB に変更します。「パートナーリンク」ドロップダウンリストから、「EjbImplementation」を選択します。「操作」フィールドは IDE によって記入されます。次の手順に従って、新しい入力変数を作成します。「入力変数」フィールドの隣の「作成」ボタンをクリックします。「新規入力変数」ダイアログが開きます。「名前」フィールドの値を processApplicationInput に変更します。「了解」をクリックします。次の手順に従って、新しい出力変数を作成します。「出力変数」フィールドの隣の「作成」ボタンをクリックします。「新規出力変数」ダイアログが開きます。「名前」フィールドの値を processApplicationOutput に変更します。「了解」をクリックします。「了解」をクリックして「Invoke1 [呼び出し] - プロパティーエディタ」を閉じます。この時点で、デザインビュー内の呼び出しアクティビティーに InvokeLoanProcessorEJB というラベルが付きます。返信アクティビティーを追加するには、次の手順に従います。「パレット」の「Web サービス」セクションで返信アイコンを選択し、選択したアイコンを呼び出しアクティビティーの後ろの「デザイン」領域までドラッグします。選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。このアクションにより、デザインビューに Reply1 という返信アクティビティーが配置されます。 Reply1 アクティビティーをダブルクリックします。「Reply1 [返信] - プロパティーエディタ」が開きます。「名前」フィールドの値を ReplyToCustomer に変更します。 BpelImplementation へのパートナーリンクを設定します。次の手順に従って、新しい出力変数を作成します。「正常応答」オプションが選択されているかを確認してください。「出力変数」フィールドの隣の「作成」ボタンをクリックします。「新規出力変数」ダイアログが開きます。「名前」フィールドの値を requestLoanOutput に変更します。「了解」をクリックします。「了解」をクリックして「Reply1 [返信] - プロパティーエディタ」を閉じます。この時点で、デザインビュー内の返信アクティビティーに ReplyToCustomer というラベルが付きます。最初の代入アクティビティーを追加するには、次の手順に従います。デザイン領域で、空アクティビティーを選択し、右クリックしてポップアップメニューから「削除」を選択します。「パレット」の「基本アクティビティー」セクションで代入アイコンを選択し、選択したアイコンを受信アクティビティーと呼び出しアクティビティーの間のデザイン領域までドラッグします。選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。このアクションにより、デザインビューに Assign1 という代入アクティビティーが配置されます。 Assign1 アクティビティーを選択します。「Assign1 [代入] - プロパティー」ウィンドウで、「名前」プロパティーの値フィールドを選択して編集可能にし、「AssignReceiveToEJBInput」と入力して「了解」をクリックします。「BPEL マッパー」ウィンドウが表示されない場合は、メインメニューから「ウィンドウ」>「BPEL マッパー」を選択します。 BPEL マッパーの左区画で、「変数」の下の「requestLoanInput」ノードおよび「requestLoanMessage」ノードを展開します。 requestLoanMessage の下に、socialSecurityNumber、applicantName、applicantAddress、applicantEmailAddress、applicantAge、applicantGender、annualSalary、amountRequested が表示されます。 BPEL マッパーの右区画で、「変数」の下の「processApplicationInput」ノードおよび「parameters」ノードを展開します。パラメータの下に、socialSecurityNumber、applicantName、applicantAddress、applicantEmailAddress、applicantAge、applicantGender、annualSalary、amountRequested が表示されます。 BPEL マッパーの左区画からBPEL マッパーの右区画の「socialSecurityNumber」ノードまで、socialSecurityNumber をドラッグします。次の各変数について、手順 7 を繰り返します。 applicantName、applicantAddress、applicantEmailAddress、applicantAge、applicantGender、annualSalary、および amountRequested。変更を保存するには、「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを選択し、IDE のメインメニューから「ファイル」>「すべてを保存」を選択します。 2 番目の代入アクティビティーを追加するには、次の手順に従います。「パレット」の「基本アクティビティー」セクションで代入アイコンを選択し、選択したアイコンを呼び出しアクティビティーと返信アクティビティーの間のデザイン領域までドラッグします。このアクションにより、デザインビューに Assign1 という呼び出しアクティビティーが配置されます。 Assign1 アクティビティーを選択します。「Assign1 [代入] - プロパティー」ウィンドウで、「名前」プロパティーの値フィールドを選択して編集可能にし、「AssignEJBOutputToReply」と入力して「了解」をクリックします。「BPEL マッパー」ウィンドウが表示されない場合は、メインメニューから「ウィンドウ」>「BPEL マッパー」を選択します。 BPEL マッパーの左区画で、「変数」の下の「processApplicationOutput」ノードと「parameters」ノードを展開します。「return」が「parameters」の下に表示されます。 BPEL マッパーの右区画で、「変数」の下の「requestLoanOutput」ノードと「responsePart」ノードを展開します。「return」が「responsePart」の下に表示されます。 BPEL マッパーの左区画から BPEL マッパーの右区画の「return」ノードまで、return をドラッグします。変更を保存するには、「プロジェクト」ウィンドウで「LoanRequestor」プロジェクトノードを選択し、IDE のメインメニューから「ファイル」>「すべてを保存」を選択します。 (表示を拡大) LoanRequestor BPEL プロジェクトを構築するには、次の手順に従います。「プロジェクト」ウィンドウで「LoanRequestor」ノードを右クリックし、「プロジェクトの生成物を削除して構築」を選択します。「出力」ウィンドウに「構築成功」のメッセージが表示されたら、構築は成功です。 (表示を拡大) ページの先頭へ複合アプリケーションの作成と配備 BPEL モジュールプロジェクトを配備する前に、JBI モジュールを配備プロジェクトに追加する必要があります。プロジェクトを配備すると、サービスアセンブリがアプリケーションサーバーで使用可能になり、したがって、そのサービスユニットを実行できるようになります。複合アプリケーションプロジェクトを作成し、JBI モジュールを追加するには、次の手順に従います。 IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。「新規プロジェクト」ウィザードが開きます。「カテゴリ」リストで、「サービス指向アーキテクチャー」ノードを選択します。「プロジェクト」リストで、「複合アプリケーション」ノードを選択します。「次へ」をクリックします。「プロジェクト名」フィールドに「LoanRequestorCompositeApp」と入力します。「完了」をクリックします。この時点で、「プロジェクト」ウィンドウに、LoanRequestorCompositeApp という複合アプリケーションプロジェクト用のプロジェクトノードが含まれます。「プロジェクト」ウィンドウで「LoanRequestorCompositeApp」プロジェクトノードを右クリックし、ポップアップメニューから「JBI モジュールを追加」を選択します。「プロジェクトの選択」ダイアログが開きます。このチュートリアルですでに作成した LoanRequestor プロジェクトを選択し、「プロジェクト JAR ファイルを追加」をクリックします。「プロジェクトの選択」ダイアログが閉じます。「プロジェクト」ウィンドウで、「LoanRequestorCompositeApp」プロジェクトノードを展開し、さらに「JBI モジュール」ノードを展開します。「LoanRequestor.jar」ノードが追加されたことを確認してください。複合アプリケーションを配備するには、次の手順に従います。「LoanRequestorCompositeApp」プロジェクトノードを右クリックし、「プロジェクトを配備」を選択します。「出力」ウィンドウに「構築成功」のメッセージが表示されたら、配備は成功です。 (表示を拡大) ページの先頭へ複合アプリケーションのテストテストケースを追加して操作に結合し、入力を行なったあと、テスターを使用することにより、複合アプリケーションプロジェクトの機能を強化できます。 LoanRequestorCompositeApp をテストするには、次の手順に従います。「プロジェクト」ウィンドウで、「LoanRequestorCompositApp」プロジェクトノードを展開し、「テスト」ノードを右クリックし、ポップアップメニューから「新規テストケース」を選択します。「新規テストケース」ウィザードが開きます。「テストケース名」に「successTest」と入力し、「次へ」をクリックします。「WSDL ドキュメントの選択」ページで、「LoanRequestor - プロセスファイル」ノードを展開し、「LoanRequestor.wsdl」を選択して「次へ」をクリックします。「テストする操作を選択」ページで、「LoanRequestorOperation」を選択して「完了」をクリックします。「プロジェクト」ウィンドウで、「テスト」の下に新しい「successTest」ノードが追加されました。このノードには「入力」と「出力」の 2 つのサブノードが含まれています。ソースエディタには、入力ファイル Input.xml 用のタブが含まれています。ソースエディタに Input.xml のタブが含まれていない場合は、「プロジェクト」ウィンドウの「入力」ノードをダブルクリックしてファイルを開きます。ソースエディタの Input.xml ファイル用のタブで、次の操作を実行します。次の行を探します。 <loan:socialSecurityNumber>?string?</loan:socialSecurityNumber>. ?string? を 123-45-6789 に置き換えます。この行は次のようになります。 <loan:socialSecurityNumber>123-45-6789</loan:socialSecurityNumber>. 手順 a と b を繰り返し、次の各行の要素を置き換えます。行の内容置換前置換後結果としての行 applicantName ?string? Gopalan <loan:applicantName>Gopalan</loan:applicantName> applicantAddress ?string? 507 Alberta <loan:applicantAddress>507 Alberta</loan:applicantAddress> applicantEmailAddress ?string? <loan:applicantEmailAddress></loan:applicantEmailAddress> applicantAge ?3? 36 <loan:applicantAge>36</loan:applicantAge> applicantGender ?string? male <loan:applicantGender>male</loan:applicantGender>. annualSalary ?1.051732E7? 100000 <loan:annualSalary>100000</loan:annualSalary> amountRequested ?1.051732E7? 1000000 <loan:amountRequested>1000000</loan:amountRequested>. IDE のメインメニューから、「ファイル」>「すべてを保存」を選択します。「出力」をダブルクリックして、内容を調べます。最初は、output.xml は空です。したがって、最初のテスト実行によって output.xml に実際の出力が生成されます。それ以降のテスト実行では、実際の出力が output.xml の内容と比較されます。「プロジェクト」ウィンドウで「successTest」ノードを右クリックし、ポップアップメニューから「実行」を選択します。注:最初の実行は特殊なケースで、これは、Output.xml は空であり、出力は Output に書き込まれるためです。「JUnit テスト結果」ウィンドウ内の失敗したとのメッセージを確認してください。「空の出力を上書きしますか?」ダイアログが開きます。「はい」をクリックします。「プロジェクト」ウィンドウで「successTest」ノードを右クリックし、ポップアップメニューから「実行」を選択します。初回の実行のあとは、Output は、空白ではありません。ファイルの内容は保存され、新しい結果によって上書きされません。 (表示を拡大) ページの先頭へ BPEL Web サービスクライアントの作成顧客は、Web サービスクライアントを介して必要な情報を送信します。 LoanApplicationWebclient Web サービスクライアントアプリケーションを作成するには、次の手順に従います。 IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。「新規プロジェクト」ウィザードが開きます。「カテゴリ」リストで「Web」ノードを選択します。「プロジェクト」リストで、「Web アプリケーション」ノードを選択します。「次へ」をクリックします。「名前と場所」ページの「プロジェクト名」フィールドに、「LoanApplicationWebclient」と入力します。「完了」をクリックします。この時点で、「プロジェクト」ウィンドウに、LoanApplicationWebclient という Web サービスクライアント用のプロジェクトノードが含まれます。「プロジェクト」ウィンドウで「LoanApplicationWebclient」プロジェクトノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。「新規ファイル」ウィザードが開きます。「新規ファイル」ウィザードで、次の手順を実行します。「ファイルの種類を選択」ページの「カテゴリ」リストで、「Web サービス」ノードを選択します。「ファイルの種類」リストで「Web サービスクライアント」ノードを選択します。. 「次へ」をクリックします。「WSDL およびクライアントの場所」ページで、「ローカルファイル」オプションを選択します。「参照」ボタンをクリックします。「開く」ダイアログで、LoanRequestor.wsdl ファイルまで移動して選択します。「開く」をクリックします。「パッケージ」フィールドに「loanprocesswsclient」と入力します。「完了」をクリックします。 loanclient.jsp ページを作成するには、次の手順に従います。「プロジェクト」ウィンドウで「LoanApplicationWebclient」プロジェクトノードを右クリックし、「新規」>「ファイル/フォルダ」を選択します。「新規ファイル」ウィザードで、次の手順を実行します。「ファイルの種類を選択」ページの「カテゴリ」リストで、「Web」ノードを選択します。「ファイルの種類を選択」ページの「ファイルの種類」リストで、「JSP」ノードを選択します。「次へ」をクリックします。「JSP ファイル名」フィールドに「loanclient」と入力し、デフォルト値のままにします。「完了」をクリックします。「プロジェクト」ウィンドウで、「LoanApplicationWebclient」ノードを展開し、さらに「Web ページ」ノードを展開します。「loanclient.jsp」ノードが追加され、ソースエディタに loanclient.jsp ファイルが開かれていることに注意してください。ソースエディタの loanclient.jsp ファイル用のタブで、右クリックしてポップアップメニューを表示し、「Web サービスクライアントのリソース」>「Web サービスオペレーションを呼び出す」を選択します。「呼び出すオペレーションを選択」ダイアログで、「LoanApplicationWebClient」ノードを展開し、さらに「LoanRequestor」ノードを展開します。「LoanRequestorService」ノードを展開し、さらに「LoanRequestorPort」ノードを展開します。「LoanRequestorOperation」を選択し、「了解」をクリックします。 (表示を拡大) loanclient.jsp ページを変更するには、次の手順に従います。ソースエディタの loanclient.jsp ファイル用のタブで、次のコード行を // TODO process result here の下に追加します。 requestLoanMessage.setSocialSecurityNumber(request.getParameter("ssn")); requestLoanMessage.setApplicantName(request.getParameter("name")); requestLoanMessage.setApplicantAddress(request.getParameter("address")); requestLoanMessage.setApplicantEmailAddress(request.getParameter("email")); requestLoanMessage.setApplicantAge(Integer.parseInt(request.getParameter("age"))); requestLoanMessage.setApplicantGender(request.getParameter("gender")); requestLoanMessage.setAnnualSalary(Double.parseDouble(request.getParameter("salary"))); requestLoanMessage.setAmountRequested(Double.parseDouble(request.getParameter("loanamount"))); ソースエディタの loanclient.jsp ファイル用のタブで、次の操作を実行します。次の行を探します。 out.println("Result = "+result); 「"+result」を「"+result.getReturn()」に置き換えます。この行は次のようになります。 out.println("Result = "+result.getReturn()); 次のコード行を // TODO handle custom exceptions here の下に追加します。 out.println("===>>>Exception :" + ex.toString()); 次のコード行を // <%-- end web service invocation --%><hr/> の下に追加します。 <form action="index.jsp"> <input type="submit" value="Back To Loan Application"/> </form> 変更を保存するには、「プロジェクト」ウィンドウで「loanclient.jsp」ノードを選択し、IDE のメインメニューから「ファイル」>「保存」を選択します。 (表示を拡大) index.jsp ファイルを変更するには、次の手順に従います。「プロジェクト」ウィンドウで、「LoanApplicationWebclient」プロジェクトノードを展開し、さらに「Web ページ」ノードを展開します。「index.jsp」ノードをダブルクリックします。ソースエディタに index.jsp ファイルが表示されます。次のコード行を </body> の前に追加します。 <form action="loanclient.jsp"> <table> <tr> <td>SSN</td> <td><input type="text" name="ssn" value="123456789"/></td> <td></td> </tr> <tr> <td>Name</td> <td><input type="text" name="name" value="ORCHBank User"/></td> <td></td> </tr> <tr> <td>Address</td> <td><input type="text" name="address" value="16 Network Circle, Menlo Park,CA" /></td> <td></td> </tr> <tr> <td>Email</td> <td><input type="text" name="email" value="orchbankuser@bankmail.com" /></td> <td></td> </tr> <tr> <td>Age</td> <td><input type="text" name="age" value="27" /></td> <td>Age Limit :Min = 18, Max = 65, (If age exceeds 60 BPEL engine's rule rejects the application)</td> </tr> <tr> <td>Gender</td> <td><input type="text" name="gender" value="male" /></td> <td></td> </tr> <tr> <td>Salary</td> <td><input type="text" name="salary" value="56789.10" /></td> <td>Minimum Salary = 20000.00</td> </tr> <tr> <td>Loan Amount</td> <td><input type="text" name="loanamount" value="19500.00" /></td> <td></td> </tr> <tr> <td></td> <td><input type="submit" value="submit" name="Submit Application" /></td> </tr> <td></td> </table> </form> 変更を保存するには、「プロジェクト」ウィンドウで「index.jsp」ノードを選択し、IDE のメインメニューから「ファイル」>「保存」を選択します。 index.jsp ファイルを実行するには、次の手順に従います。「プロジェクト」ウィンドウで、「LoanApplicationWebclient」ノードを展開し、さらに「Web ページ」ノードを展開します。「WEB-INF」ノードを展開し、「index.jsp」を選択します。 index.jsp ファイルを右クリックし、ポップアップメニューから「ファイルを実行」を選択します。「出力」ウィンドウに、index.jsp が参照している URL と、構築が成功した場合は「構築成功」のメッセージが表示されます。ブラウザが表示されます。表示されない場合は、ブラウザを起動し、「出力」ウィンドウの「LoanApplicationWebclient (実行)」タブに示されている URL を入力してください。「JSP ページ」が表示されます。 (表示を拡大) ブラウザで、「JSP Page」内のsubmit ボタンをクリックします。ローン申請の状態が表示されます。ページの先頭へ ---------------------------------------- 付録 EJB プロジェクトの作成 EJB モジュールを作成するには、次の手順に従います。 IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。「カテゴリ」で「エンタープライズ」ノードを選択します。「プロジェクト」で、「EJB モジュール」ノードを選択します。「次へ」をクリックします。「プロジェクト名」フィールドに「LoanProcessor」と入力します。 (省略可能)「プロジェクトの場所」フィールドの「参照」ボタンを使用して、IDE が EJB プロジェクトファイルを格納する別のフォルダに移動して選択します。「完了」をクリックします。この時点で、「プロジェクト」ウィンドウに、LoanProcessor という EJB モジュールプロジェクト用のプロジェクトノードが含まれます。新規 Web サービスを作成するには、次の手順に従います。「プロジェクト」ウィンドウで「LoanProcessor」ノードを右クリックし、コンテキストメニューから「新規」>「Web サービス」を選択します。「新規 Web サービス」ウィザードが開きます。「新規 Web サービス」ウィザードで、次の手順を実行します。「名前と場所」ページの「Web サービス名」フィールドに、「LoanProcessor」と入力します。「パッケージ」フィールドに「com.sun.loanprocessor」と入力します。「完了」をクリックします。「プロジェクト」ウィンドウで、「LoanProcessor」プロジェクトノードを展開し、さらに「Web サービス」ノードを展開します。「LoanProcessor」ノードを右クリックし、「オペレーションを追加」を選択します。「オペレーションを追加」ダイアログが開きます。「名前」フィールドに「processApplication」と入力します。「追加」ボタンをクリックします。「メソッドのパラメータを入力」ダイアログが開きます。「型」ドロップダウンリストから、「String」を選択します。「名前」フィールドに、「socialSecurityNumber」と入力します。「了解」をクリックします。手順 6 〜 8 を繰り返して、他の 6 つのパラメータを次の説明を使用して作成します。型名前 String applicantName String applicantAddress String applicantEmailAddress int applicantAge String applicantGender double annualSalary double amountRequested 「了解」をクリックします。「プロジェクト」ウィンドウで、「LoanProcessor」プロジェクトノードを展開し、さらに「Web サービス」ノードを展開します。「LoanProcessor」Web サービスを展開し、「processApplication」ノードをダブルクリックします。ソースエディタに processApplication メソッド LoanProcessor.java 用のスケルトンを持つタブが含まれていることを確認してください。次のメソッドの本体をコピーし、自動的に生成されたメソッドの直下にある、ソースエディタの LoanProcessor.java ファイル用のタブの中にペーストし、後述のように processApplication 操作を変更します。 public String processApplication(@WebParam(name = "socialSecurityNumber") String socialSecurity, @WebParam(name = "applicantName")String applicantName, @WebParam(name = "applicantAddress") String applicantAddress, @WebParam(name = "applicantEmailAddress")String applicantEmailAddress, @WebParam(name = "applicantAge") int applicantAge, @WebParam(name = "applicantGender")String applicantGender, @WebParam(name = "annualSalary") double annualSalary, @WebParam(name = "amountRequested")double amountRequested) { int MINIMUM_AGE_LIMIT = 18; int MAXIMUM_AGE_LIMIT = 65; double MINIMUM_SALARY = 20000; int AVERAGE_LIFE_EXPECTANCY = 70; String result = "Loan Application APPROVED."; if(applicantAge < MINIMUM_AGE_LIMIT) { result = "Loan Application REJECTED - Reason:Under-aged "+applicantAge+".Age needs to be over "+MINIMUM_AGE_LIMIT+" years to qualify."; System.out.println(result); return result; } if(applicantAge > MAXIMUM_AGE_LIMIT) { result = "Loan Application REJECTED - Reason:Over-aged "+applicantAge+".Age needs to be under "+MAXIMUM_AGE_LIMIT+" years to qualify."; System.out.println(result); return result; } if(annualSalary < MINIMUM_SALARY) { result = "Loan Application REJECTED - Reason:Annual Salary $"+annualSalary+" too low.Annual Salary needs to be over $"+MINIMUM_SALARY+" to qualify."; System.out.println(result); return result; } int yearsToRepay = AVERAGE_LIFE_EXPECTANCY-applicantAge; double limit = annualSalary*yearsToRepay*0.5; if(amountRequested > limit) { result = "Loan Application REJECTED - Reason:You are asking for too much $"+amountRequested+". Annual Salary $"+annualSalary+", Age "+applicantAge+" years. Your limit is $"+limit; System.out.println(result); return result; } System.out.println(result); return result; } 変更を保存するには、IDE のメインメニューから「ファイル」>「保存」を選択します。ご意見をお寄せくださいページの先頭へ