本文将展示如何结合使用 NetBeans 集成开发环境 (IDE) 和 JBoss 应用服务器
Getting Started with JBoss 的第四章描述了如何安装编译部署及运行一个示例 JEE 应用程序本教程将对如何使用 NetBeans IDE 来执行那些步骤提供说明
本教程介绍以下主题
安装软件
安装示例代码
注册 JBoss 应用服务器
创建项目
浏览源代码
构建和部署示例应用程序
调试示例应用程序
项目文件
映射 Ant 命令
项目类型
扩展 IDE
注意本教程仅用于介绍NetBeans IDE 可以用于构建使用各种技术(由 JBoss 应用服务器提供)的应用程序包括 Java Management Extensions (JMX)Enterprise Java Beans (EJBs) 和 web 服务更多信息请参考进一步研究部分
安装并设置就绪后本示例可以在 分钟内构建
安装软件
开始之前需要在计算机上安装如下软件
NetBeans IDE beta 版或更高版本(下载)
JBoss Application Server v(下载)本教程是使用 JBoss 应用服务器 v 开发的应该也可以使用其他版本进行开发
Java Standard Development Kit (JDKTM) version (下载)或 (下载)
安装示例代码
Getting Started with JBoss v 使用 JEE 教程中的 Duke 银行示例程序因此必须安装 JEE 教程示例代码
安装 JEE 教程(下载)解压缩归档文件将创建一个 jeetutorial 文件夹
从此页面下载 startguidezip (单击 JBoss AS Getting Started Guide 条目旁边的 Download 按钮)startguidezip 文件包含 jbossjeesrczipjbossjeesrczip 包含 JEE 教程配合 JBoss 应用服务器使用所需的辅助源文件将 jbossjeesrczip 文件解压缩到 jeetutorial 文件夹
jeetutorial/examples/bank/nbproject 文件夹包含本教程不需要的 NetBeans IDE 项目文件实际上这些文件将引起沖突因为这些文件未指定由 JBoss 提供的 Ant 脚本因此请删除 jeetutorial/examples/bank/nbproject 文件夹及其所有内容
编辑 jeetutorial/jbossbuildproperties 并指定 JBoss 应用服务器的安装位置这是解压缩 JBoss 应用服务器归档文件时创建的文件夹例如
jbosshome=C:/tools/jboss
注册 JBoss 应用服务器
在结合使用 JBoss 和 NetBeans IDE 之前必须注册 JBoss 应用服务器的本地实例
在 NetBeans IDE 中从主窗口选择 Tools > Server Manager
单击 Add Server选择 JBoss Application Server 并为该服务器命名然后单击 Next
指定应用服务器本地实例的位置然后单击 Next
指定服务器域本教程是使用 default 域开发然后单击 Finish
创建项目
NetBeans IDE 中的大部分工作是从项目开始的在 NetBeans IDE 中创建项目时定义了 Java 代码的类型和结构IDE 的项目系统是基于 Ant 的且 NetBeans IDE 可以创建和维护 Ant 构建脚本另一方面对于已具有 Ant 构建脚本的现有代码NetBeans IDE 可以创建使用该构建脚本的项目
选择 File > New Project(CtrlShiftN 或 Macintosh 下的 CommandShiftN)在 Categories 下选择 Web在 Projects 下选择 Web Application with Existing Ant Script单击 Next
指定 jeetutorial/examples/bank 文件夹作为 LocationIDE 将使用在 jeetutorial/examples/bank 文件夹中找到的 buildxml 文件来填充 Build Script 字段对于本项目将需要由 JBoss 提供的 Ant 构建脚本因此单击 Build Script 字段旁边的 Browser 按钮然后选择 jbossbuildxml 文件
指定 JBossDukesBank 作为 Project NameProject 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/jbossjeejar
server/default/lib/javaxservletjar
server/default/lib/javaxservletjspjar
client/jbossjaxrpcjar
使用 Add JAR/Folder 按钮将 jar 文件添加到 Java Source Classpath;示例如下所示(单击可获得最大尺寸的图像)
单击 Next 按钮
如果需要支持 JSP 文件中的代码完成可以添加其他的 jar 文件但是在本项目中没有必要因此仅需单击 Finish 按钮IDE 将创建项目并在 Projects 窗口中进行显示示例如下所示
浏览源代码
使用 NetBeans IDE 的优势之一就是具有一个提供语法高亮显示代码完成重构支持和许多其他功能的编辑器可以使用 IDE 的编辑器来浏览 Duke 银行示例应用的源代码
选择 Window > Navigator 显示 IDE 的 Navigator 窗口
展开 JBossDukesBank 项目下的 src 节点
展开 comsunebankweb 包
单击 Dispatcherjava 条目请注意Navigator 窗口如何进行更新以显示 Dispatcher 类的方法
在 Navigator 窗口中双击 doPost 条目IDE 的编辑器会打开 Dispatcherjava 文件并显示 doPost 方法如下所示(单击可获得最大尺寸的图像)
花一些时间来浏览一下 Duke 银行示例应用中的其他源文件有几个便利的特性使得浏览源代码更容易包括
源代码行数选择 View > Show Line Numbers
类层次指示器doPost 方法第一行旁边的左边空白处的向上箭头表示这个方法重写了一个其他类的方法将鼠标光标指向向上箭头可以发现更多信息
超链接在 doPost 方法中有一个 AccountHistoryBean 类的参考按下 Control 键(在 Macintosh 上使用 Command 键)然后将鼠标光标指向 AccountHistoryBean编辑器将其颜色更改为蓝色并标有下划线如下所示标有下划线时单击 AccountHistoryBean 将打开 AccountHistoryBeanjava 源文件
向后/向前在编辑器中的文件之间移动时您可以像使用 web 浏览器一样进行导航编辑器工具栏上的箭头按钮可用于向前或向后导航也可以使用键盘快捷键AltK 用于向后AltL 用于向前
构建和部署示例应用程序
jbossbuildxml Ant 脚本包含了准备构建和部署示例应用程序的目标因为 NetBeans IDE 的项目系统是基于 Ant 的所以激活这些目标非常容易
在Getting Started with JBoss v 的 部分告诉您要运行的第一个 Ant 目标是compile使用 NetBeans IDE 创建 JBossDukesBank 项目时IDE 的 Build Project 命令被映射到 jbossbuildxml 中的 compile 目标因此要激活 compile 目标仅需右键单击 JBossDukesBank 项目并从上下文菜单中选择 Build Project
在 IDE 底部将出现一个 Output 窗口且其最后一行应以 BUILD SUCCESSFUL 开始
继续使用 Getting Started with JBoss v 中的 部分您需要运行以下四个目标按此顺序packageejbpackagewebpackageclient 和 assembleappNetBeans IDE 使上述操作非常简单(有关使用 Ant 的更多选项请参见下面的映射 Ant 命令)在 Projects 窗口中选择 jbossbuildxml 条目IDE 的 Navigator 窗口将显示全部 Ant 目标示例如下所示
若要激活 Ant 目标请右键单击 Navigator 窗口中的目标然后从上下文菜单选择 Run Target或者右键单击目标时不选择 Run Target而选择 Create Shortcut 并创建一个工具栏按钮菜单按钮或键盘快捷键这样的话您可以将目标集成到 IDE 中不论选择使用哪种方法请确保每次激活这四个目标中的一个目标packageejbpackagewebpackageclient 和 assembleapp
Getting Started with JBoss v 的 部分描述了设置与 JBossof 绑定的 Hypersonic 数据库进行操作之前请确保 JBoss 应用服务器正在运行若要从 NetBeans IDE 中开始操作请单击 Runtime 窗口的图标然后展开 Servers 条目您将在服务器列表中看到 JBoss 条目如下面的示例所示
如果应用服务器正在运行在其名称旁边会有一个绿色箭头图标()
如果 JBoss 应用服务器未运行则右键单击其条目然后选择 Start
Getting Started with JBoss v 的 部分描述了必须对 JBoss 应用服务器的 hsqldbdsxml 文件进行的更改您可以使用 NetBeans IDE 进行那些更改选择 File > Open File然后导航到 JBoss 安装程序的 server/default/deploy 文件夹该文件夹包含 hsqldbdsxml 文件选择该文件然后单击 Open 按钮IDE 将在编辑器窗口中打开该文件有两处需要更改在文件的顶部需要修改 connectionurl 以使用 tcp 连接在文件的底部用于 tcp 连接的 mbean 需要取消注释有关完整详细信息请参考 部分进行更改后选择 File > Save
激活这些 Ant 目标按此顺序dbcreatetabledbinsert 和 dblist在 IDE 的 Output 窗口中dblist 目标应显示数据示例如下所示
继续使用 Getting Started with JBoss v 的 部分下一步是部署示例应用程序的 ear 文件若要执行上述操作您可以直接调用 deploy Ant 目标或者由于 IDE 的 Deploy Project 命令被映射到 deploy Ant 目标您可以右键单击 JBossDukesBank 项目条目然后从上下文菜单中选择 Redeploy Project
在您的浏览器中指定应用程序登录屏幕的 //localhost:/bank/main请注意如果您配置的 JBoss 应用服务器的端口号不是 则使用配置的端口号如下面的示例所示
若要使用该应用请指定 作为 Customerjee 作为 Password
Getting Started with JBoss v 的 部分指导您调用的最后一个 Ant 目标是 runclientrunclient 目标启动一个独立的客户端应用程序创建 JBossDukesBank 项目后NetBeans IDE 将其 Run Project 命令映射到 runclient 目标因此可以仅右键单击 JBossDukesBank然后从上下文菜单中选择 Run Project 启动独立的客户端应用程序客户端服务器启动后选择其 Customer Admin > View Customer Information 选项然后指定 作为 Customer ID将显示用户的信息如下例所示
调试示例应用程序
使用 NetBeans IDE 的另一个优势是它提供了完整功能的调试器
如果登录了示例基于浏览器的应用程序则单击应用程序用户界面右上角的 Logoff 链接退出如果正在运行独立的应用程序则单击其右上角的 X 图标关闭应用程序
在 NetBeans IDE 中需要将要调试的 jar 和 war 文件添加到项目所创建的输出列表中若要执行上述操作请在 Projects 窗口中右键单击 JBossDukesBank 条目然后从上下文菜单中选择 Properties
选择 Output 类别然后单击 Add JAR/Folder 按钮
选择 jar 文件夹然后选择 appclientjarbankejbjar 和 webclientwar 文件再单击 Open 按钮
单击 Runtime 选项卡以查看已安装服务器的列表右键单击 JBoss 应用服务器条目然后选择 Stop如下面的示例所示
注意在 NetBeans v 的 beta 版本中有一些配置错误该步骤需要执行两次如果 IDE 显示 timeout 错误消息则取消错误对话框然后重复执行该步骤
在 Runtime 选项卡中右键单击 JBoss 应用服务器条目然后选择 Start in Debug Mode
打开 Dispatcherjava并将光标放在 doGet 方法上以在设置 comsunebankwebDispatcher 类的 doGet 方法中设置断点然后选择 Run > Toggle Breakpoint设置断点的快捷方式是单击要放置断点的行旁边的左边空白处无论哪种方法IDE 将以红色背景显示此行;示例如下所示(单击可获得最大尺寸的图像)
选择 Run > Debug Main Project由于本项目使用自己现有的 Ant 构建脚本因此 NetBeans IDE 将其作为自由形式项目引用正如所预料的项目的 Ant 构建脚本不包含可用于启动 IDE 调试器的目标因此NetBeans IDE 建议创建适合的目标所显示的对话框的示例如下所示
NetBeans IDE 将打开两个编辑器窗口一个用于 idetargetsxml该文件包含仅用于 IDE 的 Ant 目标这使得 IDE 可以为您的项目添加 Ant 目标而无需修改您的 Ant 脚本(在本项目中是 jbossbuildxml)第二个编辑器窗口用于 debugproperties修改 debugproperties 中的 jpdaaddress 和 clienturl 条目以匹配下面所示的值
jpdaaddress=
//localhost:/bank/main
将您的更改保存到 debugproperties然后选择 Run > Debug Main Project
IDE 调试器启动后您的浏览器将自动设置到应用程序登录屏幕//localhost:/bank/main通过指定 作为 Customerjee 作为 Password 来登录应用程序
单击应用程序的 Submit 按钮后调试器将应用程序停止在先前在 servlet 中设置的断点处示例如下所示(单击可获得最大尺寸的图像)
花一些时间来试验调试器的功能若要控制调试器请从 Run 菜单选择命令若要显示调试器窗口请选择 Window > Debugging完成调试后请选择 Run > Finish Debugger Session
项目文件
Projects 窗口仅显示了在常规基础上最可能进行修改的文件的高层逻辑视图若要查看项目文件夹中的全部文件请单击 Files 选项卡作为示例webxml 文件位于 dd/web 文件夹中如下列所示
如果右键单击 webxml 条目并选择 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
