本文档介绍了如何将现有的 J2EE 企业应用程序导入到 NetBeans IDE 项目中。我们将通过导入 J2EE 1.4 SDK Samples 中包含的 cmpcustomer 示例应用程序来加以说明。
cmpcustomer 应用程序包含一个 src 文件夹(包含企业应用程序部署描述符)、一个 cmpcustomer-ejb 文件夹(包含 EJB 模块源)以及一个 cmpcustomer-war 文件夹(包含 Web 应用程序客户机源)。
cmpcustomer 样例源代码位于 Sun/AppServer/samples/ejb/cmp/apps/cmpcustomer 文件夹中。假如您没有 J2EE 1.4 SDK Samples,可以从 http://Java.sun.com/j2ee/1.4/download.Html 下载。请确保将样例提取到 Sun/AppServer/Samples 文件夹中。
入门指南
在开始之前,我们先预备好所有必需的软件并设置好环境。
安装软件
开始之前,需要在计算机中安装以下软件:
NetBeans IDE 4.1
Sun Java System (SJS) Application Server Platform Edition 8 2005Q1
Java Standard Development Kit (JDKTM) 1.4.2 版或 5.0 版
注册 Sun Java System Application Server
在使用 J2EE 项目之前,必须先注册 SJS Application Server 的实例。假如安装了 NetBeans IDE 4.1/SJS Application Server 包,则会自动注册本地应用服务器。
1 从主窗口中选择“工具”>“服务器治理器”。
2 单击“添加服务器”。选择 Sun Java Systems Application Server 8.1,并为此实例指定一个名称。然后单击“下一步”。
3 指定应用服务器的安装目录(例如 C:\Sun\Appserver),然后单击“下一步”。
4 从“位置”组合框中,选择应用服务器本地实例的位置。
5 (可选)输入治理员用户名和口令。假如不希望在 IDE 用户目录中存储用户名和口令,可以将这些字段保留为空。IDE 在每次需要此信息时会提示您输入。
注重:缺省的治理员口令是 adminadmin。
6 单击“运行环境”窗口,然后展开“服务器”节点。此时将列出 SJS Application Server。
7 右键单击应用服务器的节点并选择“启动/停止服务器”,然后单击“启动服务器”。服务器立即被启动。
导入整个企业应用程序
假如企业应用程序符合以下规则,则可以一次性导入整个应用程序:
遵循 Java BluePrints 对企业应用程序项目结构的建议。
您不希望使用现有的 Ant 生成脚本来生成企业应用程序的模块,则 IDE 会为每个模块创建生成脚本。
注重:有些旧版本的 cmpcustomer 示例与 BluePrints 不相符。假如 IDE 不答应将示例作为项目打开,请转至 http://java.sun.com/j2ee/1.4/download.html 下载最新版本的 J2EE 样例。
创建并配置项目
1 选择“文件”>“新建项目”(Ctrl-Shift-N)。
2 选择“企业”>“包含现有源的企业应用程序”。单击“下一步”。
3 在“位置”字段中,键入或找到包含企业应用程序的文件夹。此文件夹应包含企业应用程序的 src 文件夹,并且是各应用程序模块的顶层文件夹。在本示例中,应输入 cmpcustomer 文件夹。
4 将项目命名为 cmpcustomer(或指定任意名称),然后指定项目文件夹的位置。我们将此位置称为 NetBeans_projects。对于“包含现有源的企业应用程序”,不能在与源文件夹相同的位置创建项目文件夹。
5 选择项目的 J2EE 版本。此设置定义了 IDE 将使用哪一版本的 J2EE 规范来生成代码及维护部署描述符。
6 设置项目的目标应用服务器,然后单击“完成”。IDE 将为企业应用程序及其各个模块创建标准 IDE 项目。
注重:IDE 将显示一条警告,提示您检查 sun-application.XML 文件中的 context-root 元素。这是因为 IDE 不知道模块的 JAR 文件和 WAR 文件所使用的名称,因此为它们指定了其自身的名称。
7 展开 cmpcustomer 项目的“配置文件”节点,右键单击 sun-application.xml,然后选择“编辑”。
8 将 web-uri 元素更改为 cmpcustomer-war.war。保存并关闭文件。
设置项目类路径