使用 EGL 建立 Hello World 服務 >
< 上一個課程 | 下一個課程 >

第 3 課:建立 EGL 服務用戶端

下一步是要建立用戶端專案以使用該服務。 當您在這個指導教學中建立的用戶端位於相同的工作區中時,您可以假定該用戶端位於完全獨立的位置,或不同的平台上。由於服務和用戶端不需要採用相同的程式碼語言進行撰寫,所以您還可以假定此用戶端應用程式是採用不同的語言進行撰寫的,或使用完全不同的工具集進行建立的。

顯示說明文件

  1. 按一下檔案 > 新建 > 專案。
  2. 展開 EGL 並按一下 EGL 專案。
  3. 按下一步。
  4. 將新的 EGL 專案命名為 EGLClient。
  5. 按一下 Web 專案。
  6. 按下一步。
  7. 請確保已選取建立新的建置描述子。 除非您使用 WAS 且先前已變更了設定以停用新增專案至 EAR 的功能,否則您不需變更進階設定。
  8. 您可能會看到一個視窗,詢問您是否要切換至 J2EE 視景。如果您看到此視窗,請按一下否。

建立用戶端網頁

若要使用服務,您將在用戶端中建立網頁,以擷取輸入、將該輸入傳遞至服務,並顯示服務中的輸出。 您將從建立「JSF 處理程式」(一種 EGL 邏輯類型,用於控制網頁)開始,然後,EGL 將建立網頁以符合此「JSF 處理程式」。
  1. 在「專案瀏覽器」視圖中,按一下 EGLClient 專案以選取該專案。
  2. 按一下檔案 > 新建 > 其他。
  3. 展開 EGL 並按一下 JSF 處理程式。
  4. 按下一步。
  5. 在「新建 EGL JSF 處理程式」視窗中,請確保已將來源資料夾欄位設為專案的 EGLSource 資料夾:
    EGLClient\EGLSource
  6. 在套件欄位中,請輸入此名稱:
    jsfhandlers
  7. 在 EGL 原始檔名稱欄位中,輸入此名稱:
    ClientPage
    該視窗與此圖片相似:
    「新建 EGL JSF 處理程式」視窗
  8. 按一下完成。 這時會在編輯器中開啟新的 JSF 處理程式。

    除非這些指示告知您進行儲存,否則請不要儲存檔案。儲存「JSF 處理程式」時,EGL 會檢查 view 內容中所參照的網頁是否存在。如果不存在,則 EGL 會根據「JSF 處理程式」中的變數以及這些變數的 DisplayUse 內容,自動建立該檔案並新增欄位。如果在新增所有變數之前儲存了該檔案,則新的網頁將不包括所有變數。如果發生這種情況,您可以刪除 JSP 檔(而不是「JSF 處理程式」檔)並再次產生「JSF 處理程式」以取得新的網頁。

  9. 從新的「JSF 處理程式」中移除範例程式碼,以便只保留下列程式碼:
    package jsfhandlers;
    
    handler ClientPage type JSFHandler
       {view = "jspLocation/jspName.jsp"}
       
    end
  10. 將 view 內容的值設為 ClientPage.jsp,如此範例所示:
    {view = "ClientPage.jsp"}
  11. 在「JSF 處理程式」內,建立下列變數:
    name string {DisplayUse = input};
    city string {DisplayUse = input};
    output string {DisplayUse = output};
  12. 在變數下面,新增此函數:
    function getHello()
    
    end
    您將稍後新增程式碼至此函數。 「JSF 處理程式」與此圖片相似:
    「JSF 處理程式」中的程式碼
  13. 儲存檔案。 儲存檔案時,EGL 會自動從該檔案建立網頁。會使用 view 內容的值來命名此檔案 (ClientPage.jsp),且該檔案位於專案的 WebContent 資料夾內。
    如果未取得 JSP 檔,則表示未將 EGL 配置成自動產生「JSF 處理程式」組件。 請手動產生「JSF 處理程式」,方法是在「專案瀏覽器」視圖或 EGL 編輯器中用滑鼠右鍵按一下「JSF 處理程式」,然後按一下產生。 然後,遵循這些其他步驟來設定「JSF 處理程式」的自動產生功能:
    1. 按一下視窗 > 喜好設定。
    2. 在「喜好設定」視窗中,展開 EGL 並按一下產生。
    3. 在「產生」頁面上,選取處理程式勾選框。
    4. 按一下確定。

    現在,當您儲存檔案時,將自動產生「JSF 處理程式」。

  14. 在編輯器中開啟 ClientPage.jsp 檔。 此頁面上具有欄位,基於您在「JSF 處理程式」中建立的變數。 這些欄位已預先連結至變數。這樣,當頁面上這些欄位的值變更時,變數將變更以與之相符。同樣地,當「JSF 處理程式」中的變數值變更時,頁面上的欄位值也將變更以與之相符。

    此頁面還包含數個錯誤訊息欄位。這不表示您的頁面包含錯誤;當您執行該頁面時,如果頁面上有任何錯誤,則這些欄位將顯示頁面上的錯誤。

  15. 找出「頁面資料」視圖。如果找不到此視圖,請按一下視窗 > 顯示視圖 > 頁面資料。此視圖會顯示適用於您頁面的資料,包括您在「JSF 處理程式」中建立的變數。它還會顯示顯示「JSF 處理程式」中的函數。
  16. 在「頁面資料」視圖中,展開 JSF 處理程式 > 動作,並尋找 getHello() 函數。
  17. 將 getHello() 函數從「頁面資料」視圖直接拖曳到頁面底端。 這時,已連結至該函數的按鈕會出現在頁面上。當使用者在執行時期按下頁面上的按鈕時,「JSF 處理程式」中的函數將執行。
  18. 儲存頁面。
該頁面與此圖片相似:
用戶端網頁的外觀

現在,您已有可立即使用 Web 服務的網頁。在下一課程中,您將設定專案以透過此網頁用來作為服務的用戶端。

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