先決條件

本文檔假定您已具備了以下技術(shù)的一些基本知識或編程經(jīng)驗：

• Java 編程
• NetBeans IDE

本教程所需的軟件

在學(xué)習(xí)本教程之前，您需要在計算機中安裝以下軟件：

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

在學(xué)習(xí)本教程之前，您需要在 IDE 中注冊 Sun Java System Application Server 的本地實例。

教程練習(xí)

• 建立企業(yè)應(yīng)用程序項目
• 對 EJB 模塊進行編碼
• 對 Web 模塊進行編碼
• 運行項目
• 疑難解答

創(chuàng)建企業(yè)應(yīng)用程序

1. 從主菜單中選擇“文件”>“新建項目”(Ctrl-Shift-N)。
2. 從“企業(yè)”類別中選擇“企業(yè)應(yīng)用程序”，然后單擊“下一步”。
3. 將項目命名為 NewsApp，并將服務(wù)器設(shè)置為 Sun Java System Application Server。
4. 將 J2EE 版本設(shè)置為 "Java EE 5"，然后選中“創(chuàng)建 EJB 模塊”和“創(chuàng)建 Web 應(yīng)用程序模塊”（如果未選中）。
5. 單擊“完成”。

小結(jié)

在本練習(xí)中，我們創(chuàng)建了包含一個 EJB 模塊和一個 Web 模塊的 Java EE 5 企業(yè)應(yīng)用程序。

創(chuàng)建持久性單元

首先，我們將創(chuàng)建一個持久性單元，它用于定義在應(yīng)用程序中使用的數(shù)據(jù)源和實體管理器。

1. 右鍵單擊 EJB 模塊，然后選擇“新建”>“文件/文件夾”。
2. 從“持久性”類別中，選擇“持久性單元”，然后單擊“下一步”。
3. 保留缺省的持久性單元名稱。
4. 對于持久性提供程序，請選擇“TopLink（缺省）”。
5. 對于數(shù)據(jù)源，請選擇缺省的數(shù)據(jù)源 jdbc/sample。
6. 檢查是否為持久性單元選中了“使用 Java 事務(wù) API”，以及“表生成策略”是否設(shè)置為“創(chuàng)建”，以便在部署應(yīng)用程序時創(chuàng)建基于實體類的表。
7. 單擊“完成”。

單擊“完成”后，IDE 將創(chuàng)建 persistence.xml，并在源代碼編輯器中將其打開。關(guān)閉 persistence.xml。

創(chuàng)建 NewsEntity 實體類

在本練習(xí)中，我們將創(chuàng)建 NewsEntity 實體類。實體類是一個簡單的 Java 類。在創(chuàng)建實體類時，IDE 會添加 @Entity 標注以將該類定義為實體類。當創(chuàng)建了類后，我們將在該類中創(chuàng)建字段以表示表中所需的數(shù)據(jù)。

每個實體類都必須具有一個主鍵。在創(chuàng)建實體類時，IDE 會添加 @Id 標注以聲明要用作主鍵的字段。此外，IDE 還會添加 @Generated 標注以指定主 Id 的鍵生成策略。

要創(chuàng)建 NewsEntity 類，請執(zhí)行以下操作：

1. 在“項目”窗口中右鍵單擊 EJB 模塊，然后選擇“新建”>“文件/文件夾”打開“新建文件”向?qū)А?
2. 從“持久性”類別中，選擇“實體類”，然后單擊“下一步”。
3. 鍵入 NewsEntity 作為類名，鍵入 ejb 作為包名，并將“主鍵類型”保留為 Long。單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開實體類 NewsEntity.java。在源代碼編輯器中，請執(zhí)行以下操作：

1. 將以下字段聲明添加到類中：

   String title;
       String body;

2. 在源代碼編輯器中單擊鼠標右鍵，然后選擇“重構(gòu)”>“封裝字段”以便為每個字段生成 getter 和 setter。在“封裝字段”對話框中，確保選中了字段 id、title 和 body 的 getter 和 setter 復(fù)選框。
3. 在“封裝字段”對話框中單擊“下一步”，然后在“輸出”窗口的“重構(gòu)”標簽中單擊“執(zhí)行重構(gòu)”。IDE 將為各字段添加 getter 和 setter 方法，并將字段的可視性更改為 private。
4. 保存對文件所做的更改。

在接下來的步驟中，我們將創(chuàng)建 NewMessage 消息驅(qū)動 Bean。

創(chuàng)建 NewMessage 消息驅(qū)動 Bean

現(xiàn)在我們將在 EJB 模塊中創(chuàng)建 NewMessage 消息驅(qū)動 Bean。我們將使用“新建消息驅(qū)動 Bean”向?qū)韯?chuàng)建 Bean 和所需的 JMS 資源。

要創(chuàng)建 NewMessage 消息驅(qū)動 Bean，請執(zhí)行以下操作：

