主题：NetBeans和JBoss 结合使用入门指南

　　本文将展示如何结合使用 NetBeans 集成开发环境 (IDE) 和 JBoss 应用服务器。

　　Getting Started with JBoss 4.0 的第四章描述了如何安装、编译、部署及运行一个示例 J2EE 应用程序。本教程将对如何使用 NetBeans IDE 来执行那些步骤提供说明。

　　本教程介绍以下主题：

　　入门

　　安装软件

　　安装示例代码

　　注册 JBoss 应用服务器

　　创建项目

　　浏览源代码

　　构建和部署示例应用程序

　　调试示例应用程序

　　进一步研究

　　项目文件

　　映射 Ant 命令

　　项目类型

　　扩展 IDE

　　注意：本教程仅用于介绍。NetBeans IDE 可以用于构建使用各种技术(由 JBoss 应用服务器提供)的应用程序。包括 Java Management Extensions (JMX)、Enterprise Java Beans (EJBs) 和 web 服务。更多信息请参考进一步研究部分。

　　安装并设置就绪后，本示例可以在 30 分钟内构建。

　　入门

　　安装软件

　　开始之前，需要在计算机上安装如下软件：

　　NetBeans IDE 5.0，beta 版或更高版本(下载)。

　　JBoss Application Server v4(下载)。本教程是使用 JBoss 应用服务器 v4.0.2 开发的，应该也可以使用其他版本进行开发。

　　Java Standard Development Kit (JDKTM) version 1.4.2(下载)或 5.0(下载)。

　　安装示例代码

　　Getting Started with JBoss v4.0 使用 J2EE 教程中的 Duke 银行示例程序。因此，必须安装 J2EE 教程示例代码。

　　安装 J2EE 1.4 教程(下载)。解压缩归档文件将创建一个 j2eetutorial 文件夹。

　　从此页面下载 startguide40.zip (单击 JBoss AS Getting Started Guide 条目旁边的 Download 按钮)。startguide40.zip 文件包含 jbossj2ee-src.zip。jbossj2ee-src.zip 包含 J2EE 教程配合 JBoss 应用服务器使用所需的辅助源文件。将 jbossj2ee-src.zip 文件解压缩到 j2eetutorial 文件夹。

　　j2eetutorial/examples/bank/nbproject 文件夹包含本教程不需要的 NetBeans IDE 项目文件，实际上这些文件将引起冲突，因为这些文件未指定由 JBoss 提供的 Ant 脚本。因此请删除 j2eetutorial/examples/bank/nbproject 文件夹及其所有内容。

　　编辑 j2eetutorial/jboss-build.properties 并指定 JBoss 应用服务器的安装位置。这是解压缩 JBoss 应用服务器归档文件时创建的文件夹。例如：

　　jboss.home=C:/tools/jboss-4.0.2

　　注册 JBoss 应用服务器

　　在结合使用 JBoss 和 NetBeans IDE 之前，必须注册 JBoss 应用服务器的本地实例。

　　在 NetBeans IDE 中，从主窗口选择 Tools > Server Manager。

　　单击 Add Server。选择 JBoss Application Server 4.0，并为该服务器命名。然后单击 Next。

　　指定应用服务器本地实例的位置。然后单击 Next。

　　指定服务器域。本教程是使用 default 域开发。然后单击 Finish。

　　创建项目

　　NetBeans IDE 中的大部分工作是从项目开始的。在 NetBeans IDE 中创建项目时，定义了 Java 代码的类型和结构。IDE 的项目系统是基于 Ant 的，且 NetBeans IDE 可以创建和维护 Ant 构建脚本。另一方面，对于已具有 Ant 构建脚本的现有代码，NetBeans IDE 可以创建使用该构建脚本的项目。

　　选择 File > New Project(Ctrl-Shift-N 或 Macintosh 下的 Command-Shift-N)。在 Categories 下，选择 Web。在 Projects 下，选择 Web Application with Existing Ant Script。单击 Next。

　　指定 j2eetutorial/examples/bank 文件夹作为 Location。IDE 将使用在 j2eetutorial/examples/bank 文件夹中找到的 build.xml 文件来填充 Build Script 字段。对于本项目，将需要由 JBoss 提供的 Ant 构建脚本，因此单击 Build Script 字段旁边的 Browser 按钮，然后选择 jboss-build.xml 文件。

