>> その他の SOA ドキュメント

WSDL エディタの「パートナー」ビューの紹介

このチュートリアルでは、WSDL エディタの「パートナー」ビューについて説明します。

WSDL エディタの「パートナー」ビューは、WSDL ファイルの抽象要素をパートナー間の対話として表現します。抽象要素には、パートナーリンク型、ロール、ポート型、操作、およびメッセージがあります。

目次

チュートリアルの要件 Sun Java System Application Server の構成と起動 BPEL モジュールプロジェクトの作成 WSDL ファイルの作成 ビジネスプロセスの作成 複合アプリケーションプロジェクトの作成と配備 複合アプリケーションのテスト まとめ 関連項目

チュートリアルの要件

次に進む前に、この節の要件を確認してください。

前提条件

このチュートリアルでは、Java 言語、Java プラットフォーム、および NetBeans IDE の基本的な知識またはプログラミング経験があることを前提としています。

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

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

• NetBeans IDE 6.0
  
  「すべて」オプションを選択します。「すべて」オプションには、このチュートリアルで必要な SOA パックと GlassFish V2 が含まれています。

ページの先頭へ

Sun Java System Application Server の構成と起動

複合アプリケーションを配備する前に、Sun Java System Application Server と BPELサービスエンジンを正しく構成して、実行する必要があります。

Sun Java System Application Server の状態を確認するには、次の手順に従います。

1. 「実行時」ウィンドウが表示されない場合は、「ウィンドウ」>「実行時」を選択します。
2. 「実行時」ウィンドウで「 サーバー 」ノードを展開します。
   「サーバー」ノードに「Sun Java System Application Server」サブノードが含まれているはずです。「Sun Java System Application Server」ノードが表示されない場合は、Sun Java System Application Server の構成に進んでください。
   「Sun Java System Application Server」ノードに緑色の矢印のバッジが表示された場合、そのサーバーは実行中です。緑色の矢印のバッジが表示されない場合は、Sun Java System Application Server の起動に進んでください。

Sun Java System Application Server を構成するには、次の手順に従います。

1. 「実行時」ウィンドウが表示されない場合は、「ウィンドウ」>「実行時」を選択します。
2. 「実行時」ウィンドウで「 サーバー 」ノードを右クリックし、ポップアップメニューから「サーバーを追加」を選択します。
   「サーバーインスタンスの追加」ダイアログが開きます。
3. 「サーバーを選択」ページで、「サーバー」ドロップダウンリストから「Sun Java System Application Server」を選択します。
4. (省略可能) 「名前」フィールドで、サーバーのデフォルト名を変更します。
   IDE は、サーバーを識別するためにこの名前を使用します。
5. 「次へ」をクリックします。
   「プラットフォームフォルダの場所」ページが開きます。
6. 「プラットフォームの場所」フィールドの「参照」ボタンを使用して、アプリケーションサーバーのインストール場所に移動して、選択します。
   次の表 1 に示すように、デフォルトのインストール場所は、インストールの種類とプラットフォームによって異なります。
   
   

   表 1: アプリケーションサーバーのデフォルトのインストールディレクトリ

   プラットフォーム	インストールしたユーザー	SOA インストール	ツール付きバンドルインストール
   Solaris OS  Linux	root	/opt/SUNWappserver	/opt/SDK
   Solaris OS Linux	user	~/SUNWappserver	~/SDK
   Mac OS X	N/A	~/SUNWappserver	~/SDK
   Windows	N/A	C:\Sun\AppServer	C:\Sun\SDK

7. 「ローカルのデフォルトドメインを登録」ラジオボタンを選択し、「次へ」をクリックします。
8. ドメインの管理者のユーザー名とパスワードを入力します。
   インストール時にデフォルト値のままにした場合、ユーザー名は admin で、パスワードは adminadmin です。
9. 「完了」をクリックします。

Sun Java System Application Server を起動するには、次の手順に従います。

