使用 NetBeans IDE 5.0 开发 J2EE 应用程序的快速入门指南-技术开发专区

使用 NetBeans IDE 5.0 开发 J2EE 应用程序的快速入门指南

作者：佚名编辑：阿雪 2007-05-29 14:17

【IT168技术文档】

入门指南

在开始之前，必须确保安装了所需的所有软件。此外，还必须配置 Derby 数据库，并填充用来生成 CMP 实体 Bean 的数据库表。

设置环境

首先，需要在计算机上安装 Sun Java System Application Server Platform Edition 8.2（下载）。

注意：如果在 JDK 5.0 中运行 IDE，则应用服务器还需要使用 JDK 5.0 中的虚拟机。要设置 IDE 使用的 JDK，请打开 IDE_INSTALL_DIR/etc/netbeans.conf，并在 netbeans_jdkhome 属性中输入 JDK 的路径。要设置应用服务器使用的 JDK，请编辑 AS_INSTALL_DIR/config/asenv(.bat) 文件并更改 AS_JAVA 环境变量。

安装应用服务器后，需要在 NetBeans IDE 中注册该服务器。请注意，如果下载和安装的 NetBeans IDE 版本与应用服务器捆绑在一起，则不必执行此步骤。IDE 知道捆绑的应用服务器的位置。

转到 NETBEANS_INSTALL_DIR/bin 目录并运行 netbeans 命令以打开 NetBeans IDE 5.0。如果 java 不在 PATH 变量中，则在命令行中使用 --jdkhome /path/to/jdk 开关来启动 IDE，或将 netbeans_jdkhome="/path/to/jdk" 一行添加到 NETBEANS_INSTALL_DIR/etc/netbeans.conf 文件中。
在 IDE 中，从主窗口选择“工具”>“服务器管理器”。
单击“添加服务器”。选择 "Sun Java System Application Server"，并为此实例指定一个名称。然后单击“下一步”。
指定应用服务器的安装目录（例如，C:\Sun\Appserver）。
将“注册本地缺省域”单选按钮保持选中状态，然后选择一个域。
（可选）单击“下一步”，输入管理员用户名和口令。如果不希望在 IDE 用户目录中存储用户名和口令，可以将这些字段保留为空。IDE 在每次需要此信息时会提示您输入。
注意：缺省管理员口令是 adminadmin。
单击“完成”。IDE 将注册该服务器，并在“运行环境”窗口的“服务器”节点下面列出该服务器。

最后，启动应用服务器：

在“运行环境”窗口中，右键单击该应用服务器节点，然后选择“启动服务器”。
展开应用服务器节点。该节点包含在应用服务器的管理控制台中看到的所有类别的子节点。通过右键单击任意一个节点并选择“属性”，可对应用服务器进行配置。

配置 Derby 数据库

在本教程中，您将通过 Derby 数据库服务器中包含的其中一个表来生成 CMP Bean。Derby 数据库服务器包含在 Sun Java System Application Server 8.2 下载文件中。

在“运行环境”窗口中，展开“数据库”节点。您会看到 jdbc:derby://localhost:1527/sample 数据库的节点。
右键单击 jdbc:derby://localhost:1527/sample 数据库，然后选择“连接”。如果系统提示您输入口令，请键入 app 作为用户名和口令，然后单击“确定”。
展开 sample 数据库节点和“表”节点。确保其中包含 CUSTOMER 节点，如下所示。

注意：如果修改了 sample 数据库，可使用此 SQL 脚本对其进行重写。

对 EJB 模块进行编码

对 Enterprise Bean 进行编码非常容易。IDE 会兼顾所有实现细节，因此您可以集中精力对 EJB 模块的业务逻辑进行编码。

创建企业应用程序项目

在本示例中，我们将创建一个企业应用程序项目作为 Web 模块和 EJB 模块的容器。通过使用企业应用程序模板，您可以自动为 Web 模块和 EJB 模块创建项目。

选择“文件”>“新建项目”(Ctrl-Shift-N)，然后从“企业”类别中选择“企业应用程序”模板。单击“下一步”。
将应用程序命名为 CustomerBook，然后指定项目位置。将其余设置保持为缺省值，然后单击“完成”。

