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

第 2 課:設定工作區

在撰寫邏輯之前,請先建立兩個 EGL 專案並匯入 Dojo 範例。

EGL 應用程式採用一個以上專案的形式進行組織,其中每個專案都是工作區中的一個實體資料夾。專案包含為您提供的 EGL 原始檔資料夾,此資料夾包含一個以上的套件,每個套件包含 EGL 原始檔。此階層是您在 EGL 中的工作基礎:先是專案,接著是 EGL 原始檔資料夾,然後是包含 EGL 原始檔的套件。

EGL 原始檔包括 EGL 組件,這些組件是您建立的類型定義。例如,「服務」組件包含邏輯,「記錄」組件可以是您在「服務」組件中所宣告之變數的基礎。

因為套件會將組件分隔到不同的環境定義或名稱空間中,所以套件非常重要:
  • 組件名稱在兩個不同的套件中可能重複,但任何 EGL 原始碼都可以精確地參照每一個組件。名稱空間的主要好處在於不同團隊可以開發不同的 EGL 組件,而不會導致名稱衝突。
  • 給定套件內的每一個組件名稱在該套件內都是唯一的:
    • 一個套件中的某個組件可以透過指定組件名稱,輕鬆參照相同套件中的另一個組件。例如,以下是基於「記錄」組件 MyRecordPart 的記錄宣告:
      myRecord MyRecordPart{};
    • 一個套件中的某個組件還可以透過提供套件名稱和組件名稱,或透過涉及匯入組件的捷徑,參照另一個套件中的組件。本指導教學提供了範例。

一個專案可以參照另一個專案中的組件,但是只有當參照的專案的 EGL 建置路徑識別被參照的專案時,才是如此。本指導教學也提供了範例。不過,無論如何,請避免在不同專案中使用相同的套件名稱,因為這樣使用可能導致名稱解析時發生問題。

本指導教學中的下一項作業是要建立下列專案:
MortgageServiceProject
存放「EGL 服務」組件及相關定義
MortgageUIProject
存放「多元使用者介面」處理程式及相關定義

您可以在單一專案中包括所有程式碼,但這裡顯示的分隔可讓您透過不同方式,輕鬆部署兩種類型的程式碼。

建立 EGL 服務專案

  1. 如果您在 EGL 以外的其他工作台視景中,請按一下視窗 > 開啟視景 > [其他] > EGL,切換至 EGL 視景。 視景圖示位於工作台的右上角。
    EGL 圖示指示 EGL 視景,並顯示在「最小化」、「最大化」及「關閉」圖示下面的標籤上。
  2. 按一下檔案 > 新建 > EGL 專案,或按一下功能表列上的新建 EGL 專案圖示。
    「新建專案」圖示是功能表列中第二個圖示群組內的第一個圖示(共四個)。
  3. 在「EGL 專案」視窗中,輸入下列資訊:
    1. 專案名稱欄位中,輸入下列名稱:
      MortgageServiceProject
    2. EGL 專案類型區段中,按一下一般專案
      「專案名稱」為 "MortgageServiceProject" 的「新建 EGL 專案」視窗。
    3. 下一步
  4. 在第二個「EGL 專案」視窗中,EGL 所提供的預設值應該是正確的。請驗證下列資訊:
    1. 目標執行時期平台是 Java。 此設定指示 EGL 從您的「EGL 服務」組件產生 Java 原始碼。
    2. 建置描述子選項下面,已選取建立建置描述子圓鈕。建置描述子會控制產生過程。因為要為服務建立不同的專案,所以可以使用 EGL 為您建立的預設建置描述子。
  5. 按一下完成
這時,EGL 會建立名為 MortgageServiceProject 的專案。請注意該目錄中的資料夾:
EGLSource
將套件和原始檔放置在這裡。
EGLGen/JavaSource
EGL 會將其產生的 Java 檔放置在這裡。
JavaSource
將任何自訂 Java 原始檔放置在這裡。在產生過程期間,不會改寫這些檔案。
JRE System Library
EGL 將此資料夾用於支援 Java 執行時期環境的 JAR 檔。
「專案瀏覽器」視圖會顯示新專案和資料夾。

建立 EGL 多元使用者介面專案

  1. 按一下功能表列上的新建 EGL 專案圖示。
  2. 在「新建 EGL 專案」視窗中,輸入下列資訊:
    1. 專案名稱欄位中,鍵入下列名稱:
      MortgageUIProject
    2. EGL 專案類型區段中,按一下多元使用者介面專案
      「專案名稱」為 "MortgageUIProject" 的「EGL 專案」視窗。
    3. 下一步
  3. 在第二個「EGL 專案」視窗中,EGL 所提供的預設值應該是正確的。請驗證下列資訊:
    1. 已選取使用專案的預設位置
    2. 小組件程式庫清單包含下列專案:
      • EGL 多元使用者介面小組件
      • EGL Dojo 小組件
    3. EGL 專案特性群組中,已選取建立 EGL 部署描述子
  4. 下一步
  5. EGL 設定頁面上,選取 MortgageServiceProject 服務專案會新增至新專案的建置路徑,以便使用者介面專案可以使用該服務專案中定義的組件。
  6. 按一下完成
EGL 會建立名為 MortgageUIProject 的專案,並將支援專案新增至「多元使用者介面」、「Dojo 小組件」和「Dojo 執行時期程式庫」的工作區。除了 EGL 為「一般專案」建立的目錄之外,「多元使用者介面」專案還包括下列目錄:
WebContent
包含支援檔,例如階式樣式表 (CSS) 和影像。
「專案瀏覽器」視圖會顯示新專案和資料夾。

匯入 EGL Dojo 小組件範例

  1. 從工作台的頂端功能表中,按一下說明 > 說明內容
  2. 在「說明內容」中,展開範例 > 技術範例 > EGL,然後按一下 EGL Dojo 小組件
    已展開的「範例」功能表。
  3. 在「內容」窗格中,按一下取得範例
    「內容」窗格
  4. 在「匯入」視窗中,預設值是正確的。按一下完成
這時,會將最新版本的 com.ibm.egl.rui.dojo.samples 專案新增至工作區。
「專案瀏覽器」視圖中的 Dojo 範例專案。

變更 MortgageUIProject 的建置路徑

EGL 建置路徑會決定 EGL 在嘗試解析邏輯中的參照時所檢查的專案。若要新增剛剛匯入的專案,請執行下列動作:

  1. 在「專案瀏覽器」視圖中,用滑鼠右鍵按一下 MortgageUIProject,然後按一下內容。在「MortgageUIProject 的內容」視窗左側,按一下 EGL 建置路徑 這時,EGL 會顯示工作區中專案的清單。
  2. 選取 com.ibm.egl.dojo.samples 專案。 不需要選取 com.ibm.egl.dojo.widgets 專案,因為它已經在 com.ibm.egl.dojo.runtime.local 專案的建置路徑中。已完成的建置路徑視窗應該與下圖相似:
    已選取四個專案(共五個)。
    這些選項表示當您組織 import 陳述式(用於向程式提供其他詳細資料)時,EGL 將查看已選取的所有專案,以解析參照。
  3. 按一下確定

課程檢查點

在本課程中,您完成了下列作業:
  • 建立適用於抵押服務的 EGL 專案
  • 建立適用於「多元使用者介面」應用程式的 EGL 專案
  • 匯入 EGL Dojo 範例專案
  • 調整第二個專案的 EGL 建置路徑

在下一節課程中,您將建立專用服務,以計算每月抵押付款金額。

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

意見