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

第 2 課:設定服務

在已撰寫此服務的程式碼之後,您可以將其作為 Web 服務提供給其他應用程式使用。如果採用這種方式來提供服務,則涉及建立服務連結資訊,該資訊會告知其他應用程式在哪裡尋找該服務,以及該服務中有哪些函數可用。服務會將此資訊作為「Web 服務說明語言 (WSDL)」檔進行發佈。

作為 Web 服務的替代方案,EGL 用戶端應用程式可以存取作為 EGL 服務的 EGL 服務應用程式。這種方法比 Web 服務提供更好的效能,但是只能在兩個 EGL 應用程式之間使用這種方法。 為了廣泛的相容性,這個指導教學使用 Web 服務,它們可在兩個 EGL 應用程式、兩個非 EGL 應用程式或 EGL 應用程式與非 EGL 應用程式之間使用。如需相關資訊,請按一下說明 > 說明內容,來參閱 EGL 文件。

服務連結資訊包含在 EGL 部署描述子中。在這些步驟中,您會處理專案的部署描述子,並將專案的建置描述子配置成使用該部署描述子。

顯示說明文件

驗證部署描述子和建置描述子

建立 EGL 專案時,您已自動建立名為 EGLService.egldd 的部署描述子檔案。然後,建立服務時,已選取建立為 Web 服務勾選框,該勾選框會自動新增服務至部署描述子。在此小節中,您將驗證這些設定。
  1. 在「專案導覽器」視圖中,展開 EGLService 專案和 EGLSource 資料夾。透過按兩下 EGLService.egldd 檔來開啟 EGL 部署描述子檔案。
  2. 在 EGL 部署描述子編輯器中,按一下 Web 服務部署標籤。
  3. 請確保您的服務顯示在要部署為 Web 服務的服務清單中,如下圖所示:
    用於顯示 Web 服務連結資訊的 EGL 部署描述子檔案
  4. 關閉部署描述子檔案。
  5. 按兩下專案的建置描述子,以在建置組件編輯器中開啟它。 此檔案名為 EGLService.eglbld,位於專案的 EGLSource 資料夾。建置描述子檔案包含建置描述子選項,這些選項說明 EGL 如何將您的專案產生為輸出語言。
  6. 在建置描述子選項清單中,找到名為 deploymentDescriptor 的選項。 請注意,已將其設為部署描述子的名稱,依預設該部署描述子與專案具有相同的名稱。必須使用這種方法來參照部署描述子,才能使用部署描述子。 建置組件編輯器與此圖片相似:
    用於顯示 deploymentDescriptor 選項(已設為部署描述子的名稱)的建置組件編輯器
  7. 關閉建置描述子。
  8. 產生整個專案,方法是在「專案瀏覽器」視圖中用滑鼠右鍵按一下專案,然後按一下產生。

產生 WSDL 檔

WSDL 檔將服務的相關資訊傳達至用戶端,以說明服務中提供的函數並指定服務的位置。在此小節中,您將從服務產生 WSDL 檔。 稍後,您的用戶端應用程式將匯入此 WSDL 檔,並使用其中的資訊。

EGL 使用部署描述子檔案中的資訊以及服務組件本身,來產生 WSDL 檔,但它還需要一段資訊:伺服器將用於管理該服務的埠。依預設,該埠為 9080。請遵循下列步驟來找出您伺服器的埠號:

  1. 開啟「伺服器」視圖。 如果找不到「伺服器」視圖,請按一下視窗 > 顯示視圖 > 伺服器。
  2. 用滑鼠右鍵按一下名為 WebSphere Application Server 6.1 版的伺服器,並透過從蹦現功能表中按一下啟動來啟動該伺服器。 伺服器啟動可能需要一些時間,視您的系統而定。
  3. 請等待,直到伺服器在其狀態欄位中顯示已啟動為止,如此圖片中所示:
    已啟動伺服器的「伺服器」視圖
  4. 伺服器啟動後,在「伺服器」視圖中用滑鼠右鍵按一下該伺服器,然後按一下執行管理主控台,而不是「執行管理 Script」。 這時會在編輯器中開啟管理主控台。
  5. 在管理主控台左側,展開伺服器並按一下應用程式伺服器。 您的伺服器會顯示在應用程式伺服器下面的清單中,如此圖片所示:
    管理主控台中的伺服器清單
  6. 在名稱直欄中按一下伺服器名稱。
  7. 在用於說明您伺服器的頁面上,按一下配置標籤。
  8. 在「配置」標籤上的通訊下面,按一下埠鏈結。
  9. 從埠清單中,按一下埠名稱標籤為 WC_defaulthost 的埠。
  10. 在用於說明此埠的頁面上,於埠欄位中寫下該埠號。 在此圖片中,該埠號為 9082。
    顯示埠號的管理主控台
  11. 關閉管理主控台,而不進行任何變更。
  12. 在頂端功能表中,按一下視窗 > 喜好設定...。在左畫面中,展開 EGL 並按一下 服務。
  13. 如果埠欄位的項目與管理主控台中的伺服器埠號不符,請從這裡的主控台中輸入埠號。 該視窗與此圖片相似:
    「服務」喜好設定顯示與伺服器相同的用於 WSDL 產生的埠號。
  14. 按一下完成。
  15. 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 HelloService.egl 檔(位於 EGLSource 資料夾的服務套件中),然後按一下 EGL 服務 > 產生 WSDL 檔。
  16. 在「建立 WSDL 檔」視窗中,按一下完成。 EGL 會在 EGLSource 資料夾的 wsdl 套件中建立 WSDL 檔,並以圖形方式在 WSDL 編輯器中顯示該 WSDL 檔。
  17. 檢查 WSDL 檔的圖形表示法,並在完成之後關閉它。
現在,您已配置了由其他應用程式在執行時期使用的服務。WSDL 檔會說明服務,以便用戶端可以在執行時期連接該服務,並且部署描述子檔案容許 EGL 在執行時期提供服務。

在真實世界中,服務獨立於使用它們的用戶端執行。若要模擬這種狀況,您可以建立新的應用程式伺服器實例,並在該應用程式伺服器實例上執行服務。為了這個指導教學,耗用這些其他資源沒有任何優點,所以您將在測試用戶端時於現有應用程式伺服器上執行該服務。

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