生成 CMP 实体 Bean

现在，我们将生成访问 sample 数据库的实体 Bean。对于程序要访问的每个表，都需要一个对应的实体 Bean。

在“项目”窗口中，右键单击 EJB 模块的节点 (CustomerBook-EJBModule)，然后选择“新建”>“通过数据库生成 CMP 实体 Bean”。
选择“JDBC 连接”作为数据库源，然后从组合框中选择 jdbc:derby://localhost:1527/sample 连接。
键入 ejb 作为包名，然后单击“下一步”。向导将显示选定数据库中的所有表。
选择 CUSTOMER 表，单击“添加”，然后单击“完成”。
IDE 将为 CUSTOMER 表以及从 CUSTOMER 引用的任何表 (DISCOUNT_CODE) 创建 CMP Bean。IDE 还会创建一个新的 JDBC 连接池和数据源，在部署项目时，将在应用服务器中注册该连接池和数据源。

对会话 Bean 进行编码

现在，我们将创建一个会话 Bean，用来处理 Web 应用程序客户端对实体 Bean 中的信息的访问。我们将创建一个空会话 Bean，生成对实体 Bean 的调用，然后添加一些 business 方法。

在“项目”窗口中，右键单击 CustomerBook-EJBModule 项目节点，然后选择“新建”>“会话 Bean”。将该会话 Bean 命名为 CustomerFacade，并将其放在 ejb 包中。将 Bean 设置为无态 Bean，并且只有远程接口。然后单击“完成”。IDE 将创建此 Bean，并在源代码编辑器中打开其 Bean 类。
在源代码编辑器中，在 Bean 类中的任意位置单击鼠标右键，选择“企业资源”>“调用 Enterprise Bean”。选择 CustomerEB Bean，然后单击“确定”。IDE 将在源文件底部生成 lookupCustomerBean 方法。
将以下内容添加到 Bean 类起始位置的变量声明中：
```
private ejb.CustomerLocalHome custHome;
```
现在，我们将在会话 Bean 的 create 方法中获取对实体 Bean 的 Home 接口的引用。删除 ejbCreate() 中的注释并添加以下语句：
```
custHome = lookupCustomerBean();
```

在 Bean 类主体中的任意位置单击鼠标右键，选择“EJB 方法”>“添加 Business 方法”。指定以下信息：

元素	值
方法名	`getCustomerInfo`
返回类型	`String`
参数	`int custId`
异常	`javax.ejb.FinderException`

在源代码编辑器中，按如下内容编辑 getCustomerInfo business 方法：

        public String getCustomerInfo(int custId) throws javax.ejb.FinderException {
    ejb.CustomerLocal customer = custHome.findByPrimaryKey(new Integer(custId));
    return "Name: " + customer.getName() + ", E-mail: " +customer.getEmail();
    }

最终的 CustomerFacadeBean.java 文件应如此处所示。

对 Web 模块进行编码

现在，我们需要对 Web 模块进行编码，该模块将为实体 Bean 提供用户接口。Web 模块包含一个 Servlet，允许用户按客户编号对客户进行搜索。

创建定制服务定位器

在上一节中，我们在调用 Enterprise Bean 时通过 IDE 生成了内联查找代码。在此节中，我们将创建一个定制服务定位器，IDE 将在生成对 Enterprise Bean 的调用时用到它。我们的服务定位器没有任何特殊功能，但您可以定制企业应用程序查找 Enterprise Bean 的方式。

在“项目”窗口中，右键单击 CustomerBook-WebModule 节点，然后选择“新建”>“文件/文件夹”。在向导中，从“企业”类别中选择服务定位器模板。单击“下一步”。
键入 ServiceLocator 作为类名，键入 Web 作为包，然后单击“完成”。

对 Servlet 进行编码

在最后一步中，我们将向 Web 模块添加一个 Servlet，通过它可以查找并显示 CUSTOMER 表中的每个客户的信息。