指定 JBossDukesBank 作为 Project Name。Project Location 的默认值就不错，因此不必进行修改。示例如下所示(单击可获得最大尺寸的图像)：

　　单击 Next 按钮。

　　稍后，在映射 Ant 命令部分您将了解更多关于映射 IDE 命令到 Ant 构建脚本中的目标的 IDE 功能。现在，仅需再次单击 Next 按钮，以向前越过 Build and Run actions。

　　指定 web 作为 Web Pages，并指定 /bank 作为 Context Path。示例如下所示：

　　单击 Next 按钮。

　　可以添加其他的源包文件夹，但是没必要，因此再次单击 Next 按钮以向前越过 Source Package Folders。

　　为了使用 IDE 更高级编辑功能(代码完成、重构等)，编辑器需要应用所使用的 .jar 文件的 Classpath 信息。有四个 .jar 文件随 JBoss 应用服务器一起安装，因此需要添加到 Java Source Classpath：

　　server/default/lib/jboss-j2ee.jar

　　server/default/lib/javax.servlet.jar

　　server/default/lib/javax.servlet.jsp.jar

　　client/jboss-jaxrpc.jar

　　使用 Add JAR/Folder 按钮将 .jar 文件添加到 Java Source Classpath;示例如下所示(单击可获得最大尺寸的图像)：

　　单击 Next 按钮。

　　如果需要支持 JSP 文件中的代码完成，可以添加其他的 .jar 文件，但是在本项目中没有必要。因此仅需单击 Finish 按钮。IDE 将创建项目并在 Projects 窗口中进行显示。示例如下所示：

　　浏览源代码

　　使用 NetBeans IDE 的优势之一就是具有一个提供语法高亮显示、代码完成、重构支持和许多其他功能的编辑器。可以使用 IDE 的编辑器来浏览 Duke 银行示例应用的源代码。

　　选择 Window > Navigator 显示 IDE 的 Navigator 窗口。

　　展开 JBossDukesBank 项目下的 src 节点。

　　展开 com.sun.ebank.web 包。

　　单击 Dispatcher.java 条目。请注意，Navigator 窗口如何进行更新以显示 Dispatcher 类的方法。

　　在 Navigator 窗口中，双击 doPost 条目。IDE 的编辑器会打开 Dispatcher.java 文件并显示 doPost 方法，如下所示(单击可获得最大尺寸的图像)：

　　花一些时间来浏览一下 Duke 银行示例应用中的其他源文件。有几个便利的特性使得浏览源代码更容易，包括：

　　源代码行数。选择 View > Show Line Numbers。

　　类层次指示器。doPost 方法第一行旁边的左边空白处的向上箭头表示这个方法重写了一个其他类的方法。将鼠标光标指向向上箭头可以发现更多信息。

　　超链接。在 doPost 方法中，有一个 AccountHistoryBean 类的参考。按下 Control 键(在 Macintosh 上，使用 Command 键)，然后将鼠标光标指向 AccountHistoryBean。编辑器将其颜色更改为蓝色并标有下划线，如下所示。标有下划线时单击 AccountHistoryBean 将打开 AccountHistoryBean.java 源文件。

　　向后/向前。在编辑器中的文件之间移动时，您可以像使用 web 浏览器一样进行导航。编辑器工具栏上的箭头按钮可用于向前或向后导航。也可以使用键盘快捷键，Alt-K 用于向后，Alt-L 用于向前。

　　构建和部署示例应用程序

　　jboss-build.xml Ant 脚本包含了准备、构建和部署示例应用程序的目标。因为 NetBeans IDE 的项目系统是基于 Ant 的，所以激活这些目标非常容易。

　　在　Getting Started with JBoss v4 的 　4.1.2 部分，告诉您要运行的第一个 Ant 目标是　compile。使用 NetBeans IDE 创建 JBossDukesBank 项目时，IDE 的 Build Project 命令被映射到 jboss-build.xml 中的 compile 目标。因此要激活 compile 目标，仅需右键单击 JBossDukesBank 项目并从上下文菜单中选择 Build Project。

　　在 IDE 底部将出现一个 Output 窗口，且其最后一行应以 BUILD SUCCESSFUL 开始。

