NetBeans和JBoss团结利用入门指南
副标题#e#
本文将展示如何团结利用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
#p#副标题#e#
注册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 按钮。
#p#分页标题#e#
假如需要支持 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。
#p#分页标题#e#
在您的欣赏器中，指定应用措施登录屏幕的 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。如下面的示例所示。
项目模板
#p#分页标题#e#
本教程中建设了 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。
