在 NetBeans IDE 5.0 中导入 J2EE 应用程序

安装软件

开始之前，需要在计算机中安装以下软件：

• NetBeans IDE 5.0（下载）
• Sun Java^TM System Application Server Platform Edition 8.2（下载）
• Java Standard Development Kit (JDK^TM) 1.4.2 版（下载）或 5.0 版（下载）

注意：NetBeans IDE 5.0 还支持 Sun Java System Application Server 8.1。应用服务器的 8.1 版使用 PointBase 数据库服务器而不是 Apache Derby，但是导入项目的过程是相同的。

注册 Sun Java System Application Server

在使用 J2EE 项目之前，必须注册 Sun Java System Application Server 实例。如果安装了 NetBeans IDE 5.0/Sun Java System Application Server 包，则会自动注册本地应用服务器。

1. 从主窗口中选择 Tools > Server Manager。
2. 单击 Add Server。选择 Sun Java System Application Server，并为此实例指定一个名称。然后单击 Next。
3. 指定应用服务器的安装目录（例如，C:\Sun\Appserver）。
4. 将 Register Local Default Domain 单选按钮保持选中状态，然后选择一个域。
5. （可选）单击 Next，输入管理员用户名和口令。如果不希望在 IDE 用户目录中存储用户名和口令，可以将这些字段保持为空。IDE 在每次需要此信息时会提示您输入。
   注意：缺省管理员口令是 adminadmin。
• 有关 Sun Java System Application Server 的详细信息
6. 单击 Finish。
7. 单击 Runtime 窗口，然后展开 Servers 节点。将列出 Sun Java System Application Server。
8. 右键单击应用服务器的节点，然后选择 Start Server。

创建项目

1. 如果在 cmpcustomer 示例中已使用任何源根目录创建了某个项目，请右键单击该项目，然后选择 Delete Project。在 Delete Project 对话框中，确保未选定删除项目源的选项。
2. 选择 File > New Project (Ctrl-Shift-N)。
3. 选择 Enterprise > Enterprise Application with Existing Sources。单击 Next。
4. 在 Location 字段中，键入或找到包含企业应用程序的文件夹。此文件夹应包含企业应用程序的 src 文件夹，并且是各应用程序模块的顶层文件夹。在本示例中，应输入 samples/ejb/cmp/apps/cmpcustomer 文件夹。
5. 将项目命名为 cmpcustomer（或指定任意名称），然后指定项目文件夹的位置。我们将此位置称为 NetBeans_projects。对于包含现有源代码的企业应用程序，不能在与源文件夹相同的位置创建项目文件夹。
   • 有关项目文件夹的详细信息
6. 选择项目的 J2EE 版本。此设置定义了 IDE 将使用哪一版本的 J2EE 规范来生成代码及维护部署描述符。在本示例中，我们将保留 J2EE 版本号 J2EE 1.4。
7. 设置项目的目标应用服务器，然后单击 Finish。IDE 将为企业应用程序及其各个模块创建标准 IDE 项目。
   • 有关项目模板的详细信息

配置项目

在创建项目时，IDE 将显示一条警告，提示您检查 sun-application.xml 文件中的 context-root 元素。这是因为 IDE 无法识别模块 JAR 文件和 WAR 文件的名称，而为它们指定了其本身的名称。因此，IDE 将创建包含更正的 JAR 和 WAR 文件名称的新部署描述符。还会保存原始部署描述符。应使用新的部署描述符，但需要更改某些设置。

1. 在 application.xml 和 sun-application.xml 中，为 Web 模块设置正确的上下文根目录。双击 application.xml 并将 context-root 元素由 cmpcustomer-war 更改为 customer。然后，双击 sun-application.xml 以在可视编辑器中将其打开，展开 EAR 节点，然后选择 cmpcustomer-war.war 节点。将 Context Root 字段由 cmpcustomer-war 更改为 customer。
2. 在 cmpcustomer-ejb 项目中，展开 Configuration Files，双击 sun-ejb-jar.xml，然后将 Create Tables at Deploy 设置为 True。选择 File > Save All 以保存所做的更改。
3. Web 模块的 LocalStrings.properties 文件位于错误的位置。将该文件从 cmpcustomer-war/src/conf 文件夹移到 cmpcustomer-war/src/java 文件夹中。