1. 在“項目”窗口中右鍵單擊 EJB 模塊，然后選擇“新建”>“文件/文件夾”以打開“新建文件”向?qū)А?
2. 從“企業(yè)”類別中，選擇“消息驅(qū)動 Bean”，然后單擊“下一步”。
3. 鍵入 NewMessage 作為類名。
4. 從“包”下拉列表中選擇 "ejb"。
5. 選擇“隊列”作為目標類型，然后單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開新建的消息驅(qū)動 Bean 類 NewMessage.java。您可以看到該類具有以下標注：

@MessageDriven(mappedName = "jms/NewMessage")

此標注向容器說明：該組件是一個消息驅(qū)動 Bean 并且該 Bean 使用 JMS 資源。當 IDE 生成類時，將從類 (NewMessage.java) 名稱派生資源的映射名 (jms/NewMessage)。JMS 資源被映射到目標的 JNDI 名稱，Bean 從該目標中接收消息。“新建消息驅(qū)動 Bean”向?qū)б褳槲覀儎?chuàng)建了 JMS 資源。通過 EJB 3.0 API，我們可以從 Bean 類中查找 JNDI 名稱空間中的對象，這樣就不需要配置部署描述符來指定 JMS 資源了。

EJB 3.0 規(guī)范允許您使用標注將資源直接引入類中。現(xiàn)在，我們準備使用標注將 MessageDrivenContext 資源引入類中，然后注入 PersistenceContext 資源，EntityManager API 將使用該資源來管理持久性實體實例。我們要在源代碼編輯器中將標注添加到類中。

1. 通過在類中添加以下帶標注的字段（以粗體顯示），將 MessageDrivenContext 資源注入到類中：

   public class NewMessage implements MessageListener {
       @Resource
       private MessageDrivenContext mdc;

2. 在代碼中單擊鼠標右鍵，然后從彈出式菜單中選擇“持久性”>“使用實體管理器”，將實體管理器引入類中。
   這會在源代碼中添加以下標注：

   @PersistenceContext
       private EntityManager em;

   并在代碼中生成以下方法：

   public void persist(Object object) {
       // TODO:
       // em.persist(object);
       }

3. 按如下所示修改 persist 方法：

   public void save(Object object) {
       em.persist(object);
       }

4. 通過將以下代碼添加到主體中來修改 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();
       }

5. 按 Alt-Shift-F 組合鍵生成所有必要的 import 語句。在生成 import 語句時，我們需要確保導(dǎo)入 jms 和 javax.annotation.Resource; 庫。
6. 保存該文件。

創(chuàng)建會話 Bean

接下來，我們將為 NewsEntity 實體類創(chuàng)建一個會話 Facade。要創(chuàng)建會話 Facade，請執(zhí)行以下操作：

1. 右鍵單擊 EJB 模塊，然后選擇“新建”>“文件/文件夾”。
2. 從“持久性”類別中，選擇“實體類的會話 Bean”，然后單擊“下一步”。
3. 從可用的實體類列表中，選擇 "NewsEntity"，單擊“添加”，然后單擊“下一步”。
4. 檢查是否將包設(shè)置為 ejb 以及是否選中了創(chuàng)建本地接口。
5. 單擊“完成”。

單擊“完成”后，將創(chuàng)建會話 Facade 類 NewsEntityFacade.java，并在源代碼編輯器中將其打開。IDE 還將創(chuàng)建本地接口 NewsEntityFacadeLocal.java。

EJB 3.0 技術(shù)通過減少所需的代碼量來簡化會話 Bean 的創(chuàng)建。您可以看到，標注 @Stateless 用于將類聲明為無態(tài)會話 Bean 組件，并且該類不再需要實現(xiàn) javax.ejb.SessionBean 的語句。此外，代碼也更為簡潔了，因為利用 EJB 3.0 技術(shù)，業(yè)務(wù)方法不再需要使用代碼來聲明其拋出了所檢查到的異常。

您會看到，在創(chuàng)建會話 Facade 時，PersistenceContext 資源已直接注入到會話 Bean 組件中。

小結(jié)

在本練習(xí)中，我們已對 EJB 模塊中的實體類和消息驅(qū)動 Bean 進行了編碼，然后為實體類創(chuàng)建了會話 Facade。此外，我們還創(chuàng)建了應(yīng)用程序使用的 JMS 資源。

創(chuàng)建 ListNews Servlet

在本練習(xí)中，我們將創(chuàng)建一個用于顯示數(shù)據(jù)的簡單 Servlet。我們將使用標注從 Servlet 中調(diào)用實體 Bean。

1. 右鍵單擊 Web 模塊項目，然后選擇“新建”> "Servlet"。
2. 鍵入 ListNews 作為類名。
3. 輸入 web 作為包名，然后單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開類 ListNews.java。在源代碼編輯器中，請執(zhí)行以下操作：