1. 「実行時」ウィンドウで、「Sun Java System Application Server」ノードを右クリックし、「起動」を選択します。
2. 「出力」ウィンドウに次のメッセージが表示されるまで待ちます。
   Application server startup complete.
   サーバーが稼動している場合は、「Sun Java System Application Server」ノード上に緑色の矢印のバッジが表示されます。

BPEL サービスエンジンの状態を確認するには、次の手順に従います。

1. 「実行時」ウィンドウで、「Sun Java System Application Server」>「JBI」>「サービスエンジン」を展開します。
2. 「sun-bpel-engine」ノードを右クリックします。
   「起動」オプションが使用できない場合は、サービスエンジンが起動し、この手順の残りの部分をスキップできます。
3. 「起動」をクリックします。
4. 「出力」ウィンドウに次のメッセージが表示されるまで待ちます。
   BPEL service engine started

ページの先頭へ

BPEL モジュールプロジェクトの作成

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

BPEL モジュールプロジェクトを作成するには、次の手順に従います。

1. IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。
   「新規プロジェクト」ウィザードが開きます。
2. 「カテゴリ」リストで「SOA」ノードを選択します。
3. 「プロジェクト」リストで、「BPEL モジュール」ノードを選択します。
4. 「次へ」をクリックします。
5. 「プロジェクト名」フィールドに「PartnerView」と入力します。
6. 「完了」をクリックします。
   この時点で、「プロジェクト」ウィンドウに、PartnerView という BPEL モジュールプロジェクトのノードが含まれます。

ページの先頭へ

WSDLファイルの作成

この節では、WSDL ファイルを BPEL モジュールプロジェクトに追加します。

WSDL ファイルには、文字列値を入力として受け取り、文字列値を出力として送信する基本的なサービスが記述されています。WSDL エディタの「パートナー」ビューを使用して、入力メッセージ、出力メッセージ、パートナーリンク型、ポート型、および操作を追加します。WSDL エディタの WSDL ビューを使用して、結合とサービスを追加します。

パートナーリンク型 は、2 つのサービス間の対話関係を明らかにするものです。パートナーリンク型は 1 つまたは 2 つのロールを持つことができます。ロールは、その関係の中でサービスが持つ機能を記述したものです。

ロールは、サービスがメッセージを受信するために使用するポート型を指定する必要があります。ポート型には、Web サービスが実行できる 1 つ以上の関連操作が含まれます。WSDL エディタでは、次のカテゴリの操作がサポートされています。

• 要求-応答 。操作でメッセージが入力として受信され、メッセージが出力として送信されます。
• 片方向 。操作では、メッセージが入力として受信されます。

WSDL ファイルのポート型には、要求と応答の操作が含まれています。

PartnerView.wsdl ファイルを作成するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで PartnerView プロジェクトの「プロセスファイル」ノードを右クリックし、「新規」>「WSDL ドキュメント」を選択します。
   「新規 WSDL ドキュメント」ウィザードが開きます。
2. 「ファイル名」フィールドに「PartnerView」と入力します。
3. 「完了」をクリックします。
   WSDL ビューが開いた状態で WSDL エディタが表示されます。
4. WSDL ビューのツールバーで、「パートナー」ボタンをクリックします。
   「パートナー」ビューが表示されます。

入力メッセージを追加するには、次の手順に従います。

1. 「パレット」が表示されていない場合は、IDE のメインメニューから「ウィンドウ」>「パレット」を選択します。
2. 「パレット」で「メッセージ」アイコンを選択します。
3. 「メッセージ」アイコンを「パートナー」ビューの「メッセージ」領域にドラッグします。
   IDE がメッセージを追加します。メッセージの名前は message1 です。
4. 「部品名」列で、デフォルト値 part1 をダブルクリックし、フィールドを編集可能にします。
5. 「 inputType 」と入力し、Enter キーを押します。
6. 「要素または型」列で、省略符号 (...) ボタンをクリックします。
7. 「string」ノードを選択します。
8. 「閉じる」をクリックします。

出力メッセージを追加するには、次の手順に従います。

1. 「パレット」で「メッセージ」アイコンを選択します。
2. 「メッセージ」アイコンを「パートナー」ビューの「メッセージ」領域にドラッグします。
   IDE がメッセージを追加します。メッセージの名前は message2 です。
