EJB 3.0 Enterprise Bean(官方教程)

linkxiong

EJB 3.0 Enterprise Bean
本文档介绍了有关使用 EJB 3.0 技术（作为 Java EE 5 平台的一部分）开发企业应用程序的基础知识，同时说明了 EJB 3.0 技术是如何简化企业应用程序的开发过程的。本文档使用的是 NetBeans IDE 5.5 Beta 版。
请注意此发行版本是 Beta 版。要获取最新的完整发行版本，请转至
NetBeans 下载页
并下载 NetBeans IDE 5.0。
预计所需时间：30 分钟
先决条件
本文档假定您已经具备以下技术的一些基本知识或编程经验：

• Java 编程
  
• NetBeans IDE

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

• NetBeans IDE 5.5 Beta（
  下载
  ）
  
• Java Standard Development Kit (JDK) 版本 5.0（
  下载
  ）
  
• Sun Java System Application Server Platform Edition 9（
  下载
  ）

在学习本教程之前，您需要在 IDE 中注册 Sun Java System Application Server 的本地实例。
教程练习

• 
  建立企业应用程序项目
  
  
• 
  对 EJB 模块进行编码
  
  
• 
  对 Web 模块进行编码
  
  
• 
  运行项目
  

建立企业应用程序项目
本练习的目的是：创建包含一个 EJB 模块和一个 Web 模块的 NewsApp 企业应用程序项目。NewsApp 应用程序使用消息驱动 Bean 接收和处理 Servlet 发送到队列中的消息。该应用程序使用 Servlet 将消息发送到消息驱动 Bean 并显示消息。
创建企业应用程序

选择 "File" > "New Project" (Ctrl-Shift-N)。从 "Enterprise" 类别中选择 "Enterprise Application"。

将项目命名为 NewsApp，并将服务器设置为 "Sun Java System Application Server"。

将 J2EE 版本设置为 "Java EE 5"，然后选中 "Create EJB Module" 和 "Create Web Application Module"（如果未选中）。

单击 "Finish"。
小结
在本练习中，我们创建了包含一个 EJB 模块和一个 Web 模块的 Java EE 5 企业应用程序。
对 EJB 模块进行编码
在本练习中，我们将在 EJB 模块中创建对象。我们将创建实体类、消息驱动 Bean 和会话 Facade。我们还将创建一个持久性单元，以便为容器提供用于管理实体的信息，以及消息驱动 Bean 将使用的 Java 消息服务 (Java Message Service, JMS) 资源。
创建持久性单元
首先，我们将创建一个持久性单元，它用于定义在应用程序中使用的数据源和实体管理器。

右键单击 EJB 模块，然后选择 "New" > "File/Folder"。

从 "Persistence" 类别中，选择 "Persistence Unit"，然后单击 "Next"。

保留缺省的持久性单元名称。

对于 "Persistence Provider"，请使用 TopLink(default)。

对于 "Data Source"，请使用缺省的数据源 jdbc/sample。

确保为持久性单元选中了 "Use Java Transaction APIs" 复选框，并将 "Table Generation Strategy" 设置为 "Create"，这样便可以在部署应用程序时创建基于实体类的表。

单击 "Finish"。


单击 "Finish" 后，IDE 将创建 persistence.xml，并在源代码编辑器中将其打开。
Creating the JMS Resources
        
We will use the JMS API to send and receive messages in our enterprise application.
        We need to create our JMS resources, a destination and connection factory, and then register the resources with the application server.
        We will create jms/NewMessage and jms/NewMessageFactory.
        When we create our message-driven bean, we will use annotations to introduce jms/Queue directly in the bean class.
        Later, when we create our servlets in the web module, we will inject jms/NewMessage and jms/NewMessageFactory directly into the servlet class.
        
To create our jms/Queue resource, do the following:
        
            

Right-click the EJB module in the project and choose New > File/Folder to open the New File wizard.
            

From the Sun Resources category, select JMS Resource and click Next.
            

Type jms/Queue for the JNDI Name, select javax.jms.Queue for the
            Admin Object Resource type, and click Next.
            

Type Queue for the value of the Name property and click Finish.
        
        
To create our jms/NewMessageFactory resource, do the following:
        
            

