一个好老好老的老程序员了。
全部博文（915）
分类： Java
2006-03-23 14:13:00
前两天翻译的，征得作者同意放在这儿。不过本人的英语算不上太好，有兴趣的人可以看看
原文：
作者：
翻译：
注：翻译此文是本人兴趣所致，纯属个人行为，如果阅者发现错误，欢迎批评指正
此文将为你展示如何结合使用NetBeans集成开发环境（IDE）和JBoss应用服务器。它是（点击下载）（译者注：我这里有中文版（罗时飞译的），欢迎来电索取，也可以到下载）的姊妹篇。
《Getting Started with JBoss 4.0》的第四章介绍了如何安装、编译、部署以及运行一个简单的J2EE应用程序（Duke）。本指南将引导你用NetBeans完成那些步骤。因此，最好和《Getting Started with JBoss 4.0》的第四章结合使用。
本手册包括以下话题：
Ø 入门
ü 安装所需软件
ü 安装示例代码
Ø 创建项目
Ø 浏览源代码
Ø 调试示例应用
Ø 深度探索
ü 工程文件
ü 映射Ant命令
ü 工程类型
ü 扩展IDE
注意：本手册仅仅作为入门之用。NetBeans可以用来开发基于JBoss提供的各种技术的应用。包括Java Management Extensions(JMX),Enterprise Java Beans(EJBs),以及web services。参见深度探索部分，以获取更多介绍。
如果你已经安装了所需软件并且正确设置，示例可以在三分钟内创建
开始之前，你需要安装这些软件：
l NetBeans 5.0,bata版（）
l JBoss v4（），本手册是用
l JDK
《Getting Started with JBoss 4.0》用了J2EE手册里Duke银行的例子，所以J2EE手册示例代码必须安装。
1. 安装J2EE 1.4手册（）。解压档案文件将会创建一个j2eetutorial文件夹。
2. 在下载startguide40.zip（点挨着JBoss AS Getting Started Guide的按钮）。startguide4.0.zip包括jbossj2ee-src.zip，而jbooj2ee-src.zip里面有让J2EE手册在JBoss上运行的必要文件。解压jbossj2ee-src.zip到j2eetutrial文件夹。
3. j2eetutorial/examples/bank/nbproject文件夹包含了NetBeans的工程文件，本手册不需要它们，而且它们会产生冲突，因为不符合JBoss提供的Ant脚本。所以删除j2eetutorial/examples/bank/nbproject文件夹以及其下所有文件
4. 编辑j2eeturorial/jboss-build.properies（解压jbooj2ee-src.zip时产生的文件）以指定JBoss的安装位置。例如：
jobss.home=c:/tools/jboss-
在你结合使用JBoss和NetBeans之前，必须先注册一个JBoss应用服务器的本地实例。
1. 在NetBeans，从主窗口选择Tools—〉ServerManager。
2. 点击Add Server，选择JBoss Application Server 4.0起一个你喜欢的名字，然后点击下一步。
3. 指定应用服务器本机实例的位置，点下一步。
4. 指定服务器域名，本手册使用默认域名开发，点完成。
在NetBeans里的大部分工作从一个项目开始。当你在NetBeans里创建一个项目的时候，你就定义了你的Java代码的类型与结构。NetBeans的项目系统是基于Ant的，NetBeans本身可以创建并维护Ant build脚本。对于已经具有Ant build脚本的代码，NetBeans可以用它的Ant build脚本创建一个项目。
1. 选择File—>New Project（Ctrl-Shift-N 或者 Command-Shift-N(苹果机)）。在Categories下选Web，Project下选Web Application with Existing Ant Script。点下一步
2. Location指定j2eetutorial/examplies/bank文件夹。IDE会用它在j2eetutorial/examplies/bank文件夹下发现的build.xml来填充Build Script文本框。对于此项目，你需要JBoss提供的Ant build脚本，因此点击挨着Build Script文本框的Browser按钮选择jboss-build.xml文件替代。
3. 项目名输入：JBossDukesBank，不必改变默认的项目位置。如下图所示（点击看大图）：
4. 在后面的映射Ant命令部分，你将会了解更多关于IDE映射IDE命令到Ant build脚本的里目标的能力。现在，仅需点击再次下一步越过Build and Run actions
5. Web Pages Folder指定web，Context Path 指定/bank，如下图所示：
点下一步
6. 源代码包文件夹应该已经被添加，但是不必要，所以点下一步以越过Source Pageage Folders
7. 为了使IDE的高级编辑功能奏效（如代码提示、重构等），编辑器需要被此应用所用的以.jar文件形式提供的Classpath信息。随JBoss应用服务器一起安装了四个.jar文件，因此需要添加Java Source Classpath如下：
server/default/lib/jboss-j2ee.jar
server/default/lib/javax.servlet.jar
server/default/lib/javax.servlet.jsp.jar
点击Add JAR/Folder按钮添加以上四个.jar到Java Source Classpath，如下图所示（点击看大图）：
点下一步
1. 如果需要支持对JSP的代码提示，可以添加附加的.jar文件，不过对这个项目没那个必要。因此只需点击完成。IDE将会创建工程并显示在Projects窗口里。如下图所示：
使用NetBeans的优势之一就是它有一个提供语法高亮、代码提示、重构以及许多其他功能的编辑器。你可以用这个编辑器浏览示例应用Duke银行的源代码。
1. 选择Window—>Navigator以显示IDE的导航窗口。
2. 展开JBossDukesBank项目下的src节点
3. 展开com.sun.ebank.web包
4. 点击Dispatcher.java，注意导航窗口怎样更新以显示来自Dispatcher类的方法
5. 在导航窗口里双击doPost，IDE的编辑器会打开Dispatcher.java文件并且显示doPost。如下图所示（点击看大图）：
6. 花一些时间浏览Duke银行的其他原文件。有些便利的功能使得浏览源代码非常容易，包括：
源代码行数：选择View—> Show Line Numbers
类层次指示器：挨着doPost方法第一行左侧的页边空白处向上的箭头表示doPost overrides 了一个其他类的方法。鼠标停留在此箭头的上方会发现它overrides了谁
超链接：doPost方法里涉及到AccountHistoryBean类。按下Control键（苹果机则按下Command键），然后把鼠标指向AccoutHistoryBean，编辑器将会改变它的颜色并加上下划线，如下图所示：
当AccountHistoryBean被加上下划线的时候点击它，将会打开AccountHistoryBean.java原文件
向前/向后按钮：当你在编辑器里的文件之间移动的时候，你可以像在用web浏览器一样导航。编辑器工具栏的
按钮可以被用来向前或向后跳转。快捷键也行，Alt-K向后，Alt-L向前。
Ant脚本jboss-build.xml包含了准备、构建、部署示例应用的对象（targets）。既然NetBeans的项目系统是基于Ant的，调用这些对象(targets)非常容易。
1. 《Getting Started with JBoss v4》的小节，告诉你要运行的第一个Ant对象（target）是compile。当你用NetBeans创建JBossDukesBank项目的时候，IDE的Build Project command已经被映射到并编译(compile)了jboss-build.xml里的对象（target）。所以要调用编译对象（compile target），只需右键单击JBossDukesBank项目，在弹出菜单里选择构建项目（Build Project）
2. IDE底部会打开一个Output窗口，在它的最后一行应该以BUILD SUCCESSFUL开头
3. 《Getting Started with JBoss v4》的小节，你需要运行四个对象（targets），按顺序依次是：package-ejb, package-web, package-client, 以及 assemble-app。NetBeans使这变得非常容易（使用Ant的更多选择，参见下面的映射Ant命令）。选择Projects窗口里的jboss-build.xml。IDE的导航窗口将会显示所有的Ant对象（targets）。如下图所示：
想调用一个Ant对象，在导航窗口里右键点击它，在弹出菜单里选Run Target。你也可以在弹出菜单里选择Create Shortcut以创建一个工具栏按钮、菜单项或者快捷键。如果那样的话，你可以把此对象集成到IDE。不管你选择哪种方法，必须按顺序调用这四个对象：package-ejb, page-web, package-client, assemble-app
4. 《Getting Started with JBoss v4》的小节，描述了怎样设置JBoss绑定的Hypersonic数据库。在设置之前请确保JBoss应用服务器已经启动。在NetBeans里，点击Runtime窗口，然后展开Servers节点，在服务器列比里你会看见JBoss节点。如下图所示：
如果应用服务器正在运行，在它的名字旁边会有一个绿色箭头（
如果JBoss没有启动，右击对应的条目选择Start（译者注：NetBeans和JBoss都是用Java写的，两个一块儿启动，内存小的机器可吃不消：Ｐ）
5. 《Getting Started with JBoss v4》的小节还说必须改动JBoss的hsqldb-ds.xml文件。你可以用NetBeans来做这些改变。选择File—〉Open File，然后到JBoss安装目录的server/default/deploy文件夹，找到hsqldb-ds.xml文件，选择打开。IDE会在编辑器窗口打开它。有两个地方需要改动，顶端的connection-url需要改动以使用tcp连接，底部的用于tcp连接的mbean需要去掉注释。详细细节，参考，改动完毕保存。
6. 按顺序调用这些Ant对象：db-create-table, db-insert, 以及db-list。db-list对象应该在IDE的Output窗口显示数据。如下图所示：
7. 《Getting Started with JBoss v4》的小节里说，下一步是部署示例应用的.ear文件。你可以直接调用Ant对象来部署，或者，右击JBossDukesBank项目选择Redeploy Project，既然IDE部署项目命令已经映射到了Ant的部署对象
8. 在浏览器里，输入：，打开应用程序的登录界面。注意，如果你配置的JBoss端口不是8080，用你配置的端口打开。如下图所示：
要使用这个应用程序，Customer ID：200， Password：j2ee。
9. 《Getting Started with JBoss v4》的里你要调用的最后一个Ant对象是run-client。run-client对象启动一个独立的客户端应用程序。当你创建JBossDukesBank项目的时候，NetBEans已经映射它的Run Project command到run-client对象了，所以你只需右击JBossDukesBank然后选择Run Project以启动这个独立的客户端应用程序。当客户端应用程序启动之后，选择Customer Admin—〉View Customer Information，Customer ID为200，顾客的信息将会显示。如下所示：
NetBeans的优点之一就是它提供了一个功能丰富的调试器。
1. 如果你已经登录了此示例基于浏览器的应用，点击右上角的Logoff链接退出。如果你运行的时独立的程序，点击右上角的X图标关闭此程序。
2. 在NetBeans里，如果你想调试项目创建的输出列表，需要添加.jar和.war文件。右键点击Projects窗口的JBossDukesBank条目，选择Properties
3. 选择Output目录，然后点击Add JAR/Folder按钮
4. 选择jar文件夹，然后添加app-client.jar, bank-ejb.jar, web-client.war文件。结果如下图所示（点击看大图）：
点击OK按钮
5. 点击Runtime栏，你可以看到服务器列表。右键点击JBoss选择Stop，如下图所示：
注意：在NetBeans5.0 beta版里有一个配置上bug，你需要重复一次这个步骤。如果IDE显示timeout的错误消息，就关闭错误对话框，然后重复此步骤。
6. 在Runtime栏里右击JBoss条目，选择Start in Debug Mode
7. 为sun.ebank.web.Dispatcher类的doGet方法设置一个断点。打开Dispatcher.java，鼠标放在doGet方法的第一行，然后选择Run—>Toggle Breakpoint。设置断点的便捷方法是，在你想设置断点的地方页边单击。不论哪种方法，IDE将会以红色背景显示此行，如下图所示（点击看大图）：
8. 选择Run—〉Debug Main Project。因为此项目是用已存在的Ant脚本创建的，NetBeans把它看作一个任意的（freeform）项目。如你所料，项目的Ant脚本不包含被用来启动IDE的调试器的对象。因此，NetBeans建议创建一个合适的对象。如下图所示：
点击Generate按钮
9. NetBeans打开两个编辑器窗口。第一个是ide-targets.xml。此文件包含仅被IDE使用的Ant对象。它允许IDE为你的项目添加Ant对象而不用修改你自己的Ant脚本（在这个项目里是jboss-build.xml）。第二个编辑器窗口是debug.properties，修改它里面的jpda.address以及client.url，以使它们匹配下面所示的值：
jpda.address=8787client.url=
保存debug.properties，然后选择Run—〉Debug Main Project
10. IDE的调试器启动后，你的浏览器将会自动打开并显示应用程序的登录界面：。用Customer：200和Password：j2ee登录。
11. 点击此应用程序的提交按钮后，调试器会在先前设置的断点处终止应用程序。如下图所示（点击看大图）：
12. 花一些时间试验一下调试器的其他功能。想操纵调试器，选择Run菜单里的命令；选择Window—〉Debugging，可以显示调试器窗口。当年完成调试后，选择Run—〉Finish Debugger Session。
Projects窗口仅仅显示了通常来说经常修改的文件的一个高层逻辑视图。像看一个项目的所有文件，点击Files栏。下图显示了dd/web文件夹里的web.xml
如果你右击web.xml选择打开，IDE将会显示一个客户部署描述符的编辑器。
本手册展示了如何用已经存在的Ant build脚本创建一个已经组织好（freeform）的的项目。为了使NetBeans使用已经存在的Ant build脚本，必须映射它自己的命令到Ant build脚本中的对象。你可以右击此项目，选择Properties，然后点击Build and Run，以控制映射方式。如下图所示：
在本手册里，建立了一个Web应用。NetBeans还支持其他几种项目模板。示例的应用不仅包括web组件，还包括EJBs，以及一个独立的客户端应用。可以用NetBeans为每种类型的独立组件创建其他的项目。下图显示了一个用已存在的Ant build脚本创建的EJB模块项目，IDE会提供EJB相关功能的重要部分。启动一个EJBs的逻辑视图，如下所示：
NetBeans提供了你集成JBoss工作的所有标准功能。如果你遇到IDE没有提供的特定的需求，你可以利用IDE对创建叫做模块的扩展的充分支持。例如，可能你想为JBoss添加样本项目以作为新项目的向导，或者，你想为JBoss的部署描述符提供一个特殊的文件模板。对于前者，你会用到项目模板向导，而后者，你会用到向导的向导，如下图所示（点击看大图）：
这些文件类型对于模块项目可用；仅需选择New—>File/Folder。关于扩展NetBeans的更多信息，参考
