先决条件

要了解本教程，您需要具备 SOA 技术和 NetBeans IDE 的一些基本知识或编程经验。

系统要求

本教程假定您的系统满足 NetBeans Enterprise Pack 5.5 发行说明的“系统要求”主题中指定的要求。

本教程所需的软件

在开始之前，您必须在计算机中安装以下软件：

• 包含 NetBeans Enterprise Pack 5.5 的 NetBeans IDE 5.5（下载）

目录

• 配置教程环境
• 创建 SynchronousSample 项目
• 浏览“BPEL 映射器”窗口
• 使用 BPEL 映射器编辑同步 BPEL 项目
  • 添加变量
  • 修改 XML 架构
  • 编辑 BPEL 流程
  • 在 If 元素中添加条件
  • 在 Assign 元素中添加表达式
• 将项目部署到应用服务器上
• 创建测试用例
• 部署和测试应用程序
• 小结

添加变量

在此过程中，您将向业务流程添加 "todayIs" 变量（字符串类型）。此变量用于存储 "current-date" 函数返回的值。

1. 如果在 IDE 中未打开 "SynchronousSample.bpel" 文件，请立即将其打开。
2. 在“设计”视图中，右键单击 SynchronousSample 流程元素，然后选择“添加”>“变量”。
3. 在“名称”字段中，输入 "todayIs"。
4. 展开“内置类型”节点，然后选择 "string" 类型。
5. 单击“确定”。
   在图中选择 "Assign1" 元素。现在，"todayIs" 变量已显示在“BPEL 映射器”窗口的两个树窗格中。

修改 XML 架构

在此过程中，您将修改现有 XML 架构元素的属性，并添加新的 "nTest" 元素。"nTest" 元素用于定义将要执行的 If 分支。稍后，您将在测试用例中使用 "nTest" 元素。

1. 在“项目”窗口中，展开 "SynchronousSample" 项目节点和“流程文件”节点。
2. 双击 "SynchronousSample.xsd" 节点。
   IDE 将打开 XML 架构文件的“架构”视图。
3. 在“架构”视图列中，选择“复杂类型”> "simpleProcess" > "sequence" > "paramA"。
   您可以单击列按钮 以确保视图处于列模式。
4. 在“属性”窗口中，将“最大出现次数”参数设置为 "unbounded" 以允许使用大于或等于 1 的值。
   如果尚未打开“属性”窗口，请选择“窗口”>“属性”或者按 Ctrl-Shift-7 组合键。

   
   单击以放大

5. 在“架构”视图的第三列上，右键单击 "sequence" 元素，然后从弹出式菜单中选择“添加”>“元素”。
6. 在“元素”对话框的“名称”字段中，输入 "nTest"，然后选择“使用现有类型”选项。
7. 展开“内置类型”节点，然后选择 "int" 类型。
8. 单击“确定”。

   
   单击以放大

9. 选择“文件”>“全部保存”。

编辑 BPEL 流程

在此过程中，您将向业务流程添加 If 和 Assign 活动。

1. 如果在 IDE 中未打开 "SynchronousSample.bpel" 文件，请立即将其打开。
2. 在“设计”视图中，选择组件面板上的 "If" 图标，将所选组件拖到设计区域中，并将其放在图的 "start" 和 "Assign1" 元素之间。
3. 将 "Assign1" 元素移入 If1 元素，并将其放在主分支上（没有斜杠）。
4. 在组件面板上，选择“分配”图标，并将其放在 If 元素中 "Assign1" 元素之后。
   此元素标记为 "Assign2"。
5. 右键单击 If 元素，然后从弹出式菜单中选择“添加 Else If”。
6. 在组件面板上，选择“分配”图标，并将其放在 ElseIf 分支中的图上。
   此元素标记为 "Assign3"。
   请参见下图以验证您的业务流程图是否与此图类似。

单击以放大

在 If 元素中添加条件

按照以下步骤，您可以指定执行 If 活动的条件。"nTest" 参数定义了值为 true 的 If 分支。对于 If 分支，"nTest" 等于 1，对于 ElseIf 分支，"nTest" 等于 2。

为 "If1" 元素指定条件：

1. 在图中选择 "If1" 元素。
2. 在“BPEL 映射器”窗口中的菜单栏上，选择“数值”> "Number Literal" 和“运算符”> "EQUAL"。
   映射窗格中会出现两个函数框。为方便起见，请拖动函数框将 "Number Literal" 框放在左侧，"EQUAL" 函数框放在右侧。
