Getting Started with JBoss 4.0 的第四章描述了如何安装、编译、部署及运行一个示例 J2EE 应用程序。本教程将对如何使用 NetBeans IDE 来执行那些步骤提供说明。因此,最好将本文档与 Getting Started with JBoss 4.0 的第四章结合学习。
在结合使用 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。
超链接。在 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。
选择 Run > Debug Main Project。由于本项目使用自己现有的 Ant 构建脚本,因此 NetBeans IDE 将其作为自由形式项目引用。正如所预料的,项目的 Ant 构建脚本不包含可用于启动 IDE 调试器的目标。因此,NetBeans IDE 建议创建适合的目标,所显示的对话框的示例如下所示。
单击 Generate 按钮。
NetBeans IDE 将打开两个编辑器窗口。一个用于 ide-targets.xml。该文件包含仅用于 IDE 的 Ant 目标。这使得 IDE 可以为您的项目添加 Ant 目标,而无需修改您的 Ant 脚本(在本项目中是 jboss-build.xml)。第二个编辑器窗口用于 debug.properties。修改 debug.properties 中的 jpda.address 和 client.url 条目,以匹配下面所示的值。
本教程描述了使用现有 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 向导,如下所示(单击可获得最大尺寸的图像)。