1. 在源代碼中，單擊鼠標右鍵，然后選擇“企業(yè)資源”>“調(diào)用 Enterprise Bean”。
2. 在“調(diào)用 Enterprise Bean”對話框中，選擇 "NewsEntityFacade"，然后單擊“確定”。單擊“確定”后，將使用 @EJB 標注在 Servlet 中注入實體 Bean 資源。
3. 在 processRequest 方法中，對其進行如下修改：取消代碼注釋，然后將下面以粗體顯示的行添加到方法主體中。

   out.println("<h1>Servlet ListNews at " + request.getContextPath () + "</h1>");
       List news = newsEntityFacade.findAll();
       for (Iterator it = news.iterator(); it.hasNext();) {
       NewsEntity elem = (NewsEntity) it.next();
       out.println(" <b>"+elem.getTitle()+" </b><br />");
       out.println(elem.getBody()+"<br /> ");
       }
       out.println("<a href='PostMessage'>Add new message</a>");
       out.println("</body>");
       

4. 按 Alt-Shift-F 組合鍵為類生成所有必要的 import 語句。在生成 import 語句時，我們希望從 util 包中導(dǎo)入類。
5. 保存對文件所做的更改。

創(chuàng)建 PostMessage Servlet

在本練習(xí)中，我們將創(chuàng)建用于傳遞消息的 PostMessage Servlet。我們將使用標注將所創(chuàng)建的 JMS 資源直接注入 Servlet 中，并且指定變量名稱及其映射到的名稱。然后，添加用于發(fā)送 JMS 消息的代碼，以及用于在 HTML 表單中添加消息的代碼。

1. 右鍵單擊 Web 模塊項目，然后選擇“新建”> "Servlet"。
2. 鍵入 PostMessage 作為類名。
3. 輸入 web 作為包名，然后單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開類 PostMessage.java。在源代碼編輯器中，請執(zhí)行以下操作：

1. 通過添加下面以粗體顯示的字段聲明，使用標注來注入 ConnectionFactory 和 Queue 資源：

   public class PostMessage extends HttpServlet {
       @Resource(mappedName="jms/NewMessageFactory")
       private  ConnectionFactory connectionFactory;
       @Resource(mappedName="jms/NewMessage")
       private  Queue queue;

2. 現(xiàn)在，通過將下面以粗體顯示的代碼添加到 processRequest 方法中，添加用于發(fā)送 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);
       messageProducer.close();
       connection.close();
       response.sendRedirect("ListNews");
       } catch (JMSException ex) {
       ex.printStackTrace();
       }
       }
       PrintWriter out = response.getWriter();
       

3. 現(xiàn)在，將對輸出 HTML 的代碼取消注釋，并添加用于添加消息的 Web 表單。將下面以粗體顯示的代碼行添加到 processRequest 方法中：

   out.println("Servlet PostMessage at " + request.getContextPath() + "</h1>");
       // Add the following code to add the form to the web page
       out.println("<form>");
       out.println("Title: <input type='text' name='title'><br/>");
       out.println("Message: <textarea name='body'></textarea><br/>");
       out.println("<input type='submit'><br/>");
       out.println("</form>");
       out.println("</body>");
       

4. 按 Alt-Shift-F 組合鍵為類生成所有必要的 import 語句。在選擇 Connection、ConnectionFactory、Session 和 Queue 的 import 語句時，將導(dǎo)入 java.jms 庫。
5. 保存對文件所做的更改。

JMS 資源問題

使用向?qū)韯?chuàng)建 JMS 資源時，您可能會在輸出窗口中看到以下服務(wù)器錯誤消息：

[com.sun.enterprise.connectors.ConnectorRuntimeException:
JMS resource not created : jms/Queue]

此消息可能表明沒有創(chuàng)建 JMS 資源，或者沒有在應(yīng)用服務(wù)器中注冊該資源。您可以使用 Sun Java System Application Server 管理控制臺來檢查、創(chuàng)建以及編輯 JMS 資源。

要打開管理控制臺，請執(zhí)行以下操作：

1. 在 IDE 的“運行環(huán)境”中，展開“服務(wù)器”節(jié)點以確認 Sun Java System Application Server 正在運行。"Sun Java System Application Server" 節(jié)點旁邊的小綠色箭頭表示服務(wù)器正在運行。
2. 右鍵單擊 "Sun Java System Application Server" 節(jié)點，然后選擇“查看管理控制臺”以在瀏覽器中打開登錄窗口。
3. 登錄到 Sun Java System Application Server。缺省的用戶名為 admin，口令為 adminadmin。
4. 在瀏覽器的管理控制臺中，依次展開左框架中的“資源”節(jié)點和“JMS 資源”節(jié)點。
5. 在左框架中單擊“連接工廠”和“目標資源”鏈接以檢查是否在服務(wù)器中注冊了這些資源，并在必要時修改這些資源。如果這些資源不存在，您可以在管理控制臺中創(chuàng)建這些資源。

您需要確保將 PostMessage Servlet 中的 JMS 連接工廠資源映射到在 Sun Java System Application Server 中注冊的 JMS 連接工廠資源的對應(yīng) JNDI 名稱上。

應(yīng)在 Sun Java System Application Server 中注冊以下資源：

• 具有 JNDI 名稱 jms/NewMessage 和類型 javax.jms.Queue 的目標資源
• 具有 JNDI 名稱 jms/NewMessageFactory 和類型 javax.jms.QueueConnectionFactory 的連接工廠資源