3. 「部品名」列で、デフォルト値 part1 をダブルクリックし、フィールドを編集可能にします。
4. 「 resultType 」と入力し、Enter キーを押します。
5. 「要素または型」列で、省略符号 (...) ボタンをクリックします。
6. 「string」ノードを選択します。
7. 「閉じる」をクリックします。

パートナーリンク型、ポート型、および操作を追加するには、次の手順に従います。

1. 「パレット」で、「パートナーリンク型」アイコンを選択します。
2. 「パートナーリンク型」アイコンを「パートナー」ビューの「パートナーリンク型」領域にドラッグします。
   IDE がパートナーリンク型を追加します。パートナーリンク型の名前は partnerlinktype1 です。 パートナーリンク型には role1 というデフォルトのロールがあります。
3. 「ポート型を入力または選択」をダブルクリックして、Enter キーを押します。
   IDE が portType1 というポート型を追加します。
4. 「パレット」で「要求-応答」アイコンを選択します。
5. 「要求-応答」アイコンをドラッグして、portType1 ボックスの下にある破線の縦線上にドラッグします。
   IDE が operation1 という操作を追加します。
6. 「operation1」の下で、最初の <No Message Selected> をダブルクリックして tns:message1 を選択します。 これは、作成した入力メッセージです。
7. 「operation1」の下で、2 つ目の <No Message Selected> をダブルクリックして tns:message2 を選択します。 これは、作成した出力メッセージです。

結合とサービスを追加するには、次の手順に従います。

1. 「パートナー」ビューのツールバーで、「WSDL」ボタンをクリックします。
   「WSDL」ビューが開きます。
2. 「portType1」ノードを右クリックして「追加」>「結合およびサービスポート」を選択します。
   「結合およびサービスポートを生成」ダイアログが開きます。
3. 「結合型」フィールドのデフォルト値は「SOAP」です。デフォルト値は変更しないでください。
4. 「結合サブタイプ」フィールドのデフォルト値は「RPC リテラル」です。デフォルト値は変更しないでください。
5. 「閉じる」をクリックします。
   結合とサービスが追加されます。これで、WSDL ファイルを正常に作成できました。
6. IDE のメインメニューから、「ファイル」>「保存」を選択します。

ページの先頭へ

ビジネスプロセスの作成

この節では、ビジネスプロジェクトを BPEL モジュールプロジェクトに追加します。IDE の BPEL デザイナを使用して、ビジネスプロセスを構成します。

ビジネスプロセスには次のアクティビティーが含まれています。

• 受信アクティビティー。 受信アクティビティーは、パートナーサービスから到着するメッセージを待機します。
• 代入アクティビティー。 代入アクティビティーは入力変数から出力変数へ、データをコピーします。
• 返信アクティビティー。 返信アクティビティーは、パートナーサービスへ応答を送信します。

受信および返信アクティビティーは、パートナーリンクと相互に作用します。パートナーリンクは、ビジネスプロセスが相互に作用する、外部 Web サービスへの参照です。

PartnerView.bpel ファイルを作成するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで PartnerView プロジェクトの「プロセスファイル」ノードを右クリックし、「新規」>「BPEL プロセス」を選択します。
   「新規 BPEL プロセス」ウィザードが開きます。
2. 「ファイル名」フィールドに「PartnerView」と入力します。
3. 「完了」をクリックします。
   デザインビューが開いた状態で BPEL デザイナが表示されます。「PartnerView」ボックスの横に赤い×印が表示され、ビジネスプロセスが無効であることを示します。赤い×印は、この節のあとのほうで受信アクティビティーを追加するまで残ります。
4. 「パレット」が表示されていない場合は、IDE のメインメニューから「ウィンドウ」>「パレット」を選択します。

パートナーリンクを追加するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで「PartnerView.wsdl」ノードを選択します。
2. 「PartnerView.wsdl」ノードを、「プロジェクト」ウィンドウからデザイン領域の空白の部分にドラッグします。
   「新規作成 パートナーリンク」ダイアログが開きます。