3. 在“BPEL 映射器”窗口的左侧树窗格中，展开 "inputVar" 和 "inputType" 节点。
4. 在左侧树窗格中选择 "nTest" 节点，然后将指针拖到 EQUAL 函数框中的 "any1" 参数。
5. 在 "Number Literal" 函数框中，双击输入字段并输入 1。
6. 选择 "Number Literal" 函数框，然后将指针拖到 EQUAL 函数框中的 "any2" 参数。
7. 在 EQUAL 函数框中，选择 "return boolean" 参数，然后将指针拖到“BPEL 映射器”窗口右侧树窗格中的“结果”节点。
8. 选择“文件”>“保存”。

单击以放大

为 "ElseIf" 元素指定条件：

1. 在图中选择 "ElseIf" 元素。
2. 请重复前面的过程中对 If 元素执行的步骤，但输入 2 作为 "Number Literal" 的值。

单击以放大

在 Assign 元素中添加表达式

在此过程中，您将使用源代码编辑器和 BPEL 映射器向 "Assign1"、"Assign2" 和 "Assign3" 元素添加表达式。

将表达式添加到 "Assign1" 元素中：

1. 在图中选择 "Assign1" 元素。
2. 在“BPEL 映射器”窗口中的菜单栏上，选择“日期时间”> "Current Date"。
   "Current Date" 函数框会出现在映射窗格中。
3. 在 "Current Date" 函数框中，选择 "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."

您需要按照以下格式使用包含当前日期的 "todayIs" 变量："YYYY-MM-DD ZZ:ZZ"，其中，"YYYY" 是当前年份，"MM" 是月份，"DD" 是日期，"ZZ:ZZ" 为时区。

1. 在图中选择 "Assign2" 元素。
2. 在“BPEL 映射器”窗口中的菜单栏上，选择“字符串”> "Concat"，然后选择两次“字符串”> "Substring"。
   映射窗格中会出现三个函数框。为方便起见，请将两个 "Substring" 框拖到左侧，将 "Concat" 框拖到右侧。
3. 要通过 "todayIs" 变量构成只包含日期而不包含时区的字符串，请完成以下步骤：
   
   1. 在左侧树窗格中选择 "todayIs" 节点，然后将指针拖到第一个 Substring 函数框中的 "string" 参数。
   2. 在函数框中双击 "number"，然后键入 "1"。
      这是将要复制的 "todayIs" 字符串的起始位置。
   3. 在函数框中双击 "number?"，然后键入 "10"。
      这是将要复制的符号数。
4. 要通过 "todayIs" 变量构成只包含时区而不包含日期的字符串，请完成以下步骤：
   
   1. 在左侧树窗格中选择 "todayIs" 节点，然后将指针拖到第二个 Substring 函数框中的 "string" 参数。
   2. 在函数框中双击 "number"，然后键入 "11"。
      这是将要复制的 "todayIs" 字符串的起始位置。

   注意：这里 "number?" 不是 Substring 函数的必需参数：当不指定参数时，Substring 函数会将字符串从起始位置复制到字符串结束。

5. 要构成本部分开始时提及的输出 Concat 字符串，请完成以下步骤：
   
   1. 在“BPEL 映射器”窗口的左侧树窗格中，展开 "inputVar" 和 "inputType" 节点。
   2. 在左侧树窗格中选择 "paramA" 节点，然后将指针拖到 Concat 函数框中的 "string1" 参数。
      这样会复制输入参数中的字符串。
   3. 在 Concat 函数框中双击 "string2"，然后键入 "Today is"。
      这是为了构成用于输出的字符串，此字符串将会添加到输出字符串中。
   4. 在第一个 Substring 函数框中，选择 "return string" 参数，然后将指针拖到 Concat 函数框的 "string3"。
      这样会复制当前的日期而不包含时区。
   5. 在 Concat 函数框中双击 "string4"，然后键入 ".Time zone is"。
      此字符串将位于当前日期之后。
   6. 在第二个 Substring 函数框中，选择 "return string" 参数，然后将指针拖到 Concat 函数框的 "string5"。
      这样会复制时区而不包含当前日期。
   7. 在 Concat 函数框中双击 "string6"，然后键入 "."。
      此字符串会添加到时区之后。
   8. 在“BPEL 映射器”窗口的右侧树窗格中，展开 "outputVar" 和 "resultType" 节点。
   9. 在 Concat 函数框中，选择 "return string" 参数，然后将指针拖到“BPEL 映射器”窗口右侧树窗格中的 "paramA" 节点。
      这样会将 Concat 函数的结果复制到输出。
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."

返回页首