使用 NetBeans Enterprise Pack 在 BPEL 模块项目中进行重构

最新推荐文章于 2024-09-26 22:37:35 发布

有家客栈

最新推荐文章于 2024-09-26 22:37:35 发布

阅读量533

点赞数

文章标签： netbeans xml ide 图形活动语言

（源自：http://www.netbeans.org/kb/55/ep-refactoring_zh_CN.html）

使用 NetBeans Enterprise Pack 在 BPEL 模块项目中进行重构

最新更新日期：2006 年 10 月 23 日

本教程阐述了如何在 NetBeans Enterprise Pack 中进行重构。NetBeans IDE 中的 NetBeans Enterprise Pack 提供了 XML 架构、业务流程执行语言 (Business Process Execution Language, BPEL) 以及 Web 服务描述语言 (Web Services Description Language, WSDL) 源文件重构支持。您可以使用重构来重命名以及安全删除本地和全局组件。IDE 将确保在整个项目树中应用重命名或安全删除操作。这就意味着，您不必手动更改引用了。重构功能简化了对 XML 架构和 WSDL 文件所做的更改，并减少了不必要的重复。IDE 的重构功能将向您显示项目中受影响的部分，并对代码进行所有必要的更改。在本教程中，您将在 BPEL 模块项目中了解重构功能。

先决条件

本教程假定您具备了 NetBeans IDE 的一些基本知识或编程经验。

系统要求

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

本教程所需的软件

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

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

创建 SynchronousSample 项目

在本教程中，您将使用“同步 BPEL 流程”样例项目。

从 IDE 的主菜单中，选择“文件”>“新建项目”。
在“类别”列表中，展开“样例”节点，然后选择“面向服务的体系结构”节点。
在“项目”列表中，选择“同步 BPEL 流程”。
单击“下一步”。
接受缺省项目名称 SynchronousSample 和项目位置值，或者根据需要更改这些值。
单击“完成”。
现在，“项目”窗口会包含两个项目节点：一个是标记为 SynchronousSample 的 BPEL 模块项目节点，另一个是标记为 SynchronousSampleApplication 的复合应用程序项目节点。

返回页首

重命名 XML 架构组件

在“项目”窗口中，展开 "SynchronousSample" 项目节点和“流程文件”节点。
双击 "SynchronousSample.xsd" 节点。
IDE 将打开 XML 架构文件的“架构”视图。
在“架构”视图的第一列中，选择“元素”节点。
IDE 将在视图的第二列中显示 typeA 元素。
在第二列中，选择 "typeA" 节点，单击鼠标右键，然后选择“重构”>“重命名”。
将打开“重命名”对话框。
在“新建名称”字段中，键入 typeB。
确保选中了“预览所有更改”复选框，然后单击“下一步”。
“预览所有更改”复选框会指定您要在应用重构更改之前查看这些更改内容。
将在 IDE 底部打开“XML 重构”窗口。
注意：在执行下一步之前，请查阅下面的浏览“XML 重构”窗口中的信息。
在“XML 重构”窗口中，单击“执行重构”以执行重命名操作。
当重构完成后，typeA 就被重命名为 typeB，并且该架构组件的所有引用都进行了更改以反映新名称。

浏览“XML 重构”窗口

让我们浏览一下从“重构”菜单启动“重命名”操作后显示的“XML 重构”窗口。

单击以放大

请注意以下内容：

状态栏通知您找到了 2 个 typeA 元素使用实例。
窗口的树窗格显示了 typeA 元素的所有使用实例。
如果在树窗格中选择某个节点，则 IDE 将在图形窗格中突出显示对应的节点。
图形窗格以图形方式显示树窗格中的信息。
如果在图形窗格中选择某个节点，则 IDE 将在树窗格中突出显示对应的节点。
要在图形窗格中展开或折叠文件节点，请选择该节点，单击鼠标右键，然后从弹出式菜单中选择“折叠”或“展开”。
IDE 找到的 typeA 使用实例的文件列表包括了 SynchronousSample.wsdl 文件，因为它包含了对 typeA 元素的引用。

从“XML 重构”窗口导航至 XML 架构编辑器视图

您可以使用图形窗格中的右键单击弹出式菜单，导航至 XML 架构编辑器中的其他视图。

在“XML 重构”窗口的图形窗格中，选择一个“引用 "typeA"”节点，单击鼠标右键，然后选择“转至源”。
IDE 将在编辑器的“源”视图中打开 SynchronousSample.xsd 文件，并突出显示 typeA 元素块的第一行。
在“XML 重构”窗口的图形窗格中，选择 "typeA" 节点，单击鼠标右键，然后选择“转至”>“架构”。
SynchronousSample.xsd 文件的编辑器标签将变为活动标签，并在“架构”视图的第二列中突出显示 "typeA" 节点。

有效工作提示

您可以使用以下信息来缩放、平移和拖动“XML 重构”窗口的图形窗格中的图形。

缩小：在图形中单击鼠标右键，然后向上拖动。
放大：在图形中单击鼠标右键，然后向下拖动。
平移：单击并朝任意方向拖动。
拖动节点：单击并拖动节点。

如果已将节点拖到了显示区域以外，则可以使用以下任一方法将其拖回到显示区域内：

在节点的方向平移，直至在显示区域再次显示该节点为止。
缩小，直至在显示区域看到该节点为止。
单击“XML 重构”窗口工具栏中的“刷新”按钮。

