比较Java EE 5平台和J2EE 1.4平台

本文对 JavaTM Platform Enterprise Edition 5 ("Java EE 5") 与 Java 2 Platform Enterprise Edition 1.4 ("J2EE 1.4") 二者的开发过程进行了比较，并演示了 Java EE 5 技术是如何简化 Java 应用程序的开发。为了显示新的开发模型比旧的模型更为简单，我们将使用 NetBeans IDE 5.5 创建一个应用程序，该应用程序与在使用 NetBeans IDE 5.0 开发 J2EE 应用程序的快速入门指南中创建的应用程序相同。

　　在本文中，将创建一个用于访问数据库的 Web 应用程序。在该 Web 应用程序中，将使用 IDE 从数据库生成实体类，然后创建一个 Servlet 来显示信息。

　　先决条件

　　本文假定您已具备了以下技术的一些基本知识或编程经验：

• 　　Java 编程
• 　　NetBeans IDE

　　本教程所需的软件

　　在学习之前，您需要在计算机中安装以下软件：

• 　　NetBeans IDE 5.5
• 　　Java Standard Development Kit (JDK) 版本 5.0 或版本 6.0
• 　　Sun Java System Application Server Platform Edition 9

　　为 IDE 配置应用服务器

　　在学习本教程之前，必须在 IDE 中注册 Sun Java System Application Server Platform Edition 9 的实例。在本练习中，我们将在 IDE 中注册 Sun Java System Application Server。

• 　　从主菜单中，选择“工具”>“服务器管理器”。
• 　　单击“添加服务器”。选择 "Sun Java System Application Server"，并为此实例指定一个名称，然后，单击“下一步”。
• 　　指定应用服务器的安装目录(例如，C:\Sun\Appserver)。
• 　　将“注册本地缺省域”单选按钮保留为选中状态，然后选择一个域。
• 　　(可选)单击“下一步”，输入管理员用户名和口令。如果不希望在 IDE 用户目录中存储用户名和口令，可以将这些字段保留为空。IDE 将在每次需要此信息时提示您输入。
  　　注意：缺省管理员口令是 adminadmin。
• 　　单击“完成”。IDE 将注册该服务器，并在“运行环境”窗口的“服务器”节点下面列出该服务器。

　　建立 Web 应用程序项目

　　在 NetBeans IDE 5.0 快速入门中，我们创建了一个具有 EJB 模块和 Web 模块的完整企业应用程序。之所以这样做是因为：在 J2EE 1.4 平台中进行开发时，必须将实体 Bean 和会话 Bean 放置在 EJB 模块中。要从 Web 模块访问实体 Bean，我们必须添加查询代码。

　　而在 Java EE 5 平台上开发的示例中，不需要开发完整的企业应用程序，因为我们不需要 EJB 模块或会话 Bean。只需创建一个简单的 Web 应用程序，然后将实体类直接放置在该 Web 应用程序中即可。

• 　　选择“文件”>“新建项目”(Ctrl-Shift-N)。从 "Web" 类别中，选择“Web 应用程序”。
• 　　将项目命名为 CustomerBook，将服务器设置为 Sun Java System Application Server，将 Java EE 版本设置为 Java EE 5，然后单击“完成”。

　　对 Web 应用程序进行编码

　　与在 J2EE 1.4 平台中创建 Web 应用程序相比，在 Java EE 5 平台中进行 Web 应用程序编码要更快、更容易。但是我们仍然需要进行一些基本的设置，如建立数据库连接，但是在创建连接池和数据源后，开发工作会变得更容易，这是因为在 Java EE 5 平台中进行开发时，容器可以完成更多的工作。

　　由于容器具有持久性管理功能，因此，我们不需要编辑用来配置 CMP 映射或指定 finder 方法的部署描述符。实际上，我们在本示例中根本不需要任何部署描述符。在 Java EE 5 平台中，持久性不再局限于 EJB 组件。Java EE 5 引入了 Java 持久性 API，非 EJB 组件(如 Web 应用程序)也可以使用它。

　　此外，使用 Java EE 5 技术时，您不再需要 J2EE 1.4 开发中所需的许多样板代码。由于简化了 EJB 开发，因此只需很少的接口，查询也变得更为简单了，并且通过标注方式，组件定义和资源注入变得简单而清晰。

　管理持久性

　　在 NetBeans IDE 5.0 快速入门中，我们创建了 CMP 实体 Bean 并在 ejb-jar.xml 中定义了部署描述符，用来管理持久性和对象关系映射。在 Java EE 5 平台中进行开发时，我们不再需要使用部署描述符为容器提供管理持久性的信息，只需创建持久性单元，指定要使用的数据源和实体管理器，然后让容器完成管理实体和持久性的工作即可。容器会在运行时发现实体 Bean。

