前提条件

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

システム要件

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

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

開始する前に、次のソフトウェアをコンピュータにインストールしてください。

• NetBeans IDE 5.5 と NetBeans Enterprise Pack 5.5 (ダウンロード)

目次

• チュートリアル環境の構成
• SynchronousSample プロジェクトの作成
• 「BPEL マッパー」ウィンドウの操作
• BPEL マッパーを使用した同期 BPEL プロジェクトの編集
  • 変数の追加
  • XML スキーマの変更
  • BPEL プロセスの編集
  • If 要素への条件の追加
  • 代入要素への式の追加
• Application Server へのプロジェクトの配備
• テストケースの作成
• アプリケーションの配備とテスト
• まとめ

変数の追加

この手順では、文字列型の todayIs 変数をビジネスプロセスに追加します。この変数は、current-date 関数の戻り値を格納するために使用します。

1. IDE 内で SynchronousSample.bpel ファイルが開かれていない場合は、この時点で開いてください。
2. デザインビューで、SynchronousSample プロセス要素を右クリックし、「追加」>「変数」を選択します。
3. 「名前」フィールドに「todayIs」と入力します。
4. 「組み込み型」ノードを展開し、「string」型を選択します。
5. 「了解」をクリックします。
   図で Assign1 要素を選択します。「BPEL マッパー」ウィンドウの両方のツリー区画に todayIs 変数が表示されます。

XML スキーマの変更

この手順では、既存の XML スキーマ要素のプロパティーを変更し、新しい nTest 要素を追加します。nTest 要素は、どの If 分岐を実行するかを定義するために使用します。あとで、nTest 要素をテストケースで使用します。

1. 「プロジェクト」ウィンドウで、「SynchronousSample」プロジェクトノードと「ProcessFiles」ノードを展開します。
2. 「SynchronousSample.xsd」ノードをダブルクリックします。
   XML スキーマファイルのスキーマビューが表示されます。
3. スキーマビューの各列で「複合型」>「simpleProcess」>「sequence」>「paramA」をそれぞれ選択します。
   列ボタン をクリックすると、ビューを列モードにできます。
4. 「プロパティー」ウィンドウで、「最大件数」パラメータの値を「unbounded」に設定して、1 以上の値を使用できるようにします。
   「プロパティー」ウィンドウが表示されていない場合は、「ウィンドウ」>「プロパティー」を選択するか、Ctrl-Shift-7 を押します。

   
   クリックして拡大

5. スキーマビューの第 3 列で、シーケンス要素を右クリックし、ポップアップメニューから「追加」>「要素」を選択します。
6. 「要素」ダイアログの「名前」フィールドに「nTest」と入力し、「既存の型を使用」オプションを選択します。
7. 「組み込み型」ノードを展開し、「int」型を選択します。
8. 「了解」をクリックします。

   
   クリックして拡大

9. 「ファイル」>「すべてを保存」を選択します。

BPEL プロセスの編集

この手順では、If アクティビティーと Assign アクティビティーをビジネスプロセスに追加します。

1. IDE 内で SynchronousSample.bpel ファイルが開かれていない場合は、この時点で開いてください。
2. デザインビューで、パレットで If アイコンを選択し、デザイン領域にドラッグして、図の start 要素と Assign1 要素の間にドロップします。
3. Assign1 要素を If1 要素内に移動し、メインの分岐上にドロップします (ストロークなし)。
4. パレットで Assign アイコンを選択し、図で If 要素内にある Assign1 要素の下にドロップします。
   この要素はラベルが Assign2 になります。
5. If 要素を右クリックし、ポップアップメニューから「Else If を追加」を選択します。
6. パレットで Assign アイコンを選択し、図で ElseIf 分岐の中にドロップします。
   この要素はラベルが Assign3 になります。
   作成したビジネスプロセス図が次の図のようになっていることを確認してください。

クリックして拡大

If 要素への条件の追加

If アクティビティーを実行するための条件を指定するには、次の手順に従います。nTest パラメータで、どの If 分岐が真であるかを定義します。If 分岐では nTest は 1、ElseIf 分岐では nTest は 2 です。

