IBM® Rational® Application Developer for WebSphere Software V7.5 包含了利用 JPA 和 EJB 技术 3.0 版本创建 Java™ EE 应用程序的工具。Rational Application Developer V7.5 引入了新的向导、编辑器，和透视图来很容易地创建强大的应用程序。本文面向中级用户，带您了解各种新的特性，并且向您展示如何创建端到端的 Java EE 应用程序。

引言

本文向您介绍 IBM® Rational® Application Developer for WebSphere Software V7.5，并带您构建 JPA 实体、session bean，并将它们部署到 IBM® WebSphere® V7.0 上。

Java™ Platform，Enterprise Edition V5.0（Java™ EE）在创建企业应用程序方面进行了重大变更，它支持 Java™ Persistence API（JPA），和 Enterprise Java™Beans technology（EJB）V3.0 程序设计模型、标注，和依赖注入。

必备条件

本文假设您至少安装了 Rational Application Developer V7.5 和 WebSphere V7.0 测试服务器。

示例应用程序

您将要创建的示例应用程序有一个 JPA 实体、调用该 JPA 实体的 Session bean、调用 Session bean 的 Servlet，以及调用 servlet 的 web 页面。该应用程序中使用的数据库是 RAD 7.5 中带有的内嵌 Derby 数据库。以下的图描述了应用程序各个组件之间的交互序列。

遵照以下这些步骤开发应用程序：

1. 创建 JPA 项目和实体，并指定映射
   
   
2. 创建 EJB V3.0 项目，和使用 JPA 实体的 session bean
   
   
3. 创建 Web V2.5 项目和调用 session bean 的 servlet
   
   
4. 设置数据源，并在 WebSphere V7.0 上运行 Web 页面
   
   

创建 JPA 项目和实体，并指定映射

在此实例中，您在单独的归档（.jar）中创建 JPA 实体。注意到 Java EE 规范允许您在 Web 或 EJB 项目中打包 JPA 实体。在 Rational Application Developer 中，您可以向 Web 或 EJB 项目添加 JPA 的部分来让它们支持 JPA 实体。

创建 JPA 项目

1. 在 Java EE 透视图中，选择 File > New > Other > JPA Project，如图 1 所示。

2. 指定 Project 名称，如图 2 所示。

3. 提示您切换到 JPA 透视图，选择 No。JPA 透视图拥有例如 JPA Structure 和 JPA Details 的视图，由于 Java EE 透视图中的 Annotations 视图允许类似的功能，所以切换到 JPA 透视图不是必需的。

注意到 Rational Application Developer 创建了带有以下这些文件的项目：

• persistence.xml
• orm.xml
• manifest.MF。

持久化单元名称设置为 EmployeeJPA。

创建 JPA 实体

4. 右键单击项目并选择 New > Entity，如图 4 所示。

5. 指定包名和类名，如图 5 所示，然后单击 Next。

6. 单击 以下页面中的 Add 按钮，创建实体字段，如图 6 所示。

7. 在结果的 Entity Fields 对话框中，从下拉列表中选择 java.lang.String 作为 Type，如图 7 所示。

8. 单击向导的 Finish，您将看到为字段创建了 getter 和 setter 方法的类，标注 _cnnew1@Entity，和用于主键字段的标注 @Id，如清单 1 所示。

				

import java.io.Serializable;
import java.lang.String;
import javax.persistence.*;

/**
 * Entity implementation class for Entity: Employee
 *
 */
@Entity


public class Employee implements Serializable {

	   
	@Id
	private String EMP_ID;
	private String First_Name;
	private String Last_Name;
	private static final long serialVersionUID = 1L;

	public Employee() {
		super();
	}   
	public String getEMP_ID() {
		return this.EMP_ID;
	}

	public void setEMP_ID(String EMP_ID) {
		this.EMP_ID = EMP_ID;
	}   
	public String getFirst_Name() {
		return this.First_Name;
	}