设置项目类路径

由于企业应用程序的部署描述符不包含应用程序模块间的类路径关系的任何信息，因此您必须自己配置类路径。

1. 在 Projects 窗口中，展开 cmpcustomer-war 项目节点的 Libraries 节点。请注意，它仅列出了项目的目标 JDK 和应用服务器。
2. 右键单击 Libraries 节点，然后选择 Add Project。
3. 为 cmpcustomer-ejb 项目选择项目文件夹 (<NetBeans 项目>/cmpcustomer/cmpcustomer-ejb)，然后单击 OK。此时会将 EJB 模块的类添加到 Web 模块的类路径中。
   
   • 有关设置类路径的详细信息
   注意：必须在 NetBeans_projects 中选择 cmpcustomer-ejb 项目的项目文件夹，而不是在 samples 文件夹中选择 cmpcustomer-ejb 源文件夹。

配置数据库和 JDBC 资源

在部署 cmpcustomer 应用程序时，可以将该应用程序设置为创建所有数据库表。您只需指定创建表所在的 Derby 数据库。在 IDE 中注册 Sun Java System Application Server 8.2 时，会在 home 目录的 .netbeans-derby 文件夹中创建名为 sample 的预配置 Derby 数据库。可以使用此数据库作为目标数据库。

为使 EJB 模块能够访问此数据库，必须在服务器上为数据库创建连接池和数据库资源。可以在 EJB 模块项目中使用服务器资源文件执行此操作。

1. 右键单击 cmpcustomer-ejb 项目，然后选择 New > File/Folder。从 Sun Resources 类别中，选择 JDBC Connection Pool 模板，然后单击 Next。
2. 在 JDBC Connection Pool Name 字段中，键入 cmpcustomerPool。选择 Extract from Existing Connection 单选按钮，然后从组合框中选择 sample 数据库。单击 Next。
3. 键入 app 作为 Password 属性的值，然后单击 Finish。此时，连接池节点将出现在项目的 Server Resources 节点下。

现在，我们将创建连接到连接池的数据库资源。

1. 右键单击 cmpcustomer-ejb 项目，然后选择 New > File/Folder。从 Sun Resources 类别中，选择 JDBC Resource 模板，然后单击 Next。
2. 选择 Use Existing JDBC Connection Pool，然后从组合框中选择 cmpcustomerPool。
3. 在 JNDI Name 字段中键入 jdbc/cmpcustomer，然后单击 Finish。此时，资源节点将出现在项目的 Server Resources 节点下。

最后，我们必须对 EJB 模块进行配置，以便在查找数据库时使用正确的 JNDI 名称。

1. 展开 Configuration Files 节点并双击 sun-ejb-jar.xml。
2. 在 CMP Resource 部分的 JNDI Name 字段中，键入 jdbc/cmpcustomer。保存并关闭文件。

运行应用程序

1. 如果 cmpcustomer 项目不是主项目，请右键单击项目节点，然后选择 Set Main Project。
2. 选择 Run > Run Main Project。IDE 将为项目生成 EAR 文件，并将其部署到应用服务器中。

疑难解答

