(转)《NetBeans和JBoss结合开发入门》（一）

renxiao2003

http://blogger.org.cn/blog/more.asp?name=goldenwang&id=9235
前两天翻译的，征得作者同意放在这儿。不过本人的英语算不上太好，有兴趣的人可以看看

原文：
《Using NetBeans with the JBoss Getting Started Guide》
作者：
Gregg Sporar

翻译：
mcw
注：翻译此文是本人兴趣所致，纯属个人行为，如果阅者发现错误，欢迎批评指正
此文将为你展示如何结合使用NetBeans集成开发环境（IDE）和JBoss应用服务器。它是
Getting Started with JBoss 4.0
（点击
这里
下载）（译者注：我这里有中文版（罗时飞译的），欢迎来电索取，也可以到
http://www.open-v.com/
下载）的姊妹篇。
《Getting Started with JBoss 4.0》的第四章介绍了如何安装、编译、部署以及运行一个简单的J2EE应用程序（Duke）。本指南将引导你用NetBeans完成那些步骤。因此，最好和《Getting Started with JBoss 4.0》的第四章结合使用。

本手册包括以下话题：
Ø         
入门
ü         
安装所需软件
ü         
安装示例代码
ü         
注册JBoss应用服务器
Ø         
创建项目
Ø         
浏览源代码
Ø         
构建并部署示例应用
Ø         
调试示例应用
Ø         
深度探索
ü         
工程文件
ü         
映射Ant命令
ü         
工程类型
ü         
扩展IDE
注意：本手册仅仅作为入门之用。NetBeans可以用来开发基于JBoss提供的各种技术的应用。包括Java Management Extensions(JMX),Enterprise Java Beans(EJBs),以及web services。参见深度探索部分，以获取更多介绍。

如果你已经安装了所需软件并且正确设置，示例可以在三分钟内创建
入门
安装所需软件
              开始之前，你需要安装这些软件：
l         NetBeans 5.0,bata版（
下载
）                                                                  
l         JBoss v4（
下载
），本手册是用4.0.2开发的，不过其他的版本应该也许。（译者注：我用JBoss4.0.3RC2在NetBeans里启动不了，没办法下了个4.0.2才搞定，外国人也说大话：D）
l         JDK1.4.2（
下载
）或者5.0（
下载
）

安装示例代码
《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-4.0.2(详见Getting Started with JBoss 4.0)
注册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，不必改变默认的项目位置。如下图所示（点击看大图）：

[/url]
点下一步
4.         在后面的
[url=mhtml:file://F:\Documents\翻译\Using%20NetBeans%20with%20the%20JBoss%20Getting%20Started%20Guide\Using%20NetBeans%20with%20the%20JBoss%20Getting%20Started%20Guide.mht#_映射Ant命令]映射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，如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/20051019221212516.PNG]
点下一步
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。如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/2005101922216139.PNG]
6.         花一些时间浏览Duke银行的其他原文件。有些便利的功能使得浏览源代码非常容易，包括：
file:///C:/DOCUME~1/wh/LOCALS~1/Temp/msohtml1/01/clip_image001.gif
         源代码行数：选择View—> Show Line Numbers
file:///C:/DOCUME~1/wh/LOCALS~1/Temp/msohtml1/01/clip_image001.gif
         类层次指示器：挨着doPost方法第一行左侧的页边空白处向上的箭头表示doPost overrides 了一个其他类的方法。鼠标停留在此箭头的上方会发现它overrides了谁
file:///C:/DOCUME~1/wh/LOCALS~1/Temp/msohtml1/01/clip_image001.gif
         超链接：doPost方法里涉及到AccountHistoryBean类。按下Control键（苹果机则按下Command键），然后把鼠标指向AccoutHistoryBean，编辑器将会改变它的颜色并加上下划线，如下图所示：

当AccountHistoryBean被加上下划线的时候点击它，将会打开AccountHistoryBean.java原文件
file:///C:/DOCUME~1/wh/LOCALS~1/Temp/msohtml1/01/clip_image001.gif
         向前/向后按钮：当你在编辑器里的文件之间移动的时候，你可以像在用web浏览器一样导航。编辑器工具栏的

按钮可以被用来向前或向后跳转。快捷键也行，Alt-K向后，Alt-L向前。
构建并部署示例应用
Ant脚本jboss-build.xml包含了准备、构建、部署示例应用的对象（targets）。既然NetBeans的项目系统是基于Ant的，调用这些对象(targets)非常容易。
1.         《Getting Started with JBoss v4》的
4.1.2
小节，告诉你要运行的第一个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》的
4.1.3
小节，你需要运行四个对象（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》的
4.1.7
小节，描述了怎样设置JBoss绑定的Hypersonic数据库。在设置之前请确保JBoss应用服务器已经启动。在NetBeans里，点击Runtime窗口，然后展开Servers节点，在服务器列比里你会看见JBoss节点。如下图所示：