Right-click the EJB module in the project and choose New > File/Folder to open the New File wizard.
            

From the Sun Resources category, select JMS Resource and click Next.
            

Type jms/NewMessageFactory for the JNDI Name, select javax.jms.ConnectionFactory for the
            Connector Resource type, and click Finish.
        
        
Now that we have created the JMS resources, we need to register the resources with the server.
        To register the resources, do the following:
        
            

Start the application server if the server is not already running.
            You can start the application server in the Runtime window of the IDE
            by expanding the Servers node and right-clicking the application server node and choosing Start.
            

In the Projects window, expand the Server Resources node in your EJB module.
            

For each of the resources we created, right-click the resource and select Register from the pop-up menu,
            and then click Register in the dialog box.
        
        
You can see if the resources are registered by expanding the application server node in the Runtime window
        and looking under the JMS Resources node.
        -->
创建 NewsEntity 实体类
在本练习中，我们将创建 NewsEntity 实体类。实体类是一个简单的 Java 类。在创建实体类时，IDE 会添加 @Entity 标注以将该类定义为实体类。当创建了类后，我们将在该类中创建字段以表示表中所需的数据。
每个实体类都必须具有一个主键。在创建实体类时，IDE 会添加 @Id 标注以声明要用作主键的字段。此外，IDE 还会添加 @Generated 标注以指定主 Id 的键生成策略。
要创建 NewsEntity 类，请执行以下操作：

在 "Project" 窗口中右键单击 EJB 模块，然后选择 "New" > "File/Folder" 以打开 "New File" 向导。

从 "Persistence" 类别中选择 "Entity Class"，然后单击 "Next"。

键入 NewsEntity 作为类名，键入 ejb 作为包名，并将 "Primary Key Type" 保留为 Long。单击 "Finish"。
单击 "Finish" 后，将在源代码编辑器中打开实体类 NewsEntity.java。在源代码编辑器中，请执行以下操作：

将以下字段声明添加到类中：   String title;
  String body;
                    

选择 "Refactor" > "Encapsulate Fields" 以便为每个字段生成 getter 和 setter 方法。在 "Encapsulate Fields" 对话框中，确保选中了字段 id、title 和 body 的 getter 和 setter 复选框。

在 "Encapsulate Fields" 对话框中单击 "Next"，然后在 "Output" 窗口的 "Refactoring" 标签中单击 "Do Refactoring"。IDE 将为各字段添加 getter 和 setter 方法，并将字段的可视性更改为 private。

保存对文件所做的更改。
在接下来的步骤中，我们将创建 NewMessage 消息驱动 Bean。
创建 NewMessage 消息驱动 Bean
现在我们将在 EJB 模块中创建 NewMessage 消息驱动 Bean。我们将使用 "New Message-Driven Bean" 向导创建 Bean。在该向导中，将在 "Mapped Name" 字段中输入 jms/NewMessage，以便将资源注入到类中。
要创建 NewMessage 消息驱动 Bean，请执行以下操作：

在 "Project" 窗口中右键单击 EJB 模块，然后选择 "New" > "File/Folder" 打开 "New File" 向导。

从 "Enterprise" 类别中，选择 "Message-Driven Beans"，然后单击 "Next"。

键入 NewMessage 作为类名。

从包下拉列表中选择 ejb。

在 "Mapped Name" 字段中输入 jms/NewMessage，然后单击 "Finish"。
单击 "Finish" 后，将在源代码编辑器中打开新建的消息驱动 Bean 类 NewMessage.java。您可以看到该类具有以下标注：
  @MessageDriven(mappedName = "jms/Queue")
此标注向容器说明：该组件是一个消息驱动 Bean 并且该 Bean 使用 JMS 资源。JMS 资源被映射到目标的 JNDI 名称，Bean 从该目标中接收消息。"New Message-Driven Bean" 向导已为我们创建了 JMS 资源。通过 EJB 3.0 API，我们可以从 Bean 类中查找 JNDI 名称空间中的对象，这样就不需要配置部署描述符来指定 JMS 资源了。
利用 EJB 3.0 软件，我们可以使用标注将资源直接引入类中。现在，我们准备使用标注将 MessageDrivenContext 资源引入类中，然后注入 PersistenceContext 资源，EntityManager API 将使用该资源来管理持久性实体实例。我们要在源代码编辑器中将标注添加到类中。