在“项目”窗口中，右键单击 CustomerBook-WebModule 节点，然后选择“新建”> "Servlet"。将 Servlet 命名为 CustomerDetail，然后将其放在 web 包中。然后单击“完成”。
在源代码编辑器中，在 Servlet 类中的任意位置单击鼠标右键，选择“企业资源”>“调用 Enterprise Bean”。选择 CustomerFacade 会话 Bean，将 web.ServiceLocator 类设置为服务定位器策略，然后单击“确定”。IDE 将插入该查找方法。
按如下所示编辑 processRequest 方法：

protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet customerDetail</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Servlet customerDetail at " + request.getContextPath () + "</h1>");
String customerNr = request.getParameter("customer_nr");
if((customerNr != null) && !(customerNr.equals("")))
{
try{
ejb.CustomerFacadeRemote custFacade = lookupCustomerFacadeBean();
out.println("Customer's info for nr. " + customerNr + ": " + custFacade.getCustomerInfo(
Integer.parseInt(customerNr)));
}catch(javax.ejb.FinderException ex){
out.println("Customer with nr. " + customerNr +" not found");
}
}
out.println("<form>");
out.println("Customer number: <input type='text' name='customer_nr' />");
out.println("<input type=submit value=Select />");
out.println("</form>");
out.println("</body>");
out.println("</html>");
out.close();
}

最终的 CustomerDetail.java Servlet 应如此处所示。

生成和部署应用程序

现在，就可以将企业应用程序部署到应用服务器中了。不需要再对部署描述符进行其他配置。IDE 已经配置了部署描述符，并为企业应用程序准备了新的连接池和数据源。

设置程序的缺省 Web 页

缺省情况下，Web 应用程序在运行时会显示其 index.jsp 页。由于我们的 index.jsp 是空的，因此希望 CustomerBook 项目显示 CustomerDetail Servlet。

在“项目”窗口中，右键单击 CustomerBook 项目，然后选择“属性”。接下来在左面板中单击“运行”。
在“相对 URL”字段中键入 /CustomerDetail。

运行应用程序

右键单击 CustomerBook 项目并选择“运行项目”。IDE 会执行以下所有任务：
- 生成企业应用程序项目及其所有子项目（Web 模块项目和 EJB 模块项目）。
- 如果服务器尚未运行，请启动它。
- 如果企业应用程序已部署到应用服务器上，请卸下它。
- 将企业应用程序部署到应用服务器上。
- 打开在指定的相对 URL 中的 Web 模块。

您应在外部浏览器中看到以下页面。在键入某一客户编号并按 Enter 键时，页面中应显示该客户的信息。

疑难解答

一些常见问题包括：

打开 CustomerDetail 时出现 HTTP Status 404 错误。这意味着，应用服务器找不到 CustomerDetail Servlet。确保上下文根目录 (/CustomerBook-WebModule) 与为 Web 模块设置的根目录匹配（右键单击 Web 模块项目节点 >“属性”>“运行”>“上下文路径”）。
在 CustomerDetail 表单中提交客户编号时出现 javax.transaction.TransactionRolledbackException: CORBA TRANSACTION_ROLLEDBACK 错误。这通常意味着，服务器无法访问数据库。如果出现这种情况，请执行以下操作：
- 确保 Derby 数据库服务器正在运行。要启动 Derby，请选择“工具”> "Derby" >“启动 Derby 服务器”。
- 确保在应用服务器中正确注册了资源池和数据源。要对其进行检查，可转到“运行环境”窗口并展开应用服务器的 JDBC 节点。“JDBC 资源”节点应包含 jdbc/derby_net 节点；“连接池”节点应包含 derby_netConnectionPool 节点。注册连接池和数据源（如果尚未注册）：
  1. 展开 CustomerBook-EJBModule 项目的“服务器资源”节点。
  2. 右键单击 connection-pool-derby_net.sun-resource 节点，然后选择“注册”。
  3. 对 datasource-jdbc_derby_net.sun-resource 节点执行相同的步骤。

注意：要查看服务器日志，请转至“运行环境”窗口，右键单击应用服务器节点，然后选择“查看服务器日志”。

关注我们