本文对 JavaTM Platform Enterprise Edition 5 ("Java EE 5") 与 Java 2 Platform Enterprise Edition 1.4 ("J2EE 1.4") 二者的开发过程进行了比较，并演示了 Java EE 5 技术是如何简化 Java 应用程序的开发。
本文对 JavaTM Platform Enterprise Edition 5 ("Java EE 5") 与 Java 2 Platform Enterprise Edition 1.4 ("J2EE 1.4") 二者的开发过程进行了比较，并演示了 Java EE 5 技术是如何简化 Java 应用程序的开发。
本文对 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 号的客户名称。
如果想了解更多相关信息以及详细咨询，欢迎点击中英网http://www.uker.net/，或发email至：echo@uker.net，UKer.net资深编辑将为您详细解答。
网友评论