第 3 課:開發一個存取 EJB 的 Web 軟體組
關於這項作業
建立 Web 軟體組專案
關於這項作業
程序
- 開啟 OSGi 軟體組專案精靈。 按一下檔案 > 新建 > OSGi 軟體組專案。即會開啟精靈。
- 建立專案。 在精靈中輸入或選取下列值:
- 專案名稱
- Web
- 目標執行時期
- WebSphere Application Server 8.5 版。
- 新增 Web 支援(選取這個勾選框,並選取下列值)
- Web 3.0。
- 將軟體組新增至應用程式(選取這個勾選框,並選取下列應用程式)
- ConverterApp

- 按一下完成。隨即建立專案。
配置 Web 專案中的軟體組資訊清單,以便從 EJBClient 專案匯入套件
關於這項作業
程序
- 開啟資訊清單。 在 Web 專案中,按兩下資訊清單:Web。即會開啟資訊清單編輯器。
- 新增 com.ibm.example 套件的相依關係。 按一下相依關係標籤。在匯入的套件區段中,按一下新增。即會開啟「選取套件」對話框。在匯出的套件欄位中,輸入 com.ibm.example。從套件清單中選取 com.ibm.example,並按一下確定。

會在「匯入的套件」區段中新增 com.ibm.example 的相依關係。請注意,由於將軟體組專案配置成具備 Web 3.0 支援,因此已額外新增 Servlet 套件(例如 javax.servlet)的匯入項目。