返回页首

重命名 WSDL 组件

在“项目”窗口中，展开 "SynchronousSample" 项目节点和“流程文件”节点。
双击 "SynchronousSample.wsdl" 节点。
如果文件已在 IDE 中打开，则 SynchronousSample.wsdl 标签将变为编辑器中的活动标签。
如果未在 IDE 中打开该文件，则 IDE 将打开 WSDL 文件的 WSDL 编辑器的 "WSDL" 视图。
如果 "WSDL" 视图不是活动视图，请单击编辑器工具栏中的 "WSDL" 按钮。
在 "WSDL" 视图中，选择“消息”> "responseMessage" 节点下面的 "resultType" 节点。
右键单击选定的节点，然后选择“重构”>“重命名”。
将打开“重命名”对话框。
在“新建名称”字段中，键入 outputType。
将“预览所有更改”复选框保留为选中状态，然后单击“下一步”。
“预览所有更改”复选框会指定您要在应用重构更改之前查看这些更改内容。
将在 IDE 底部打开“XML 重构”窗口。

请注意，“XML 重构”窗口会显示 resultType 的使用实例，在本例中只显示了一个使用实例。
具有使用实例的文件列表还包括 SynchronousSample.bpel，该文件包含了对 resultType 消息的引用。
注意：浏览“XML 重构”窗口提供了有关“XML 重构”窗口的其他信息。
在“XML 重构”窗口中，单击“执行重构”以执行重命名操作。
当重构完成后，resultType 就被重命名为 outputType，并且该组件的所有引用都进行了更改以反映新名称。

返回页首

安全地删除组件

使用重构删除功能删除多个项目文件中具有使用实例的组件时，IDE 将在项目中查找该组件的所有使用实例，并预览显示此重构操作，即使您选择不预览更改也是如此。使用重构删除功能删除单个项目文件中具有使用实例的组件时，如果不预览重构操作，则无法删除该组件。

删除具有引用的组件

在此过程中，您将使用重构删除功能来了解以下情况：IDE 强制您检查项目的其他文件中引用的组件的重构更改。

如果在 IDE 中未打开 SynchronousSample.xsd 文件，请立即将其打开。
在“架构”视图的第一列中选择“元素”节点，在第二列中右键单击 "typeB" 节点，然后选择“重构”>“安全删除”。
将打开“安全删除”对话框。
清除“预览所有更改”复选框，然后单击“下一步”。
即使清除了“预览所有更改”复选框，“安全删除”对话框也会立即更新显示警告。
单击“查找使用实例”。
“XML 使用实例”窗口将显示 typeB 的所有使用实例，在本例中显示了 2 个使用实例，如状态栏所示。
这 2 个使用实例位于 SynchronousSample.wsdl 文件中。
单击“重新运行删除 typeB”。
将再次打开“安全删除”对话框。
在“安全删除”对话框中，单击“取消”。
注意：此时，会取消删除操作，因为您只是使用此元素来查看重构的撤消和重做功能。

删除没有引用的组件

在此过程中，您将创建一个没有引用的新架构组件，然后使用重构来删除该架构组件。

在 SynchronousSample.xsd 的“架构”视图的第一列中，选择“元素”节点，单击鼠标右键，然后从弹出式菜单中选择“添加元素”。
将打开“元素”对话框。
接受“元素”对话框中的缺省设置，然后单击“确定”。
现在，“架构”视图的第二列中包含了一个标记为 newElement 的元素节点。
在“架构”视图的第二列中，右键单击 "newElement" 节点，然后选择“重构”>“安全删除”。
将打开“安全删除”对话框。
清除“预览所有更改”复选框，然后单击“下一步”。
IDE 将执行重构并删除 newElement。

返回页首

撤消和重新执行重构操作

执行重构操作后，您可以撤消该操作。然后决定对撤消操作执行“撤消”，则可以执行重做操作。

注意：要撤消重构操作，您必须从弹出式菜单显示的“重构”菜单中调用该操作，而不是从 IDE 的“编辑”菜单中调用。

要撤消对 newElement 架构组件的安全删除操作，请在 SynchronousSample.xsd 的“架构”视图的第二列中右键单击 "typeB" 节点，然后选择“重构”>“撤消 [安全删除]”。
IDE 将取消以前从“重构”菜单中调用的安全删除操作并恢复 newElement。
在 SynchronousSample.xsd 的“架构”视图的第二列中，右键单击 "typeB" 节点，然后选择“重构”>“重命名”。
将打开“重命名”对话框。
在“新建名称”字段中，键入 typeA。
清除“预览所有更改”复选框，然后单击“下一步”。
IDE 会将 typeB 元素重命名为 typeA。
要撤消重构重命名操作，请在第二列中选择 "typeA" 节点，单击鼠标右键，然后选择“重构”>“撤消 [重命名]”。
IDE 将取消从“重构”菜单中调用的重命名操作，并将元素名称恢复为 typeB。
要验证最后一个撤消操作正确有效，请在“架构”视图的第二列中右键单击 "typeB" 节点，然后选择“查找使用实例”。
将打开“XML 使用实例”窗口。请注意，所有引用均正确地引用了 typeB。
在“XML 使用实例”窗口的树窗格中，双击 "inputType" 和 "outputType" 节点以在“源”视图中查看这些引用。