3. デフォルト値を受け入れ、「了解」をクリックします。
   IDE が PartnerLink1 というパートナーリンクを追加します。

受信アクティビティーを追加するには、次の手順に従います。

1. 「パレット」の「Web サービス」セクションで、「受信」アイコンを選択します。
2. 選択項目を、デザイン領域の、Process Start と Process End アクティビティーの間にある「PartnerView」ボックスにドラッグします。
   IDE には、選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。
   Receive1 アクティビティーが追加されます。
3. Receive1 アクティビティーをダブルクリックしてプロパティーを編集します。
   「Receive1 [受信] - プロパティーエディタ」ダイアログが開きます。
4. 「パートナーリンク」ドロップダウンリストから、PartnerLink1 を選択します。
   「操作」フィールドは IDE によって operation1 と記入されます。
5. 次の手順に従って、新しい入力変数を作成します。
   1. 「作成」をクリックします。
   2. 「Name」フィールドで、デフォルトの値を inputVar に変更します。
   3. 「閉じる」をクリックします。
6. 「了解」をクリックして「Receive1 [受信] - プロパティーエディタ」ダイアログを閉じます。
   IDE は operation1 操作から Receive1 アクティビティーへの接続を追加します。

返信アクティビティーを追加するには、次の手順に従います。

1. 「パレット」の「Web サービス」セクションで、「返信」アイコンを選択します。
2. 選択項目を、デザイン領域の、Receive1 と Process End アクティビティーの間にある「PartnerView」ボックスにドラッグします。
   IDE には、選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。
   Reply1 アクティビティーが追加されます。
3. Reply1 アクティビティーをダブルクリックしてプロパティーを編集します。
   「Reply1 [返信] - プロパティーエディタ」ダイアログが開きます。
4. 「パートナーリンク」ドロップダウンリストから、PartnerLink1 を選択します。
   「操作」フィールドは IDE によって operation1 と記入されます。
5. 次の手順に従って、新しい出力変数を作成します。
   1. 「正常応答」ラジオボタンが選択されているかを確認してください。
   2. 「作成」をクリックします。
   3. 「Name」フィールドで、デフォルトの値を outputVar に変更します。
   4. 「閉じる」をクリックします。
6. 「了解」をクリックして「Reply1 [返信] - プロパティーエディタ」ダイアログを閉じます。
   IDE は、Reply1 アクティビティーから operation1 操作への接続を追加します。

代入アクティビティーを追加するには、次の手順に従います。

1. 「パレット」の「基本アクティビティー」セクションで、「代入」アイコンを選択します。
2. 選択項目を、デザイン領域の、Receive1 と Reply1 アクティビティーの間にある「PartnerView」ボックスにドラッグします。
   IDE には、選択項目をドロップできる場所を示す視覚的な手がかりが表示されます。
   Assign1 アクティビティーが追加されます。
3. Assign1 アクティビティーを選択します。
4. 「BPEL マッパー」ウィンドウが表示されない場合は、IDE のメインメニューから「ウィンドウ」>「その他」>「BPEL マッパー」を選択します。
5. 「BPEL マッパー」の左側の区画で、「inputVar」ノードを展開します。
   「inputType」ノードが表示されます。
6. 「BPEL マッパー」の右側の区画で、「outputVar」ノードを展開します。
   「resultType」ノードが表示されます。
7. 左側の区画で、「inputType」ノードを選択し、ポインタを右側の区画の「resultType」ノードにドラッグします。
   それらのノードがリンクによって接続されます。
8. IDE のメインメニューから、「ファイル」>「保存」を選択します。

ページの先頭へ

複合アプリケーションプロジェクトの作成と配備

この節では、複合アプリケーションプロジェクトを作成して、BPEL モジュールプロジェクトの Java Archive (JAR) ファイルを追加します。そのあと、複合アプリケーションプロジェクトを Sun Java System Application Server に配備します。

複合アプリケーションプロジェクトを作成するには、次の手順に従います。