- 儲存變更。
建立 Servlet
關於這項作業
程序
- 開啟 Servlet 精靈。 用滑鼠右鍵按一下 Web 專案,並選取新建 > Servlet。即會開啟 Servlet 精靈。
- 建立 Servlet。 在精靈中輸入或選取下列值:
- 專案
- Web
- Java™ 套件
- com.ibm.example.servlets
- 類別名稱
- ConverterServlet
按一下完成。會在 Web 專案中建立 ConverterServlet。
開發 Servlet
關於這項作業
程序
- 在 Java 編輯器中開啟 Servlet。 如果 Servlet 未在編輯器中開啟,請在 Web 專案中展開 Java Resources/src 資料夾。在 com.ibm.example.servlets 套件中,按兩下 ConverterServlet。
- 新增 import 陳述式。 新增下列 import 陳述式至原始檔開頭的匯入區段:
import com.ibm.example.EJBConverterLocal; import java.io.PrintWriter; import java.text.NumberFormat; import javax.naming.InitialContext; import javax.naming.NamingException; - 開發 doGet() 方法。 Servlet 含有基本 doGet() 方法。請以下列方法取代自動產生的方法:
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { PrintWriter w = response.getWriter(); NumberFormat nf = NumberFormat.getInstance(); nf.setMaximumFractionDigits(2); try { InitialContext context = new InitialContext(); EJBConverterLocal converter = (EJBConverterLocal) context .lookup("osgi:service/" + EJBConverterLocal.class.getName()); String temperature = request.getParameter("temperature"); if (temperature == null) { w.println("<p>A temperature value was not specified.</p>"); } else if (!temperature.matches("[-+]?[0-9]*\\.?[0-9]+")) { w.println("Invalid temperature specified."); } else { double degrees = Double.parseDouble(temperature); double celsius = converter.convertToCelsius(degrees); w.println("<p>" + temperature + " degrees fahrenheit is " + nf.format(celsius) + " degrees celsius</p>"); double fahrenheit = converter.convertToFahrenheit(degrees); w.println("<p>" + temperature + " degrees celsius is " + nf.format(fahrenheit) + " degrees fahrenheit</p>"); } w.println("<a href='index.html'>Back</a>"); } catch (NamingException e) { w.println(e.getMessage()); } catch (NumberFormatException e) { w.println("An incorrect temperature was specified"); } }註: 此程式碼的注意事項:Servlet 會建立一個稱為 converter 的 EJBConverterLocal 物件。請回想一下,EJBConverterLocal 是您建立的介面,其中含有兩個溫度轉換方法:convertToCelsius() 和 convertToFahrenheit()。下列的程式碼行是處理物件的建立,以便將 EJB 當成 OSGi 服務來存取:
要轉換的溫度值會藉由 temperature 參數傳遞給 Servlet。此值會轉換成 Double,稱為 degrees,可供 converter 物件中的 convertToCelsius() 和 convertToFahrenheit() 方法處理。EJBConverterLocal converter = (EJBConverterLocal) context.lookup("osgi:service/" + EJBConverterLocal.class.getName());註: 如果您想使用遠端介面,請調整您的 JNDI 查閱碼。舉例來說,您可以用下列格式來撰寫先前說明的環境定義查閱區段:EJBConverterRemote converter = (EJBConverterRemote) context.lookup("osgi:service/" + EJBConverterRemote.class.getName() + "/(service.exported.interfaces=*)"); - 開發 doPost() 方法。 以下列程式碼取代自動產生的 doPost() 方法。取代自動產生的 doPost() 方法,可確保 POST 和 GET 要求都可從瀏覽器呼叫 Servlet。呼叫 doPost() 時,會自動執行 doGet() 方法。
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request, response); } - 檢查您的工作。 下列程式碼是已完成的 Servlet 程式碼:
package com.ibm.example.servlets; import java.io.IOException; import java.io.PrintWriter; import java.text.NumberFormat; import javax.naming.InitialContext; import javax.naming.NamingException; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import com.ibm.example.EJBConverterLocal; @WebServlet("/ConverterServlet") public class ConverterServlet extends HttpServlet { private static final long serialVersionUID = 1L; public ConverterServlet() { super(); } protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { PrintWriter w = response.getWriter(); NumberFormat nf = NumberFormat.getInstance(); nf.setMaximumFractionDigits(2); try { InitialContext context = new InitialContext(); EJBConverterLocal converter = (EJBConverterLocal) context .lookup("osgi:service/" + EJBConverterLocal.class.getName()); String temperature = request.getParameter("temperature"); if (temperature == null) { w.println("<p>A temperature value was not specified.</p>"); } else if (!temperature.matches("[-+]?[0-9]*\\.?[0-9]+")) { w.println("Invalid temperature specified."); } else { double degrees = Double.parseDouble(temperature); double celsius = converter.convertToCelsius(degrees); w.println("<p>" + temperature + " degrees fahrenheit is " + nf.format(celsius) + " degrees celsius</p>"); double fahrenheit = converter.convertToFahrenheit(degrees); w.println("<p>" + temperature + " degrees celsius is " + nf.format(fahrenheit) + " degrees fahrenheit</p>"); } w.println("<a href='index.html'>Back</a>"); } catch (NamingException e) { w.println(e.getMessage()); } catch (NumberFormatException e) { w.println("An incorrect temperature was specified"); } } protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request, response); } } - 儲存變更。
建立 HTML 檔,以存取應用程式
關於這項作業
程序
- 開啟新建網頁精靈。 用滑鼠右鍵按一下 Web 專案,並選取新建 > 網頁。即會開啟「新建網頁」精靈。
- 建立網頁。 在精靈中的檔名欄位內,輸入 index.html。在範本區段中,選取 HTML。按一下完成。會建立頁面,並在編輯器中開啟。

- 選取網頁編輯器的原始檔標籤。
- 更新原始檔。 以下列程式碼取代預設原始碼:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>OSGi EJB Temperature Converter</title> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <script type="text/javascript"> function validate(form) { var temperature = new Number(form.temperature.value); if (isNaN(temperature)) { alert("Please enter a valid number."); return false; } return true; } </script> </head> <body> <form action="ConverterServlet" method="post" onsubmit="return validate(this);"> Enter a temperature value: <br/> <input type="text" id="temperature" name="temperature"/> <br/> <br/> <input type="submit" value="Submit"/> </form> </body> </html>此 HTML 含有表單,可將 temperature 參數值提交給 ConverterServlet。在傳送給 Servlet 之前,validate() 函數會驗證要提交的值,以確定所輸入的是數值。