	public void setFirst_Name(String First_Name) {
		this.First_Name = First_Name;
	}   
	public String getLast_Name() {
		return this.Last_Name;
	}

	public void setLast_Name(String Last_Name) {
		this.Last_Name = Last_Name;
	}
   
}

映射数据库

要确保实体类可以适当地和数据库表通信，就需要二者之间的映射。JPA 提供两种映射机制。一个是根据标注，另一个是根据 XML（orm.xml 中指定的）。本实例使用了标注机制进行映射。

9. 在 Java EE 透视图中的 Data Source Explorer 视图中，选择 Derby Sample Connection > Connect，如图 8 所示。

10. 分析 Employee 表，如图 9 所示。

11. 由于方案不匹配，所以您需要修改映射。

12. 在 Annotation 视图中，单击实体 Employee 的 Table 节点，并指定以下内容，如图 10 所示。
    • Table Name：EMPLOYEE
    • Schema：SAMP

13. 单击 EMP_ID 下的列节点，并将其映射到 EMPNO 列，如图 11 所示。

14. 同样地，将 First_Name 和 Last_Name 映射到适当的列。

15. 现在，Java 文件将如清单 2 所示。

				
@Entity

@Table(schema="SAMP", name = "EMPLOYEE")
public class Employee implements Serializable {

	   
	@Id
	@Column(name="EMPNO")
	private String EMP_ID;
	@Column(name="FIRSTNME")
	private String First_Name;
	@Column(name="LASTNAME")
	private String Last_Name;

16. 需要设置 persistence.xml 中的 Java Database Connectivity（JDBC）API 数据源。打开 Enterprise 浏览器中的文件，如图 12 所示。

17. 接下来，指定数据源，如图 13 所示（需要创建实际的数据源：步骤如最后一个部分中所示）。

回页首

创建 EJB V3.0 项目，和使用 JPA 实体的 session bean

在本部分中，您将创建 EJB 项目和 session bean。

创建 EJB 项目

1. 选择 File > New > EJB Project。

2. 指定 Project name，设置 EJB Module version 为 3.0，并选择 EAR Project Name，如图 15 所示。对于本实例，选择您创建 JPA 项目时创建的 EAR 项目。

3. 右键单击 EJB 项目，并选择 Java EE Module Dependencies，然后选择 EmployeeJPA.jar，如图 16 所示。这在 EJB 项目中创建了清单实体，并且还让 JPA 实体类在开发过程中可见。

创建 session bean

4. 在 Enterprise Explorer 中右键单击 Session Beans 节点，并选择 New > Session Bean，如图 17 所示。

5. 指定 Java 包和类名，如图 18 所示。在此实例中，选择了 Local 业务接口。

6. 单击 Finish。创建了 EmployeeSession 类和 EmployeeSessionLocal 业务接口。

调用 JPA 实体

7. 向 seesion bean 类中添加名为 findEmployee 的方法。

				
EntityManager em;
    
    public Employee findEmployee(String empNo){
    	Employee emp = (Employee) em.find(Employee.class, empNo);
    	return emp;
    } 

8. 您需要将持久性单元定义为实体管理器变量。记住，当创建 JPA 项目时，在 persistence.xml 中设置了持久化单元 EmployeeJPA。您可以直接将其标注为：@PersistenceContext(name="EmployeeJPA") ，并且引入 javax.persistence.PersistenceContext，或者您可以在 Annotation 视图中选择 Add annotation。

9. 选择 bean，如图 19 所示。

10. 选择标注，如图 20 所示。

11. 将持久性单元命名为 EmployeeJPA，如图 21 所示。

该动作不仅添加标注，还正确地设置导入。

12. 最终的类如清单4 所示。

				
package com.ibm.ejb;

import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import com.ibm.entities.Employee;
import javax.persistence.PersistenceContext;

/**
 * Session Bean implementation class EmployeeSession
 */
@Stateless
public class EmployeeSession implements EmployeeSessionLocal {