If1 要素の条件を指定するには、次の手順に従います。

1. 図で If1 要素を選択します。
2. 「BPEL マッパー」ウィンドウのメニューバーで、「数値」>「数値リテラル」および「演算子」>「等しい」を選択します。
   マッピング区画に 2 つの関数ボックスが表示されます。操作しやすいように、「数値リテラル」関数ボックスを左側に、「等しい」関数ボックスを右側にドラッグして配置します。
3. 「BPEL マッパー」ウィンドウの左側のツリー区画で、「inputVar」ノードと「inputType」ノードを展開します。
4. 左側のツリー区画で「nTest」ノードを選択し、「等しい」関数ボックスの any1 パラメータにポインタをドラッグします。
5. 「数値リテラル」関数ボックスで入力フィールドをダブルクリックし、「1」と入力します。
6. 「数値リテラル」関数ボックスを選択し、「等しい」関数ボックスの any2 パラメータにポインタをドラッグします。
7. 「等しい」関数ボックスで return boolean パラメータを選択し、「BPEL マッパー」ウィンドウの右側のツリー区画にある「結果」ノードにポインタをドラッグします。
8. 「ファイル」>「保存」をクリックします。

クリックして拡大

ElseIf 要素の条件を指定するには、次の手順に従います。

1. 図で ElseIf 要素を選択します。
2. 前の If 要素の場合と同じ手順に従いますが、「数値リテラル」関数ボックスの値として「2」を入力します。

クリックして拡大

代入要素への式の追加

この手順では、ソースエディタと BPEL マッパーを使用して、Assign1、Assign2、および Assign3 の各要素に式を追加します。

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

1. 図で Assign1 要素を選択します。
2. 「BPEL マッパー」ウィンドウのメニューバーで、「日時」>「現在日付」を選択します。
   マッピング区画に「現在日付」関数ボックスが表示されます。
3. 「現在日付」関数ボックスで return string パラメータを選択し、「BPEL マッパー」ウィンドウの右側のツリー区画にある「todayIs」ノードにポインタをドラッグします。
4. 「ファイル」>「保存」をクリックします。

   
   クリックして拡大

5. 図で Assign1 要素を右クリックし、ポップアップメニューから「ソースへ」を選択します。

   ソースビューでは、次のように Assign1 要素の copy 演算子を使用して、return string パラメータの値を todayIs 変数にコピーしています。

  <assign name="Assign1">
    <copy>            
      <from>current-date()</from>
      <to variable="todayIs"/>         
    </copy>     
  </assign>  

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

Assign2 要素は次の出力文字列を作成します。Hello! Today is 2006-11-17. Time zone is 03:00.

現在の日付を YYYY-MM-DD ZZ:ZZ の形式で表す todayIs 変数を使用します。YYYY は年、MM は月、DD は日、ZZ:ZZ はタイムゾーンをそれぞれ表します。

1. 図で Assign2 要素を選択します。
2. 「BPEL マッパー」ウィンドウのメニューバーで、「文字列」>「連結」を選択し、「文字列」>「部分文字列」を 2 回選択します。
   マッピング区画に 3 つの関数ボックスが表示されます。操作しやすいように、2 つの「部分文字列」関数ボックスを左側に、「連結」関数ボックスを右側にドラッグして配置します。
3. todayIs 変数から、日付だけを含み、タイムゾーンを含まない文字列を作成するには、次の手順に従います。
   
   1. 左側のツリー区画で「todayIs」ノードを選択し、最初の「部分文字列」関数ボックスの string パラメータにポインタをドラッグします。
   2. 関数ボックス内で number をダブルクリックし、「1」と入力します。
      これは、todayIs 文字列のコピーを開始する位置です。
   3. 関数ボックス内で number? をダブルクリックし、「10」と入力します。
      これは、コピーする文字数です。
