< 上一個課程 | 下一個課程 >

第 3 課:開發一個存取 EJB 的 Web 軟體組

關於這項作業

在前一課中,您將 EJB 顯露成 OSGi 服務。在本課程中,您將開發一個會存取服務的 Web 軟體組。您將建立軟體組、將資訊清單配置成匯入必要的套件、開發 Servlet 以便將 EJB 當成 OSGi 服務來存取,以及建立 HTML 頁面,以透過瀏覽器來存取應用程式。

建立 Web 軟體組專案

關於這項作業

在本節中,您將建立一個具備 Web 3.0 支援的 OSGi 軟體組,並將該軟體組新增至 ConverterApp OSGi 應用程式。

程序

  1. 開啟 OSGi 軟體組專案精靈。 按一下檔案 > 新建 > OSGi 軟體組專案。即會開啟精靈。
  2. 建立專案。 在精靈中輸入或選取下列值:
    專案名稱
    Web
    目標執行時期
    WebSphere Application Server 8.5 版。
    新增 Web 支援(選取這個勾選框,並選取下列值)
    Web 3.0。
    將軟體組新增至應用程式(選取這個勾選框,並選取下列應用程式)
    ConverterApp
    建立 Web 軟體組專案
  3. 按一下完成。隨即建立專案。

配置 Web 專案中的軟體組資訊清單,以便從 EJBClient 專案匯入套件

關於這項作業

在本節中,您將針對 EJBClient 專案中的 com.ibm.example 套件,在資訊清單的 Import-Package 標頭中新增其項目。com.ibm.example 套件含有您為 EJB 所開發的介面。

程序

  1. 開啟資訊清單。 在 Web 專案中,按兩下資訊清單:Web。即會開啟資訊清單編輯器。
  2. 新增 com.ibm.example 套件的相依關係。 按一下相依關係標籤。在匯入的套件區段中,按一下新增。即會開啟「選取套件」對話框。在匯出的套件欄位中,輸入 com.ibm.example。從套件清單中選取 com.ibm.example,並按一下確定。
    新增相依關係

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

    匯入的套件

  3. 儲存變更。

建立 Servlet

關於這項作業

在本節中,您將使用 Servlet 精靈來建立起始 Servlet。

程序

  1. 開啟 Servlet 精靈。 用滑鼠右鍵按一下 Web 專案,並選取新建 > Servlet。即會開啟 Servlet 精靈。
  2. 建立 Servlet。 在精靈中輸入或選取下列值:
    專案
    Web
    Java™ 套件
    com.ibm.example.servlets
    類別名稱
    ConverterServlet

    按一下完成。會在 Web 專案中建立 ConverterServlet。

開發 Servlet

關於這項作業

在本節中,您將開發 Servlet,並且包含程式碼,以便將 EJB 當成 OSGi 服務來存取。

程序

  1. 在 Java 編輯器中開啟 Servlet。 如果 Servlet 未在編輯器中開啟,請在 Web 專案中展開 Java Resources/src 資料夾。在 com.ibm.example.servlets 套件中,按兩下 ConverterServlet。
  2. 新增 import 陳述式。 新增下列 import 陳述式至原始檔開頭的匯入區段:
    import com.ibm.example.EJBConverterLocal;
    import java.io.PrintWriter;
    import java.text.NumberFormat;
    import javax.naming.InitialContext;
    import javax.naming.NamingException;
  3. 開發 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 服務來存取:
    EJBConverterLocal converter = (EJBConverterLocal) context.lookup("osgi:service/" + EJBConverterLocal.class.getName());
    要轉換的溫度值會藉由 temperature 參數傳遞給 Servlet。此值會轉換成 Double,稱為 degrees,可供 converter 物件中的 convertToCelsius() 和 convertToFahrenheit() 方法處理。
    註: 如果您想使用遠端介面,請調整您的 JNDI 查閱碼。舉例來說,您可以用下列格式來撰寫先前說明的環境定義查閱區段:
    EJBConverterRemote converter = (EJBConverterRemote) context.lookup("osgi:service/" + EJBConverterRemote.class.getName() + "/(service.exported.interfaces=*)");
  4. 開發 doPost() 方法。 以下列程式碼取代自動產生的 doPost() 方法。取代自動產生的 doPost() 方法,可確保 POST 和 GET 要求都可從瀏覽器呼叫 Servlet。呼叫 doPost() 時,會自動執行 doGet() 方法。
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    	doGet(request, response);
    }
  5. 檢查您的工作。 下列程式碼是已完成的 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);
    		}
    }
  6. 儲存變更。

建立 HTML 檔,以存取應用程式

關於這項作業

在本節中,您將建立 index.html HTML 檔,其中含有用來輸入值的表單,以便提交給 Servlet 進行轉換。

程序

  1. 開啟新建網頁精靈。 用滑鼠右鍵按一下 Web 專案,並選取新建 > 網頁。即會開啟「新建網頁」精靈。
  2. 建立網頁。 在精靈中的檔名欄位內,輸入 index.html。在範本區段中,選取 HTML。按一下完成。會建立頁面,並在編輯器中開啟。
    新建網頁
  3. 選取網頁編輯器的原始檔標籤。
  4. 更新原始檔。 以下列程式碼取代預設原始碼:
    <!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() 函數會驗證要提交的值,以確定所輸入的是數值。

< 上一個課程 | 下一個課程 >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: osgi_ejb_3.html