　　持久性单元的创建可以通过在 persistence.xml 中定义来完成。如果项目或模块中不存在 persistence.xml，则需要创建该文件。可以通过“新建持久性单元”向导将持久性单元添加到项目中，该向导将有助于我们创建 persistence.xml 并定义持久性单元的属性。注意：也可以在“新建 - 实体类”向导中创建持久性单元。创建实体类时，如果不存在持久性单元，该向导将提示我们进行创建。

• 　　选择“新建文件”(Ctrl-N) 打开“新建文件”向导。
• 　　从“持久性”类别中，选择“持久性单元”，然后单击“下一步”。
• 　　保留向导建议的持久性单元的缺省名称。
• 　　使用“持久性提供程序”下拉列表中列出的 TopLink(缺省)。
  　　缺省提供程序是 TopLink Essential.jar。TopLink Essential.jar 包含了 Java 持久性的库。并且实体管理器位于 TopLink Essential.jar 中。
• 　　使用“数据源”下拉列表中列出的缺省 jdbc/sample 数据源。
  　　缺省数据源 jdbc/sample 用于连接到与 Sun Java System Application Server 捆绑在一起的 Java DB 数据库。
• 　　单击“完成”。

　　单击“完成”后，将为项目创建 persistence.xml，并在源代码编辑器中将其打开。通过单击源代码编辑器工具栏中的 "XML"，可以查看 persistence.xml 的 XML 视图。此文件包含了 Java EE 5 容器管理应用程序的实体和持久性所需的所有信息。

　　创建实体类

　　在 J2EE 1.4 平台中进行开发时，创建实体 Bean 后会将它们放置在 EJB 模块中，即使应用程序是简单的 Web 应用程序也是如此。每个实体 Bean 需要若干个接口，而且您必须在 ejb-jar.xml 中配置部署描述符以定义实体 Bean 以及每个实体 Bean 的接口、持久性和 finder 查询。

　　在 Java EE 5 中，我们可以使用简单的实体类，而且可以将实体类放置在 Java EE 5 应用程序中的任意位置，而不是创建实体 Bean 并将它们放置在 EJB 模块中。同时，为 Java EE 5 应用程序编写类要比在 J2EE 1.4 平台中编写类更容易，因为您可以使用标注来定义组件和注入资源。

　　现在我们将使用“新建 - 通过数据库生成实体类”向导来基于关系数据库创建实体类。

• 　　启动 Java DB 数据库，方法是：从主菜单中选择“工具”>“Java DB 数据库”>“启动 Java DB 服务器”。
• 　　选择“新建文件”(Ctrl-N) 打开“新建文件”向导。从“持久性”类别中，选择“通过数据库生成实体类”，然后单击“下一步”。
• 　　在“新建 - 通过数据库生成实体类”向导中，从“数据源”下拉列表中为数据库选择 jdbc/sample 数据源，并提供口令(如有必要)，口令应为 "app"。选择数据源后，将在“可用表”窗格中显示可用表的列表。
• 　　从“可用表”中选择 CUSTOMER 表，然后单击“添加”。
  　　单击“添加”后，还将添加与选定表关联的任何表。此外，在本示例中，我们还需添加 DISCOUNT_CODE 表。DISCOUNT_CODE 表以灰色显示，这是因为 CUSTOMER 表引用了该表，而且必须生成它的实体类，这样才能生成 Customer 实体类。通过在“选定的表”窗格中将鼠标悬停在表名上，可以查看灰色显示的表是如何与选定表关联的。
• 　　单击“下一步”。
  　　向导将显示选定表及其任何关联表，以及将基于选定表创建的实体类。如果要修改将生成的类的名称，则可以在“类名”字段中键入名称。
• 　　指定 ejb，将其作为生成类的包，然后单击“完成”。

单击“完成”后，IDE 将为 CUSTOMER 表和与 CUSTOMER 表关联的表生成实体类。如果在“项目”窗口中展开 ejb 源包，则可以看到 IDE 在 Web 应用程序项目的 ejb 包中创建了 Java 类 Customer.java 和 DiscountCode.java。

　　您可以看到 IDE 只创建了两个类(为每个数据库表创建了一个类)。在“使用 NetBeans IDE 5.0 开发 J2EE 应用程序的快速入门指南”中使用“通过数据库生成 CMP 实体 Bean”时，IDE 会为每个表创建四个类。