4. todayIs 変数から、タイムゾーンだけを含み、日付を含まない文字列を作成するには、次の手順に従います。
   
   1. 左側のツリー区画で「todayIs」ノードを選択し、2 つ目の「部分文字列」関数ボックスの string パラメータにポインタをドラッグします。
   2. 関数ボックス内で number をダブルクリックし、「11」と入力します。
      これは、todayIs 文字列のコピーを開始する位置です。

   注: ここでは、number? パラメータは部分文字列関数に必須ではありません。パラメータを指定しなかった場合、部分文字列関数では文字列が開始位置から末尾までコピーされます。

5. この節の最初に述べた出力の連結文字列を作成するには、次の手順に従います。
   
   1. 「BPEL マッパー」ウィンドウの左側のツリー区画で、「inputVar」ノードと「inputType」ノードを展開します。
   2. 左側のツリー区画で「paramA」ノードを選択し、「連結」関数ボックスの string1 パラメータにポインタをドラッグします。
      これで、入力パラメータに含まれる文字列がコピーされます。
   3. 「連結」関数ボックス内で string2 をダブルクリックし、「Today is」と入力します。
      この操作は出力用の文字列を作成するために使用します。この文字列は出力文字列に追加されます。
   4. 最初の「部分文字列」関数ボックスで、return string パラメータを選択し、「連結」関数ボックスの string3 にポインタをドラッグします。
      これで、現在の日付がタイムゾーンなしでコピーされます。
   5. 「連結」関数ボックス内で string4 をダブルクリックし、「. Time zone is」と入力します。
      この文字列は現在の日付に続きます。
   6. 2 つ目の「部分文字列」関数ボックスで、return string パラメータを選択し、「連結」関数ボックスの string5 にポインタをドラッグします。
      これで、タイムゾーンが現在の日付なしでコピーされます。
   7. 「連結」関数ボックス内で string6 をダブルクリックし、「. 」と入力します。
      この文字列はタイムゾーンの後ろに追加されます。
   8. 「BPEL マッパー」ウィンドウの右側のツリー区画で、「outputVar」ノードと「resultType」ノードを展開します。
   9. 「連結」関数ボックスで return string パラメータを選択し、「BPEL マッパー」ウィンドウの右側のツリー区画にある「paramA」ノードにポインタをドラッグします。
      これで、連結関数の結果が出力にコピーされます。
6. 「ファイル」>「保存」をクリックします。

   
   クリックして拡大

7. 図で Assign2 要素を右クリックし、ポップアップメニューから「ソースへ」を選択します。
   

   ソースビューでは、次のように Assign2 要素の copy 演算子を使用して、現在の日付とタイムゾーンを含む文字列を作成しています。

   <assign name="Assign2">    
     <copy>
       <from>concat($inputVar.inputType/ns0:paramA, ' Today is ', substring($todayIs, 1, 10), '. Time zone is ', substring($todayIs, 11), '.')</from>
       <to>$outputVar.resultType/ns0:paramA</to>
     </copy>
   </assign>

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

Assign3 要素には、ソースエディタを使用して式を追加します。

注: ソースエディタを使用して式を追加したあと、必要に応じて BPEL マッパーで要素を編集できます。

1. BPEL 図で Assign3 要素を右クリックし、ポップアップメニューから「ソースへ」を選択します。
2. 文字列 <assign name="Assign3"/> を次の文字列に置き換えます。

   <assign name="Assign3">    
     <copy>
       <from>concat('There are/is ', count($inputVar.inputType/ns0:paramA, ' element(s) in nodeset.', 'Sum of element(s) is ', sum($inputVar.inputType/ns0:paramA), '. Last element is ', $inputVar.inputType/ns0:paramA[last()], '.')</from>
       <to>$outputVar.resultType/ns0:paramA</to>
     </copy>
   </assign>

3. 「ファイル」>「保存」をクリックします。
4. エディタツールバーの「デザイン」ボタンをクリックしてデザインビューに切り替え、「BPEL マッパー」ウィンドウで結果を表示します。
5. BPEL 図で Assign3 要素を選択します。

   
   クリックして拡大

   Assign3 要素の式は、paramA にコピーされたノードの数を表示し、すべてのノードの合計を計算して、最後のノードの値を示します。出力文字列の例を次に示します。There are/is 3 element(s) in nodeset. Sum of element(s) is 6. Last element is 3.

ページの先頭へ