如果应用服务器正在运行，在它的名字旁边会有一个绿色箭头（
[/url]
），如下所示：
[url=file:///C:/DOCUME~1/wh/LOCALS~1/Temp/msohtml1/01/clip_image018.gif]
如果JBoss没有启动，右击对应的条目选择Start（译者注：NetBeans和JBoss都是用Java写的，两个一块儿启动，内存小的机器可吃不消：Ｐ）
5.         《Getting Started with JBoss v4》的
4.1.7.1
小节还说必须改动JBoss的hsqldb-ds.xml文件。你可以用NetBeans来做这些改变。选择File—〉Open File，然后到JBoss安装目录的server/default/deploy文件夹，找到hsqldb-ds.xml文件，选择打开。IDE会在编辑器窗口打开它。有两个地方需要改动，顶端的connection-url需要改动以使用tcp连接，底部的用于tcp连接的mbean需要去掉注释。详细细节，参考
4.1.7.1
，改动完毕保存。
6.         按顺序调用这些Ant对象：db-create-table, db-insert, 以及db-list。db-list对象应该在IDE的Output窗口显示数据。如下图所示：

7.         《Getting Started with JBoss v4》的
４.1.8
小节里说，下一步是部署示例应用的.ear文件。你可以直接调用Ant对象来部署，或者，右击JBossDukesBank项目选择Redeploy Project，既然IDE部署项目命令已经映射到了Ant的部署对象
8.         在浏览器里，输入：
http://localhost:8080/bank/main
，打开应用程序的登录界面。注意，如果你配置的JBoss端口不是8080，用你配置的端口打开。如下图所示：

要使用这个应用程序，Customer ID：200， Password：j2ee。
9.         《Getting Started with JBoss v4》的
４.1.8
里你要调用的最后一个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文件。结果如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/2005101922407842.PNG]
  点击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将会以红色背景显示此行，如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/20051019224147355.PNG]
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=http://localhost:8080/bank/main
保存debug.properties，然后选择Run—〉Debug Main Project
10.     IDE的调试器启动后，你的浏览器将会自动打开并显示应用程序的登录界面：
http://localhost:8080/ban/main
。用Customer：200和Password：j2ee登录。
11.     点击此应用程序的提交按钮后，调试器会在先前设置的断点处终止应用程序。如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/20051019224932320.PNG]
12.     花一些时间试验一下调试器的其他功能。想操纵调试器，选择Run菜单里的命令；选择Window—〉Debugging，可以显示调试器窗口。当年完成调试后，选择Run—〉Finish Debugger Session。
深度探索
工程文件
Projects窗口仅仅显示了通常来说经常修改的文件的一个高层逻辑视图。像看一个项目的所有文件，点击Files栏。下图显示了dd/web文件夹里的web.xml

如果你右击web.xml选择打开，IDE将会显示一个客户部署描述符的编辑器。
映射Ant命令
本手册展示了如何用已经存在的Ant build脚本创建一个已经组织好（freeform）的的项目。为了使NetBeans使用已经存在的Ant build脚本，必须映射它自己的命令到Ant build脚本中的对象。你可以右击此项目，选择Properties，然后点击Build and Run，以控制映射方式。如下图所示：

工程类型
在本手册里，建立了一个Web应用。NetBeans还支持其他几种项目模板。示例的应用不仅包括web组件，还包括EJBs，以及一个独立的客户端应用。可以用NetBeans为每种类型的独立组件创建其他的项目。下图显示了一个用已存在的Ant build脚本创建的EJB模块项目，IDE会提供EJB相关功能的重要部分。启动一个EJBs的逻辑视图，如下所示：

扩展IDE
NetBeans提供了你集成JBoss工作的所有标准功能。如果你遇到IDE没有提供的特定的需求，你可以利用IDE对创建叫做模块的扩展的充分支持。例如，可能你想为JBoss添加样本项目以作为新项目的向导，或者，你想为JBoss的部署描述符提供一个特殊的文件模板。对于前者，你会用到项目模板向导，而后者，你会用到向导的向导，如下图所示（点击看大图）：
[/url]
[url=http://blogger.org.cn/blog/uploadfile/20051019225244739.PNG]
这些文件类型对于模块项目可用；仅需选择New—>File/Folder。关于扩展NetBeans的更多信息，参考
http://platform.netbeans.org/tutorials
（完） 如果你想再看一遍，请到
第一部分
或
第二部分
，也许你更想看看
E版



本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u/8463/showart_89721.html