建立及實作「新建 SQLJ 檔案」精靈的 Java 發射器範本

您可以建立 Java™ 發射器範本 (JET) 來產生 SQLJ 檔案, 這些檔案使用「新建 SQLJ 檔案」精靈所收集的資訊。

必備條件:在工作台中建立 JET 專案。
如果要執行這項作業, 您必須有建立 Java 發射器範本的經驗。如需建立 Java 發射器範本的相關資訊, 請參閱 eclipse.org 網站上的下列文章:

為了節省作業步驟中的空間, 因此省略了通往 ...\com.ibm.etools.sqlj 目錄的完整路徑。完整路徑為 install_directory\rwd\eclipse\plugins\com.ibm.etools.sqlj

如果要建立及實作「新建 SQLJ 檔案」精靈的 JET 範本, 請執行下列動作:

  1. 將 Skeleton 新增至 JET 專案:
    • SQLJFileSkeleton.skel 檔匯入 JET 專案。這個檔案在 ...\com.ibm.etools.sqlj\templates\skeleton 目錄中。
    • 在 JET 專案中建立 Skeleton。此 Skeleton 必須定義一個類別, 此類別利用接受 IBeanData 作為參數的 generate() 方法來實作 ISQLTemplate 介面。
  2. 在 JET 專案中建立您的範本。 您可以建立一個檔案, 也可以匯入其中一個隨工作台提供的範本, 然後變更其內容來符合您的需要。範本檔在 ...\com.ibm.etools.sqlj\templates 目錄中。
    範本中的 JET 指引必須包含:
    • 類別名稱,此名稱在 ...\com.ibm.etools.sqlj\templates 目錄中的所有範本之間必須是唯一的。 類別名稱與範本名稱相同是個不錯的作法。
    • skeleton 屬性,其參照您正在使用的 Skeleton。
  3. 將 SQLJ 外掛程式的執行時期 JAR 檔新增至您專案的 Java 建置路徑。在專案的「內容」視窗中,按一下 Java 建置路徑, 然後在「程式庫」頁面上執行下列其中一個動作:
    • 如果您使用「新建 SQLJ 檔案」精靈建立了 SQLJ 檔案,請按一下新增變數, 然後按兩下「新建變數類別路徑項目」視窗中的 SQLJPLUGIN
    • 如果您並未使用「新建 SQLJ 檔案」精靈,請按一下新增外部 JAR、 移至「JAR 選項」視窗中的 ...\com.ibm.etools.sqlj 目錄, 然後按兩下sqlj.jar 檔。
    這時,SQLJ 外掛程式的執行時期 JAR 檔會將您範本中的參照解析成 SQLJ 外掛程式中的類別。
  4. 在範本順利編譯之後, 請將其 .sqljjet 檔複製到 ...\com.ibm.etools.sqlj\templates 目錄。如果您建立了新的 Skeleton 檔案, 請將它複製到 ...\com.ibm.etools.sqlj 下面符合 JET 指引中的參照之子目錄。
  5. 將範本的說明新增至 ...\com.ibm.etools.sqlj\template\properties 目錄中的 user.properties 檔。 在文字編輯器中開啟該檔案, 然後在註解行後面加入下列兩行:
    template_file_name.label=Template name
    template_file_name.desc=Template description.
    這時在標籤中指定的範本名稱會包含在「新建 SQLJ 檔案」精靈中的範本清單中。當選取了清單中的範本時, 它的說明會顯示在清單旁邊的顯示框中。
  6. 使用精靈來建立 SQLJ 檔案、選取範本, 然後檢視產生的 SQLJ 檔案中所產生的程式碼。
如果您需要對範本進行變更, 可以使用下列其中一種方法: 下次您使用「新建 SQLJ 檔案」精靈建立新的 SQLJ 檔案時,SQLJ 外掛程式就會偵測到您的範本檔已變更, 並且會使用更新後的範本。
相關概念
Java 發射器範本與「新建 SQLJ 檔案」精靈
相關參考
SQLJ 範本介面
讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.