• IDE 不支持您完成 New Wizard，并提示选定的位置不包含结构符合 BluePrints 建议的应用程序。这可能是因为您使用了旧版的 cmpcustomer 示例。请转至 http://java.sun.com/j2ee/1.4/download.html 下载最新版本的 J2EE 样例。
• 试图创建或搜索客户时出现 EJBException。请通过选择 Tools > Derby Database > Start Derby Server 来确保 Derby 数据库服务器正在运行。
• 所有 JSP 页均无法正确显示文本。确保将 LocalStrings.properties 文件从 src/conf 文件夹移到 Web 应用程序的 src/java 文件夹中。
• 在尝试创建客户或搜索客户时，将出现以下错误：创建客户失败：javax.ejb.EJBException：事务终止；嵌套异常为：javax.transaction.RollbackException：事务标记为回滚。请检查您是否正确地为示例创建和配置了 JDBC 资源。此外，还要检查 cmpcustomerPool 连接池是否存在以及是否包含缺省口令。要查看连接池，请转至 Runtime 窗口，然后展开应用服务器的 JDBC > Connection Pools。要检查它是否包含口令，请双击 cmpcustomerPool，然后单击 Properties 的省略号按钮，并确保 Password 属性设置为 app。

创建项目

1. 如果在 cmpcustomer 示例中已使用任何源根目录创建了某个项目，请右键单击该项目，然后选择 Delete Project。在 Delete Project 对话框中，确保未选定删除项目源的选项。
2. 选择 File > New Project (Ctrl-Shift-N)。
3. 选择 Enterprise > EJB Module with Existing Sources。单击 Next。
4. 在 Location 字段中，键入或找到包含 EJB 模块源的文件夹。通常，此文件夹应包含 EJB 模块的 src 文件夹，但它也可以是任意文件夹。IDE 可以满足任何 EJB 模块结构的需要。在本示例中，应输入 samples/ejb/cmp/apps/cmpcustomer/cmpcustomer-ejb 文件夹。
5. 将项目命名为 cmpcustomer-ejb-standard（或指定任意名称），然后指定项目文件夹的位置。注意，不能使用 cmpcutomer-ejb 文件夹作为项目文件夹，因为它已包含了 build.xml，这会与 IDE 生成的 build.xml 发生冲突。
   • 有关项目文件夹的详细信息
6. 设置项目的目标应用服务器。
7. 选择项目的 J2EE 版本。此设置定义了 IDE 将使用哪一版本的 J2EE 规范来生成代码及维护部署描述符。
8. 单击 Next。在 Existing Source and Libraries 页中，可以配置较复杂的 EJB 模块项目。可以添加多个源代码目录，指定 conf 文件夹的位置（如果它不在通常的位置上），还可以指定库文件夹。创建项目时，库文件夹中的所有文件夹和 JAR 文件会添加到项目的类路径中。
   
9. 单击 Finish而不更改 Existing Source and Libraries 页中的任何设置。IDE 将创建该 EJB 模块项目。
   注意：如果要运行该模块，可能必须配置数据库和 JDBC 资源。

创建项目

1. 如果在 cmpcustomer 示例中已使用任何源根目录创建了某个项目，请右键单击该项目，然后选择 Delete Project。在 Delete Project 对话框中，确保未选定删除项目源的选项。
2. 选择 File > New Project (Ctrl-Shift-N)。
3. 选择 Enterprise > EJB Module with Existing Ant Script。单击 Next。
   
4. 键入或找到包含 EJB 模块源的文件夹。通常，此文件夹应包含 EJB 模块的 src 文件夹，但它也可以是任意文件夹。IDE 可以满足任何 EJB 模块结构的需要。在本示例中，应输入 samples/ejb/cmp/apps/cmpcustomer/cmpcustomer-ejb 文件夹。IDE 将自动填充生成脚本的名称。
   注意：cmpcustomer-ejb 模块的生成脚本将导入 Sun/AppServer/samples/ 目录中的标准 common-ant.xml 生成脚本。该生成脚本假定样例目录也位于 AppServer 目录中。如果单独下载了样例并将其安装在不同的位置上，IDE 将提示 build.xml 不是有效的生成脚本。在文本编辑器中打开生成脚本，并对以下行进行编辑，以指向 common-ant.xml 的正确位置：

   <!DOCTYPE project [ <!ENTITY include SYSTEM "../../../../../common-ant.xml"> ]>