1. IDE のメインメニューから、「ファイル」>「新規プロジェクト」を選択します。
   「新規プロジェクト」ウィザードが開きます。
2. 「カテゴリ」リストで「SOA」ノードを選択します。
3. 「プロジェクト」リストで、「複合アプリケーション」ノードを選択します。
4. 「次へ」をクリックします。
5. 「プロジェクト名」フィールドに「PartnerViewCompositeApp」と入力します。
6. 「完了」をクリックします。
   この時点で、「プロジェクト」ウィンドウに、PartnerViewCompositeApp という複合アプリケーションプロジェクト用のノードが含まれます。

BPEL モジュールプロジェクトの JAR ファイルを追加するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで「PartnerViewCompositeApp」ノードを右クリックし、ポップアップメニューから「JBI モジュールを追加」を選択します。
   「プロジェクトの選択」ダイアログが開きます。
2. 「PartnerView」プロジェクトを選択します。 このプロジェクトは、前の節で作成した BPEL モジュールプロジェクトです。
3. 「プロジェクト JAR ファイルを追加」をクリックします。
4. 「プロジェクト」ウィンドウで、「PartnerViewCompositeApp」ノードを展開し、さらに「JBI モジュール」ノードを展開します。
   「PartnerView.jar」ノードが追加されたことを確認してください。

複合アプリケーションプロジェクトを配備するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで「PartnerViewCompositeApp」ノードを右クリックし、「プロジェクトを配備」を選択します。
2. 「出力」ウィンドウで、「 構築成功 」メッセージが表示されるのを監視します。

ページの先頭へ

複合アプリケーションのテスト

この節では、テストを実行して、複合アプリケーションが予想どおりに動作することを検証します。作成するテストケースは PartnerView.wsdl ファイルの operation1 操作を呼び出します。

テストケースを追加するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで、「PartnerViewCompositeApp」ノードを展開し、「テスト」ノードを右クリックし、ポップアップメニューから「新規テストケース」を選択します。
   「新規テストケース」ウィザードが開きます。
2. 「テストケース名を入力」ページで、名前を PartnerViewTestCase と設定して「次へ」をクリックします。
3. 「WSDL ドキュメントの選択」ページで、「PartnerView - プロセスファイル」ノードを展開し、「PartnerView.wsdl」を選択して「次へ」をクリックします。
4. 「テストする操作を選択」ページで、「operation1」を選択して「完了」をクリックします。
   「PartnerViewTestCase」ノードが追加されます。 「PartnerViewTestCase」には、「Input」と「Output」の 2 つのサブノードがあります。 ソースエディタには、入力ファイル Input.xml 用のタブが含まれています。
5. Input.xml ファイルの次の行を検索します。
   <inputType>?string?</inputType>
6. 行を次のように変更します。
   <inputType>Hello World</inputType>
7. IDE のメインメニューから、「ファイル」>「保存」を選択します。
8. 「プロジェクト」ウィンドウで、「Output」ノードをダブルクリックします。
   ソースエディタには、出力ファイル Output.xml 用のタブが含まれています。最初、この出力ファイルは空です。

テストケースを実行するには、次の手順に従います。

1. 「プロジェクト」ウィンドウで「PartnerViewTestCase」ノードを右クリックし、ポップアップメニューから「実行」を選択します。
   出力ファイルは空なので、テストは失敗します。「空の出力を上書きしますか?」ダイアログが開き、Output.xml ファイルを上書きすることを確認できます。
2. 「はい」をクリックします。
3. 「プロジェクト」ウィンドウで「PartnerViewTestCase」ノードを右クリックし、ポップアップメニューから「実行」を選択します。
   テストに合格します。
4. テスト結果は Output.xml ファイルに表示されます。

ページの先頭へ

まとめ

このチュートリアルでは、複合アプリケーションの作成および配備時に、WSDL エディタの「パートナー」ビューを操作しました。

ページの先頭へ

関連項目

• WSDL エディタ開発者ガイド
• BPEL デザイナ開発者ガイド

---

>> その他の SOA ドキュメント

ページの先頭へ