通过在字段声明列表中添加以下带标注的字段，将 MessageDrivenContext 资源注入到类中：   @Resource
  private MessageDrivenContext mdc;

在代码中单击鼠标右键，然后从弹出式菜单中选择 "Persistence" > "Use Entity Manager"，将实体管理器引入类中。
这会在源代码中添加以下标注：   @PersistenceContext
  private EntityManager em;并在代码中生成以下方法：   public void changeMyName(Object object) {
     // TODO:
     // em.persist(object);
  }

按如下所示修改 changeMyName 方法：   public void save(Object object) {
    em.persist(object);
  }

通过将以下代码添加到主体中来修改 onMessage 方法：     ObjectMessage msg = null;
    try {
        if (message instanceof ObjectMessage) {
            msg = (ObjectMessage) message;
            NewsEntity e = (NewsEntity) msg.getObject();
            save(e);
        }
    } catch (JMSException e) {
        e.printStackTrace();
        mdc.setRollbackOnly();
    } catch (Throwable te) {
        te.printStackTrace();
    }
            

按 Alt-Shift-F 组合键生成所有必要的 import 语句。在生成 import 语句时，我们希望导入 jms 库。

保存该文件。
创建会话 Bean
接下来，我们将为 NewsEntity 实体类创建一个会话 Facade。要创建会话 Facade，请执行以下操作：

右键单击 EJB 模块，然后选择 "New" > "File/Folder"。

从 "Persistence" 类别中，选择 "Session Facade"，然后单击 "Next"。

从可用的实体类列表中，选择 "NewsEntity"，单击 "Add"，然后单击 "Next"。

检查是否将源代码包设置为 ejb，并创建了本地接口。

单击 "Finish"。
单击 "Finish" 后，将创建会话 Facade 类 NewsEntityFacade.java，并在源代码编辑器中将其打开。IDE 还将创建本地接口 NewsEntityFacadeLocal.java。
EJB 3.0 技术通过减少所需的代码量来简化会话 Bean 的创建。您可以看到，标注 @Stateless 用于将类声明为无态会话 Bean 组件，并且该类不再需要实现 javax.ejb.SessionBean 的语句。此外，代码也更为简洁了，因为利用 EJB 3.0 技术，业务方法不再需要使用代码来声明其抛出了所检查到的异常。
您会看到，在创建会话 Facade 时，PersistenceContext 资源已直接注入到会话 Bean 组件中。
小结
在本练习中，我们已对 EJB 模块中的实体类和消息驱动 Bean 进行了编码，然后为实体类创建了会话 Facade。此外，我们还创建了应用程序使用的 JMS 资源。
对 Web 模块进行编码
现在，我们将在 Web 模块中创建 Servlet ListNews 和 PostMessage。这些 Servlet 将用于读取和添加消息。
创建 ListNews Servlet
在本练习中，我们将创建一个用于显示数据的简单 Servlet。我们将使用标注从 Servlet 中调用实体 Bean。

右键单击 Web 模块项目，然后选择 "New" > "Servlet"。

键入 ListNews 作为类名。

输入 web 作为包名，然后单击 "Finish"。
单击 "Finish" 后，将在源代码编辑器中打开类 ListNews.java。在源代码编辑器中，请执行以下操作：

在源代码中，单击鼠标右键，然后选择 "Enterprise Resources" > "Call Enterprise Bean"。

在 "Call Enterprise Bean" 对话框中，选择 "NewsEntityFacade"，然后单击 "OK"。单击 "OK" 后，将使用 @EJB 标注在 Servlet 中注入实体 Bean 资源。

