本文将展示如何结合使用 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 目标。示例如下所示:

