設置環(huán)境

首先，需要在計算機上安裝 Sun Java System Application Server Platform Edition 8.2（下載）。

注意：如果在 JDK 5.0 中運行 IDE，則應用服務(wù)器還需要使用 JDK 5.0 中的虛擬機。要設置 IDE 使用的 JDK，請打開(kāi) IDE_INSTALL_DIR/etc/netbeans.conf，并在 netbeans_jdkhome 屬性中輸入 JDK 的路徑。要設置應用服務(wù)器使用的 JDK，請編輯 AS_INSTALL_DIR/config/asenv(.bat) 文件并更改 AS_JAVA 環(huán)境變量。

安裝應用服務(wù)器后，需要在 NetBeans IDE 中注冊該服務(wù)器。請注意，如果下載和安裝的 NetBeans IDE 版本與應用服務(wù)器捆綁在一起，則不必執行此步驟。IDE 知道捆綁的應用服務(wù)器的位置。

1. 轉到 NETBEANS_INSTALL_DIR/bin 目錄并運行 netbeans 命令以打開(kāi) NetBeans IDE 5.0。如果 java 不在 PATH 變量中，則在命令行中使用 --jdkhome /path/to/jdk 開(kāi)關(guān)來(lái)啟動(dòng) IDE，或將 netbeans_jdkhome="/path/to/jdk" 一行添加到 NETBEANS_INSTALL_DIR/etc/netbeans.conf 文件中。
2. 在 IDE 中，從主窗口選擇“工具”>“服務(wù)器管理器”。
3. 單擊“添加服務(wù)器”。選擇 "Sun Java System Application Server"，并為此實(shí)例指定一個(gè)名稱(chēng)。然后單擊“下一步”。
4. 指定應用服務(wù)器的安裝目錄（例如，C:\Sun\Appserver）。
5. 將“注冊本地缺省域”單選按鈕保持選中狀態(tài)，然后選擇一個(gè)域。
6. （可選）單擊“下一步”，輸入管理員用戶(hù)名和口令。如果不希望在 IDE 用戶(hù)目錄中存儲用戶(hù)名和口令，可以將這些字段保留為空。IDE 在每次需要此信息時(shí)會(huì )提示您輸入。
   注意：缺省管理員口令是 adminadmin。
7. 單擊“完成”。IDE 將注冊該服務(wù)器，并在“運行環(huán)境”窗口的“服務(wù)器”節點(diǎn)下面列出該服務(wù)器。

最后，啟動(dòng)應用服務(wù)器：

1. 在“運行環(huán)境”窗口中，右鍵單擊該應用服務(wù)器節點(diǎn)，然后選擇“啟動(dòng)服務(wù)器”。
2. 展開(kāi)應用服務(wù)器節點(diǎn)。該節點(diǎn)包含在應用服務(wù)器的管理控制臺中看到的所有類(lèi)別的子節點(diǎn)。通過(guò)右鍵單擊任意一個(gè)節點(diǎn)并選擇“屬性”，可對應用服務(wù)器進(jìn)行配置。

配置 Derby 數據庫

在本教程中，您將通過(guò) Derby 數據庫服務(wù)器中包含的其中一個(gè)表來(lái)生成 CMP Bean。Derby 數據庫服務(wù)器包含在 Sun Java System Application Server 8.2 下載文件中。

1. 在“運行環(huán)境”窗口中，展開(kāi)“數據庫”節點(diǎn)。您會(huì )看到 jdbc:derby://localhost:1527/sample 數據庫的節點(diǎn)。
   
2. 右鍵單擊 jdbc:derby://localhost:1527/sample 數據庫，然后選擇“連接”。如果系統提示您輸入口令，請鍵入 app 作為用戶(hù)名和口令，然后單擊“確定”。
3. 展開(kāi) sample 數據庫節點(diǎn)和“表”節點(diǎn)。確保其中包含 CUSTOMER 節點(diǎn)，如下所示。
   

   注意：如果修改了 sample 數據庫，可使用此 SQL 腳本對其進(jìn)行重寫(xiě)。

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

在本示例中，我們將創(chuàng )建一個(gè)企業(yè)應用程序項目作為 Web 模塊和 EJB 模塊的容器。通過(guò)使用企業(yè)應用程序模板，您可以自動(dòng)為 Web 模塊和 EJB 模塊創(chuàng )建項目。

1. 選擇“文件”>“新建項目”(Ctrl-Shift-N)，然后從“企業(yè)”類(lèi)別中選擇“企業(yè)應用程序”模板。單擊“下一步”。
2. 將應用程序命名為 CustomerBook，然后指定項目位置。將其余設置保持為缺省值，然后單擊“完成”。

生成 CMP 實(shí)體 Bean

現在，我們將生成訪(fǎng)問(wèn) sample 數據庫的實(shí)體 Bean。對于程序要訪(fǎng)問(wèn)的每個(gè)表，都需要一個(gè)對應的實(shí)體 Bean。

1. 在“項目”窗口中，右鍵單擊 EJB 模塊的節點(diǎn) (CustomerBook-EJBModule)，然后選擇“新建”>“通過(guò)數據庫生成 CMP 實(shí)體 Bean”。
2. 選擇“JDBC 連接”作為數據庫源，然后從組合框中選擇 jdbc:derby://localhost:1527/sample 連接。
3. 鍵入 ejb 作為包名，然后單擊“下一步”。向導將顯示選定數據庫中的所有表。
4. 選擇 CUSTOMER 表，單擊“添加”，然后單擊“完成”。
   IDE 將為 CUSTOMER 表以及從 CUSTOMER 引用的任何表 (DISCOUNT_CODE) 創(chuàng )建 CMP Bean。IDE 還會(huì )創(chuàng )建一個(gè)新的 JDBC 連接池和數據源，在部署項目時(shí)，將在應用服務(wù)器中注冊該連接池和數據源。

對會(huì )話(huà) Bean 進(jìn)行編碼

現在，我們將創(chuàng )建一個(gè)會(huì )話(huà) Bean，用來(lái)處理 Web 應用程序客戶(hù)端對實(shí)體 Bean 中的信息的訪(fǎng)問(wèn)。我們將創(chuàng )建一個(gè)空會(huì )話(huà) Bean，生成對實(shí)體 Bean 的調用，然后添加一些 business 方法。

1. 在“項目”窗口中，右鍵單擊 CustomerBook-EJBModule 項目節點(diǎn)，然后選擇“新建”>“會(huì )話(huà) Bean”。將該會(huì )話(huà) Bean 命名為 CustomerFacade，并將其放在 ejb 包中。將 Bean 設置為無(wú)態(tài) Bean，并且只有遠程接口。然后單擊“完成”。IDE 將創(chuàng )建此 Bean，并在源代碼編輯器中打開(kāi)其 Bean 類(lèi)。
2. 在源代碼編輯器中，在 Bean 類(lèi)中的任意位置單擊鼠標右鍵，選擇“企業(yè)資源”>“調用 Enterprise Bean”。選擇 CustomerEB Bean，然后單擊“確定”。IDE 將在源文件底部生成 lookupCustomerBean 方法。
3. 將以下內容添加到 Bean 類(lèi)起始位置的變量聲明中：

   private ejb.CustomerLocalHome custHome;

4. 現在，我們將在會(huì )話(huà) Bean 的 create 方法中獲取對實(shí)體 Bean 的 Home 接口的引用。刪除 ejbCreate() 中的注釋并添加以下語(yǔ)句：

   custHome = lookupCustomerBean();

5. 在 Bean 類(lèi)主體中的任意位置單擊鼠標右鍵，選擇“EJB 方法”>“添加 Business 方法”。指定以下信息：
   
   

   元素	值
   方法名	getCustomerInfo
   返回類(lèi)型	String
   參數	int custId
   異常	javax.ejb.FinderException

   
   
6. 在源代碼編輯器中，按如下內容編輯 getCustomerInfo business 方法：

   public String getCustomerInfo(int custId) throws javax.ejb.FinderException {    ejb.CustomerLocal customer = custHome.findByPrimaryKey(new Integer(custId));    return "Name: " + customer.getName() + ", E-mail: " +customer.getEmail();    }    

   最終的 CustomerFacadeBean.java 文件應如此處所示。

創(chuàng )建定制服務(wù)定位器

在上一節中，我們在調用 Enterprise Bean 時(shí)通過(guò) IDE 生成了內聯(lián)查找代碼。在此節中，我們將創(chuàng )建一個(gè)定制服務(wù)定位器，IDE 將在生成對 Enterprise Bean 的調用時(shí)用到它。我們的服務(wù)定位器沒(méi)有任何特殊功能，但您可以定制企業(yè)應用程序查找 Enterprise Bean 的方式。

1. 在“項目”窗口中，右鍵單擊 CustomerBook-WebModule 節點(diǎn)，然后選擇“新建”>“文件/文件夾”。在向導中，從“企業(yè)”類(lèi)別中選擇服務(wù)定位器模板。單擊“下一步”。
2. 鍵入 ServiceLocator 作為類(lèi)名，鍵入 Web 作為包，然后單擊“完成”。

對 Servlet 進(jìn)行編碼

在最后一步中，我們將向 Web 模塊添加一個(gè) Servlet，通過(guò)它可以查找并顯示 CUSTOMER 表中的每個(gè)客戶(hù)的信息。

1. 在“項目”窗口中，右鍵單擊 CustomerBook-WebModule 節點(diǎn)，然后選擇“新建”> "Servlet"。將 Servlet 命名為 CustomerDetail，然后將其放在 web 包中。然后單擊“完成”。
2. 在源代碼編輯器中，在 Servlet 類(lèi)中的任意位置單擊鼠標右鍵，選擇“企業(yè)資源”>“調用 Enterprise Bean”。選擇 CustomerFacade 會(huì )話(huà) Bean，將 web.ServiceLocator 類(lèi)設置為服務(wù)定位器策略，然后單擊“確定”。IDE 將插入該查找方法。
3. 按如下所示編輯 processRequest 方法：

   protected void processRequest(HttpServletRequest request, HttpServletResponse response)    throws ServletException, IOException {    response.setContentType("text/html");    PrintWriter out = response.getWriter();    out.println("<html>");    out.println("<head>");    out.println("<title>Servlet customerDetail</title>");    out.println("</head>");    out.println("<body>");    out.println("<h1>Servlet customerDetail at " + request.getContextPath () + "</h1>");    String customerNr = request.getParameter("customer_nr");    if((customerNr != null) && !(customerNr.equals("")))    {    try{    ejb.CustomerFacadeRemote custFacade = lookupCustomerFacadeBean();    out.println("Customer‘s info for nr. " + customerNr + ": " + custFacade.getCustomerInfo(    Integer.parseInt(customerNr)));    }catch(javax.ejb.FinderException ex){    out.println("Customer with nr. " + customerNr +" 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();    }    

   最終的 CustomerDetail.java Servlet 應如此處所示。

設置程序的缺省 Web 頁(yè)

缺省情況下，Web 應用程序在運行時(shí)會(huì )顯示其 index.jsp 頁(yè)。由于我們的 index.jsp 是空的，因此希望 CustomerBook 項目顯示 CustomerDetail Servlet。

1. 在“項目”窗口中，右鍵單擊 CustomerBook 項目，然后選擇“屬性”。接下來(lái)在左面板中單擊“運行”。
2. 在“相對 URL”字段中鍵入 /CustomerDetail。

運行應用程序

1. 右鍵單擊 CustomerBook 項目并選擇“運行項目”。IDE 會(huì )執行以下所有任務(wù)：
   • 生成企業(yè)應用程序項目及其所有子項目（Web 模塊項目和 EJB 模塊項目）。
   • 如果服務(wù)器尚未運行，請啟動(dòng)它。
   • 如果企業(yè)應用程序已部署到應用服務(wù)器上，請卸下它。
   • 將企業(yè)應用程序部署到應用服務(wù)器上。
   • 打開(kāi)在指定的相對 URL 中的 Web 模塊。

您應在外部瀏覽器中看到以下頁(yè)面。在鍵入某一客戶(hù)編號并按 Enter 鍵時(shí)，頁(yè)面中應顯示該客戶(hù)的信息。

疑難解答

一些常見(jiàn)問(wèn)題包括：

• 打開(kāi) CustomerDetail 時(shí)出現 HTTP Status 404 錯誤。這意味著(zhù)，應用服務(wù)器找不到 CustomerDetail Servlet。確保上下文根目錄 (/CustomerBook-WebModule) 與為 Web 模塊設置的根目錄匹配（右鍵單擊 Web 模塊項目節點(diǎn) >“屬性”>“運行”>“上下文路徑”）。
• 在 CustomerDetail 表單中提交客戶(hù)編號時(shí)出現 javax.transaction.TransactionRolledbackException: CORBA TRANSACTION_ROLLEDBACK 錯誤。這通常意味著(zhù)，服務(wù)器無(wú)法訪(fǎng)問(wèn)數據庫。如果出現這種情況，請執行以下操作：
  
  • 確保 Derby 數據庫服務(wù)器正在運行。要啟動(dòng) Derby，請選擇“工具”> "Derby" >“啟動(dòng) Derby 服務(wù)器”。
  • 確保在應用服務(wù)器中正確注冊了資源池和數據源。要對其進(jìn)行檢查，可轉到“運行環(huán)境”窗口并展開(kāi)應用服務(wù)器的 JDBC 節點(diǎn)。“JDBC 資源”節點(diǎn)應包含 jdbc/derby_net 節點(diǎn)；“連接池”節點(diǎn)應包含 derby_netConnectionPool 節點(diǎn)。注冊連接池和數據源（如果尚未注冊）：
    
    
    1. 展開(kāi) CustomerBook-EJBModule 項目的“服務(wù)器資源”節點(diǎn)。
    2. 右鍵單擊 connection-pool-derby_net.sun-resource 節點(diǎn)，然后選擇“注冊”。
    3. 對 datasource-jdbc_derby_net.sun-resource 節點(diǎn)執行相同的步驟。

注意：要查看服務(wù)器日志，請轉至“運行環(huán)境”窗口，右鍵單擊應用服務(wù)器節點(diǎn)，然后選擇“查看服務(wù)器日志”。