继续使用 Getting Started with JBoss v4 中的 4.1.3 部分，您需要运行以下四个目标，按此顺序：package-ejb、package-web、package-client 和 assemble-app。NetBeans IDE 使上述操作非常简单(有关使用 Ant 的更多选项，请参见下面的映射 Ant 命令)。在 Projects 窗口中选择 jboss-build.xml 条目。IDE 的 Navigator 窗口将显示全部 Ant 目标。示例如下所示：

　　若要激活 Ant 目标，请右键单击 Navigator 窗口中的目标，然后从上下文菜单选择 Run Target。或者右键单击目标时不选择 Run Target，而选择 Create Shortcut 并创建一个工具栏按钮、菜单按钮或键盘快捷键。这样的话，您可以将目标集成到 IDE 中。不论选择使用哪种方法，请确保每次激活这四个目标中的一个目标：package-ejb、package-web、package-client 和 assemble-app。

　　Getting Started with JBoss v4 的 4.1.7 部分描述了设置与 JBossof 绑定的 Hypersonic 数据库。进行操作之前，请确保 JBoss 应用服务器正在运行。若要从 NetBeans IDE 中开始操作，请单击 Runtime 窗口的图标，然后展开 Servers 条目。您将在服务器列表中看到 JBoss 条目。如下面的示例所示。

　　如果应用服务器正在运行，在其名称旁边会有一个绿色箭头图标()，

　　如果 JBoss 应用服务器未运行，则右键单击其条目，然后选择 Start。

　　Getting Started with JBoss v4 的 4.1.7.1 部分描述了必须对 JBoss 应用服务器的 hsqldb-ds.xml 文件进行的更改。您可以使用 NetBeans IDE 进行那些更改。选择 File > Open File，然后导航到 JBoss 安装程序的 server/default/deploy 文件夹，该文件夹包含 hsqldb-ds.xml 文件。选择该文件，然后单击 Open 按钮。IDE 将在编辑器窗口中打开该文件。有两处需要更改。在文件的顶部，需要修改 connection-url 以使用 tcp 连接。在文件的底部，用于 tcp 连接的 mbean 需要取消注释。有关完整详细信息，请参考 4.1.7.1 部分。进行更改后，选择 File > Save。

　　激活这些 Ant 目标，按此顺序：db-create-table、db-insert 和 db-list。在 IDE 的 Output 窗口中，db-list 目标应显示数据，示例如下所示。

　　继续使用 Getting Started with JBoss v4 的 4.1.8 部分，下一步是部署示例应用程序的 .ear 文件。若要执行上述操作，您可以直接调用 deploy Ant 目标。或者，由于 IDE 的 Deploy Project 命令被映射到 deploy Ant 目标，您可以右键单击 JBossDukesBank 项目条目，然后从上下文菜单中选择 Redeploy Project。

　　在您的浏览器中，指定应用程序登录屏幕的 URL：http://localhost:8080/bank/main。请注意，如果您配置的 JBoss 应用服务器的端口号不是 8080，则使用配置的端口号。如下面的示例所示。

　　若要使用该应用，请指定 200 作为 Customer，j2ee 作为 Password。

　　Getting Started with JBoss v4 的 4.1.8 部分指导您调用的最后一个 Ant 目标是 run-client。run-client 目标启动一个独立的客户端应用程序。创建 JBossDukesBank 项目后，NetBeans IDE 将其 Run Project 命令映射到 run-client 目标，因此可以仅右键单击 JBossDukesBank，然后从上下文菜单中选择 Run Project 启动独立的客户端应用程序。客户端服务器启动后，选择其 Customer Admin > View Customer Information 选项，然后指定 200 作为 Customer ID。将显示用户的信息，如下例所示。

　　调试示例应用程序

　　使用 NetBeans IDE 的另一个优势是它提供了完整功能的调试器。

　　如果登录了示例基于浏览器的应用程序，则单击应用程序用户界面右上角的 Logoff 链接退出。如果正在运行独立的应用程序，则单击其右上角的 X 图标关闭应用程序。

在 NetBeans IDE 中，需要将要调试的 .jar 和 .war 文件添加到项目所创建的输出列表中。若要执行上述操作，请在 Projects 窗口中右键单击 JBossDukesBank 条目，然后从上下文菜单中选择 Properties。

　　选择 Output 类别，然后单击 Add JAR/Folder 按钮。

　　选择 jar 文件夹，然后选择 app-client.jar、bank-ejb.jar 和 web-client.war 文件。再单击 Open 按钮。