    /**
     * Default constructor. 
     */
    public EmployeeSession() {
        // TODO Auto-generated constructor stub
    }
    

    @PersistenceContext(unitName="EmployeeJPA")
    EntityManager em;
    
    public Employee findEmployee(String empNo){
    	Employee emp = (Employee) em.find(Employee.class, empNo);
    	return emp;
    }    

}

13. session bean 的业务接口需要有您刚添加的方法的签名。您可以快速地完成：选择 outline 视图中的方法，并且选择 Java EE > Promote Methods，如图 22 所示。

14. 这将打开 Promote Methods 对话框。选择 findEmployee(string) 方法，如图 23 所示。

现在准备好让客户端消费 session bean。

回页首

创建 Web V2.5 项目和调用 session bean 的 servlet

在此部分中，您将创建 Web 项目和 servlet。

创建 Web 项目

1. 选择 File > New > Dynamic Web Project，如图 24 所示。

2. 指定 Web Project name，选择 Dynamic Web Module version 为 2.5，并选择用于 JPA 和 EJB 项目一样的 EAR Project Name，如图 25 所示。

3. 当提示打开透视图时，选择 No，如图 26 所示，Web 透视图中拥有在此实例中我们不需要的高级 web 编辑工具。

4. 右键单击 Web 项目，并在左边的列表中选择 Java EE Module Dependencies，然后选择 EmployeeEJBClient.jar 和 EmployeeJPA.jar，如图 27 所示。

创建 servlet

5. 在 Enterprise explorer 中，在 Servlets 节点中选择 New > Servlet，如图 28 所示。

6. 对于 servlet 指定 Java 包（com.ibm.servlets）和 Class 名（EmployeeSearch），如图 29 所示。

7. 修改 doGet 方法，如清单 5 所示。该方法从请求对象中获取 employee id，并将其传递给 session bean 来找到 employee 信息。

				
@EJB(name="Employee")
private EmployeeSessionLocal employeeSession; 
	
protected void doGet(HttpServletRequest request,
           HttpServletResponse response) throws
            ServletException, IOException {
  String empNo = request.getParameter("empid");
  Employee emp = employeeSession.findEmployee(empNo);
  if(emp  != null ){
    response.getWriter().println(emp.getFirst_Name() + 
    " " + emp.getLast_Name());
  }else{
    response.getWriter().println("Employee with id =" + 
      empNo + "couldn't be found");
  }
}

8. 在 Web 项目中创建 HTML 页面，该页面包含 employee id 的输入框，和提交按钮，如清单 6 所示。

				

   
   	 

   	   
             Type Employee ID and press Submit 

             
             
   	   
   	 

   

回页首

设置数据源，并在 WebSphere V7.0 上运行 Web 页面

在此部分中，您将设置数据源并运行 Web 页面。

设置数据源

1. 右键单击 EAR 项目，EmployeeEAR，并选择 JavaEE > Open WebSphere Application Server Deployment，如图 30 所示。

2. 在 JDBC 提供者部分中，单击 Add 并选择 Database type（Derby）和 JDBC provider type（Derby JDBC Provider），如图 31 所示。

3. 命名提供者（DerbyDB）并选择启动程序和 Class path（IBM\SDP75\runtimes\base_v7\derby\lib\derby.jar），如图 32 所示。

4. 现在单击 Add 创建数据源，如图 33 所示。

5. 选择 Derby JDBC Provider 和 V5.0 数据源，并单击 Next 按钮，如图 34 所示。

6. 指定数据源名称和 JNDI 名称，如图 35 所示。记住使用您在 persistence.xml JPA 中同样的 JNDI 名。

7. 在工作区中定位示例 Derby 数据库，并且在数据库名称属性中输入路径（workspace\EmployeeSample\metadata\plugins\com.ibm.datatools.db2.cloudscape.driver\SAMPLE），如图 36 所示。

运行 Web 页面

8. 右键单击 EmployeeSerach.html 并选择 Run As > Run on Server，如图 37 所示。

9. EAR 添加到服务器中，如图 38 所示。

10. 输入 EmployeeID 并按下 Submit，如图 39 所示。

11. 结果显示在屏幕上

您学到的东西

Java EE V5.0 简化了企业应用程序的开发。本文向您介绍了如何使用 Java Persistence API、EJB V3.0，和 Rational Application Developer V7.5 中提供的工具来构建这些企业工件。

下载