5. 将项目命名为 cmpcustomer-ejb-freeform，并指定项目文件夹的位置。然后单击 Next。
   • 有关项目文件夹的详细信息

将 Ant 目标与 IDE 命令链接在一起

1. 在向导的 Build and Run 页中，指定 IDE 应为项目命令运行哪些目标。IDE 会为每项操作提供建议的目标。请为每项操作指定以下目标：
   • 生成项目：core
   • 清理项目：clean
   • 生成 Javadoc：javadocs
   • 运行项目：update
   • 测试项目：保持为空
   • 部署项目：update
2. 单击 Next。
   • 有关将命令链接到 Ant 目标的详细信息

配置源文件夹

1. 在向导的 EJB Sources 页中，指定包含模块部署描述符的文件夹。在本示例中，配置文件的文件夹为 cmpcustomer/cmpcustomer-ejb/src/conf。
2. 在 Server Resources Folder 字段中，可以指定一个包含 IDE 生成的所有服务器资源文件的文件夹。服务器资源文件是 XML 文件，IDE 将使用这些文件在 Sun Java System Application Server 中自动配置资源（如 JDBC 连接池和数据源）。
3. 在 Server Type 组合框中，选择 Sun Java System Application Server。
4. 在 J2EE Version 组合框中，选择 J2EE 1.4。此设置定义了 IDE 将使用哪一版本的 J2EE 规范来生成代码及维护部署描述符。
5. 单击 Next。
6. 在向导的 Source Packages 页中，可以添加其他源根目录，并对包根目录进行测试。由于本示例只有一个源根目录，因此不必在此页中进行任何配置。
7. 在 Source Level 组合框中，选择 JDK 1.4。此设置会通知 IDE 在代码完成和错误突出显示中使用 J2SE 平台的哪些类。它不会设置项目的目标 JDK。您必须在 Ant 脚本中设置目标 JDK。
   注意：IDE 将在其注册的所有 Java 平台中查找具有匹配版本号的平台，并使用此平台提供用于调试的 Javadoc 和源代码。要注册 Java 平台并指定平台的源代码和 Javadoc 位置，请选择 Tools > Platform Manager。
8. 单击 Finish。将在 Projects 窗口和 File 窗口中显示 cmpcustomer-ejb-freeform 项目。

配置项目类路径

在自由格式项目中，Ant 脚本将管理所有类路径设置。在 IDE 中，可以声明项目的类路径，以便与 Ant 脚本中定义的设置相匹配。这些设置用于为项目提供代码完成、错误突出显示以及重构功能。

对于所有自由格式的 EJB 模块项目，必须将本地 Sun Java System Application Server 安装中的 j2ee.jar 库添加到类路径上。

1. 在 Projects 窗口中，右键单击 cmpcustomer-ejb-freeform 项目节点，然后选择 Properties。
2. 在对话框的右面板中单击 Java Sources Classpath。单击 Add JAR/Folder。在应用服务器的安装文件夹中找到 lib 文件夹，选择 j2ee.jar，然后单击 Open。

配置项目输出

要设置项目间的依赖关系，IDE 需要了解生成输出以及 Javadoc 输出目录的名称和位置。应在项目的属性中声明这些内容。

1. 在 Projects 窗口中，右键单击 cmpcustomer-ejb-freeform 项目节点，然后选择 Build Project 以产生生成输出。
2. 右键单击 cmpcustomer-ejb-freeform 项目节点，然后选择 Generate Javadoc for Project 以生成 Javadoc 输出目录。
3. 右键单击 cmpcustomer-ejb-freeform 项目节点，然后选择 Properties。
4. 在对话框的右面板中单击 Output。指定各个生成输出及 Javadoc 输出目录，然后单击 Close。