　　单击 Runtime 选项卡以查看已安装服务器的列表。右键单击 JBoss 应用服务器条目，然后选择 Stop。如下面的示例所示。

　　注意：在 NetBeans v5.0 的 beta 版本中，有一些配置错误，该步骤需要执行两次。如果 IDE 显示 timeout 错误消息，则取消错误对话框，然后重复执行该步骤。

　　在 Runtime 选项卡中，右键单击 JBoss 应用服务器条目，然后选择 Start in Debug Mode。

　　打开 Dispatcher.java，并将光标放在 doGet 方法上，以在设置 com.sun.ebank.web.Dispatcher 类的 doGet 方法中设置断点。然后选择 Run > Toggle Breakpoint。设置断点的快捷方式是单击要放置断点的行旁边的左边空白处。无论哪种方法，IDE 将以红色背景显示此行;示例如下所示(单击可获得最大尺寸的图像)。

　　选择 Run > Debug Main Project。由于本项目使用自己现有的 Ant 构建脚本，因此 NetBeans IDE 将其作为自由形式项目引用。正如所预料的，项目的 Ant 构建脚本不包含可用于启动 IDE 调试器的目标。因此，NetBeans IDE 建议创建适合的目标，所显示的对话框的示例如下所示。

　　NetBeans IDE 将打开两个编辑器窗口。一个用于 ide-targets.xml。该文件包含仅用于 IDE 的 Ant 目标。这使得 IDE 可以为您的项目添加 Ant 目标，而无需修改您的 Ant 脚本(在本项目中是 jboss-build.xml)。第二个编辑器窗口用于 debug.properties。修改 debug.properties 中的 jpda.address 和 client.url 条目，以匹配下面所示的值。

　　jpda.address=8787

　　client.url=http://localhost:8080/bank/main

　　将您的更改保存到 debug.properties，然后选择 Run > Debug Main Project。

　　IDE 调试器启动后，您的浏览器将自动设置到应用程序登录屏幕：http://localhost:8080/bank/main。通过指定 200 作为 Customer，j2ee 作为 Password 来登录应用程序。

　　单击应用程序的 Submit 按钮后，调试器将应用程序停止在先前在 servlet 中设置的断点处。示例如下所示(单击可获得最大尺寸的图像)：

　　花一些时间来试验调试器的功能。若要控制调试器，请从 Run 菜单选择命令。若要显示调试器窗口，请选择 Window > Debugging。完成调试后，请选择 Run > Finish Debugger Session。

　　进一步研究

　　项目文件

　　Projects 窗口仅显示了在常规基础上最可能进行修改的文件的高层逻辑视图。若要查看项目文件夹中的全部文件，请单击 Files 选项卡。作为示例，web.xml 文件位于 dd/web 文件夹中，如下列所示。

　　如果右键单击 web.xml 条目并选择 Open the IDE 将显示自定义部署描述符编辑器。

　　映射 Ant 命令

　　本教程描述了使用现有 Ant 构建脚本创建自由形式项目。为了让 NetBeans IDE 使用现有 Ant 构建脚本，必须将其本身的命令映射到该构建脚本的目标。通过右键单击项目并选择 Properties，您可以控制如何操作该映射。然后单击 Build and Run。如下面的示例所示。

　　项目模板

　　本教程中创建了 Web Application 项目。NetBeans IDE 支持很多其他项目模板。示例应用程序不仅由 web 组件构成：有 Enterprise Java Beans (EJBs) 和一个独立的应用客户端。NetBeans IDE 可为每种可交付使用组件的类型创建其他项目。作为示例，可创建一个 EJB Module with Existing Ant Script 项目。IDE 将提供一组重要的 EJB 相关功能，以 EJB 的逻辑视图开始，如下所示。

　　扩展 IDE

　　NetBeans IDE 提供了使用 JBoss 所需的全部标准功能。但是，如果有 IDE 不符合的特定要求，则可以利用 IDE 对创建扩展(称为模块)的全面支持。通过创建模块，您可以轻松增强 IDE 以提供其他 JBoss 功能。例如，可能要将 JBoss 的项目示例添加到 New Project 向导。或者，也许要为 JBoss 部署描述符的创建提供特殊的文件模板。在第一种情况下，将使用 Project Template 向导。在第二种情况下，将使用 Wizard 向导，如下所示(单击可获得最大尺寸的图像)。

　　这些 File Types 可用于模块项目：仅需选择 New > File/Folder。