	关于下载方法的信息

参考资料

• 您可以参阅本文在 developerWorks 全球网站上的 英文原文。
  
  
• developerWorks 文章 使用 Java Persistence API 与 JavaServer Faces 开发 Web 应用程序，由 Tom Mutdosch 所作，在 Rational Application Developer v7.5 中演示了 JPA Web。
  
  
• DeveloperWorks 文章 使用 IBM Rational Application Developer V7.5 中的 JPA, Ajax 与 Dojo 工具开发 Web 2.0 应用程序，由 Jarett Stein 所作，详细说明了如何在 IBM Rational Application Developer for WebSphere Software V7.5 中使用 JPA, AJAX 和 Dojo 工具创建一个简单的端到端的 Web 应用程序。
  
  
• 通过阅读文章 在 IBM Rational Application Developer V7.5 中的 JavaServer Faces 工具有什么新特性？ 了解更多有关 Rational Application Developer V7.5 中的 JavaServer Faces 工具的内容。
  
  
• 通过阅读文章 使用 Rational Application Developer for WebSphere Software 应对软件开发的挑战，了解更多有关当交付 Web 和面向服务应用程序时， Rational Application Developer V7.5 如何提供解决方案以应对软件团队所面临的众多挑战。
  
  
• 通过阅读文章 在 IBM Rational Software Architect V7.5 中使用 UML Modeler 的新特性，了解更多有关 UML Modeler 组件的新功能如何共用于 IBM Rational Software Architect Standard Edition V7.5 和 IBM Rational Software Architect for WebSphere Software V7.5 的内容。
  
  
• 在 IBM Rational 市场活动 Web 站点查找所有有关 Rational Application Developer V7.5 的内容。
  
  
• 学习所有有关 EJB 3.0 的内容。
  
  
• 访问 developerWorks 上的 Rational 专区，了解有关 Rational 软件交付平台产品的技术资源和最佳实践。
  
  
• 订阅 IBM developerWorks 时事通讯，获得有关最佳的 developerWorks 教程、文章、下载、社区活动、网络广播和事件的每周更新。
  
  
• 订阅 developerWorks Rational 专区时事通讯。 时刻关注 developerWorks Rational 内容。 每隔一周，你将会收到 Rational 软件交付平台的技术资源和最佳实践的最新更新。
  
  
• 订阅 Rational Edge 中文版，获得了解高效软件开发背后概念的文章。
  
  
• 浏览 技术书店，获得有关这些和其它技术主题的书籍。
  
  

• 有关技术资源，请访问 developerWorks 上的 Rational Application Developer 产品专题。 你将找到技术文档，指南文章，培训，下载，产品信息，以及更多内容。
  
  
• 下载 IBM Rational 软件的试用版。
  
  
• 下载这些 IBM 产品评估版，并着手使用来自于 DB2®，Lotus®，Tivoli®，以及 WebSphere® 的应用程序开发工具和中间件产品。
  
  

• 查看 developerWorks 博客，并加入 developerWorks 社区。
  
  
• 加入 developerWorks 上的 Rational Application Developer 讨论区。

关于作者

		Neeraj 在北卡罗来纳州 Durham 的 IBM Research Triangle Park Lab 的 IBM Rational 致力于 Java EE 工具的研究。他在印度的 H.B.T.I 取得计算机科学与工程学士学位，并且在康涅狄格的 Bridgeport 大学获得计算机科学硕士学位。