　　如果您在源代码编辑器中查看 Customer.java，则会注意到已使用了 @Entity 标注将类声明为实体类。其他标注还提供了附加信息，如实体类及其属性映射的数据库表和列。

　　您还会注意到，通常在实体 Bean 中找到的大部分样板代码都不见了。这是因为在 Java EE 5 中，实体类不再需要诸如 ejbRemove、setMessage、setSessionContext、ejbActivate 和 ejbPassivate 之类的方法。

　　对 Servlet 进行编码

　　现在我们需要将 Servlet 添加到 Web 应用程序中。在 Java EE 5 中，我们不必将资源创建和查询代码添加到 Servlet 中，而是可以使用资源注入将这些工作交给容器来执行。可以使用标注将资源直接注入到 Servlet 中，并由容器来管理请求资源的创建和查询。在这种情况下，我们希望使用在持久性单元中指定的实体管理器。

• 　　在“项目”窗口中右键单击项目节点，然后选择“新建”> "Servlet"。
• 　　在“新建 Servlet”向导中，将 Servlet 命名为 CustomerDetails，并将 Servlet 放入名为 web 的包中。单击“完成”。单击“完成”后，将在源代码编辑器中打开 CustomerDetails.java。
• 　　在源代码编辑器中打开的 CustomerDetails.java 上，单击鼠标右键，然后选择“持久性”>“使用实体管理器”，将 PersistenceContext 注入类中。IDE 将添加以下标注，该标注用于指定 Servlet 使用的持久性单元。请在类声明之上添加此标注。

@PersistenceContext(name = "persistence/LogicalName", unitName = "CustomerBookPU")

　　IDE 还将添加以下标注，用于注入管理事务边界的资源：

@Resource private UserTransaction utx;

　　IDE 将在 Servlet 中添加以下缺省代码：

public void persist(Object object) { 　　try { 　　Context ctx = (Context) new InitialContext().lookup("java:comp/env"); 　　EntityManager em = (EntityManager) ctx.lookup("persistence/LogicalName"); 　　utx.begin(); 　　// TODO: 　　// em.persist(object); utx.commit(); 　　} catch(Exception e) { 　　Logger.getLogger(getClass().getName()).log(Level.SEVERE,"exception caught", e); 　　throw new RuntimeException(e); 　　} 　　}

　　此代码用于查询 @PersistenceContext 定义的持久性单元和实体管理器的实例。

　在 CustomerDetails.java 中，将上面所显示的生成的查询代码修改为引用实体对象。完成后，经过修改的代码应如下所示(以粗体显示的代码表示已更改的行)：

public Customer findByID(Integer customerNr) { 　　Customer customer = null; 　　try { 　　Context ctx = (Context) new InitialContext().lookup("java:comp/env"); 　　EntityManager em = (EntityManager) ctx.lookup("persistence/LogicalName"); 　　utx.begin(); 　　customer = em.find(Customer.class, customerNr); 　　utx.commit(); 　　} catch(Exception e) { 　　Logger.getLogger(getClass().getName()).log(Level.SEVERE,"exception caught", e); 　　throw new RuntimeException(e); 　　} 　　return customer; 　　}

• 　　取消注释 processRequest 方法中的代码并添加下面以粗体显示的代码：

protected void processRequest(HttpServletRequest request, HttpServletResponse response)         throws ServletException, IOException {         response.setContentType("text/html;charset=UTF-8");         PrintWriter out = response.getWriter();         out.println("<html>");         out.println("<head>");         out.println("<title>Servlet CustomerDetails</title>");         out.println("</head>");         out.println("<body>");         out.println("<h1>Search Customer Information</h1>");         String customerNr = request.getParameter("customer_nr");         if((customerNr != null) && !(customerNr.equals(""))) {             Customer customer = findByID(new Integer(customerNr));             if(customer != null){                 out.println("Customer's info for nr. " + customerNr + ": " + customer.getName());             }else{                 out.println("Customer 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();     }

• 　　按 Alt-Shift-F 组合键生成所有缺少的 import 语句。

　运行项目

• 　　在“项目”窗口中，右键单击 "CustomerBook" 项目节点，然后选择“属性”。在“项目属性”对话框的“运行”窗格中，在“相对 URL”字段中键入 /CustomerDetails，然后单击“确定”。
• 　　右键单击项目节点，然后选择“运行项目”。IDE 将启动应用服务器、生成项目，并在浏览器中打开 CustomerDetails 页。
• 　　在“客户号码”字段中输入 ID 号(例如 "1")，然后单击“提交”。Servlet 将显示具有该 ID 号的客户名称。