取消代码的注释，并通过将下面以粗体显示的代码行添加到 processRequest 方法的主体中来修改该方法：   out.println("Servlet ListNews at " + request.getContextPath () + "");
  List news = newsEntityFacade.findAll();
  for (Iterator it = news.iterator(); it.hasNext();) {
    NewsEntity elem = (NewsEntity) it.next();
    out.println(" "+elem.getTitle()+"
");
    out.println(elem.getBody()+"
");
  }
  out.println("Add new message");
  out.println("");
               

按 Alt-Shift-F 组合键为类生成所有必要的 import 语句。在生成 import 语句时，我们希望从 util 包中导入类。

保存对文件所做的更改。
创建 PostMessage Servlet
在本练习中，我们将创建用于传递消息的 PostMessage Servlet。我们将使用标注将所创建的 JMS 资源直接注入 Servlet 中，并且指定变量名称及其映射到的名称。然后，添加用于发送 JMS 消息的代码，以及用于在 HTML 表单中添加消息的代码。

右键单击 Web 模块项目，然后选择 "New" > "Servlet"。

键入 PostMessage 作为类名。

输入 web 作为包名，然后单击 "Finish"。
单击 "Finish" 后，将在源代码编辑器中打开类 PostMessage.java。在源代码编辑器中，请执行以下操作：

通过添加以下字段声明，使用标注来注入 ConnectionFactory 和 Queue 资源：   public class PostMessage extends HttpServlet {
  @Resource(mappedName="jms/NewMessageFactory")
  private  ConnectionFactory connectionFactory;
  @Resource(mappedName="jms/NewMessage")
  private  Queue queue;
            

现在，通过将下面以粗体显示的代码添加到 processRequest 方法中，添加用于发送 JMS 消息的代码：   response.setContentType("text/html;charset=UTF-8");
  // Add the following code to send the JMS message
  String title=request.getParameter("title");
    String body=request.getParameter("body");
    if ((title!=null) && (body!=null)) {
        try {
            Connection connection = connectionFactory.createConnection();
            Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
            MessageProducer messageProducer = session.createProducer(queue);
            ObjectMessage message = session.createObjectMessage();
            // here we create NewsEntity, that will be sent in JMS message
            NewsEntity e = new NewsEntity();
            e.setTitle(title);
            e.setBody(body);
            message.setObject(e);
            messageProducer.send(message);
            response.sendRedirect("ListNews");
        } catch (JMSException ex) {
            ex.printStackTrace();
        }
  }
  PrintWriter out = response.getWriter();
            

现在，将对输出 HTML 的代码取消注释，并添加用于添加消息的 Web 表单。将下面以粗体显示的代码行添加到 processRequest 方法中：   out.println("Servlet PostMessage at " + request.getContextPath() + " ");
  // Add the following code to add the form to the web page
  out.println("");
  out.println("Title: ");
  out.println("Message: ");
  out.println("");
  out.println("");
  out.println("");
        

按 Alt-Shift-F 组合键为类生成所有必要的 import 语句。在选择 Connection、ConnectionFactory、Session 和 Queue 的 import 语句时，将导入 java.jms 库。

保存对文件所做的更改。
运行项目
现在可以运行项目了。在运行项目时，我们希望浏览器打开包含 ListNews Servlet 的页面。可以通过在企业应用程序的属性对话框中指定该页的 URL 来实现这一目的。该 URL 是应用程序的上下文路径的相对 URL。输入相对 URL 后，可以从项目窗口中生成、部署并运行应用程序。
要设置相对 URL 并运行应用程序，请执行以下操作：

在 "Projects" 窗口中，右键单击 "NewsApp" 企业应用程序节点，然后从弹出式菜单中选择 "Properties"。

在 "Categories" 窗格中选择 "Run"。

在 "Relative URL" 文本字段中，键入 /ListNews。

单击 "OK"。

在 "Projects" 窗口中，右键单击 "NewsApp" 企业应用程序节点，然后选择 "Run Project"。
运行项目时，将在浏览器中打开 ListNews Servlet，该 Servlet 用于显示数据库中的消息列表。如果您是第一次运行项目，则数据库为空，但是您可以单击 "Add Message" 来添加消息。

当您使用 PostMessage Servlet 添加消息时，消息会发送到消息驱动 Bean 以写入到持久性存储中，并会调用 ListNews Servlet 来显示数据库中的消息。由 ListNews 检索的数据库中的消息列表通常不包含新消息，这是因为消息服务是异步的。


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u/14788/showart_215066.html