您可以建立 Java™ 發射器範本 (JET) 來產生 SQLJ 檔案,
這些檔案使用「新建 SQLJ 檔案」精靈所收集的資訊。
必備條件:在工作台中建立 JET 專案。
如果要執行這項作業,
您必須有建立 Java 發射器範本的經驗。如需建立 Java 發射器範本的相關資訊,
請參閱 eclipse.org 網站上的下列文章:
為了節省作業步驟中的空間,
因此省略了通往 ...\com.ibm.etools.sqlj 目錄的完整路徑。完整路徑為 install_directory\rwd\eclipse\plugins\com.ibm.etools.sqlj。
如果要建立及實作「新建 SQLJ 檔案」精靈的 JET 範本,
請執行下列動作:
- 將 Skeleton 新增至 JET 專案:
- 將 SQLJFileSkeleton.skel 檔匯入 JET 專案。這個檔案在 ...\com.ibm.etools.sqlj\templates\skeleton 目錄中。
- 在 JET 專案中建立 Skeleton。此 Skeleton 必須定義一個類別,
此類別利用接受 IBeanData 作為參數的 generate() 方法來實作 ISQLTemplate 介面。
- 在 JET 專案中建立您的範本。 您可以建立一個檔案,
也可以匯入其中一個隨工作台提供的範本,
然後變更其內容來符合您的需要。範本檔在 ...\com.ibm.etools.sqlj\templates 目錄中。
範本中的
JET 指引必須包含:
- 類別名稱,此名稱在 ...\com.ibm.etools.sqlj\templates 目錄中的所有範本之間必須是唯一的。
類別名稱與範本名稱相同是個不錯的作法。
- skeleton 屬性,其參照您正在使用的 Skeleton。
- 將 SQLJ 外掛程式的執行時期 JAR 檔新增至您專案的 Java 建置路徑。在專案的「內容」視窗中,按一下 Java 建置路徑,
然後在「程式庫」頁面上執行下列其中一個動作:
- 如果您使用「新建 SQLJ 檔案」精靈建立了 SQLJ 檔案,請按一下新增變數,
然後按兩下「新建變數類別路徑項目」視窗中的 SQLJPLUGIN。
- 如果您並未使用「新建 SQLJ 檔案」精靈,請按一下新增外部 JAR、
移至「JAR 選項」視窗中的 ...\com.ibm.etools.sqlj 目錄,
然後按兩下sqlj.jar 檔。
這時,SQLJ 外掛程式的執行時期 JAR 檔會將您範本中的參照解析成 SQLJ 外掛程式中的類別。
- 在範本順利編譯之後,
請將其 .sqljjet 檔複製到 ...\com.ibm.etools.sqlj\templates 目錄。如果您建立了新的 Skeleton 檔案,
請將它複製到 ...\com.ibm.etools.sqlj 下面符合 JET 指引中的參照之子目錄。
- 將範本的說明新增至 ...\com.ibm.etools.sqlj\template\properties 目錄中的 user.properties 檔。 在文字編輯器中開啟該檔案,
然後在註解行後面加入下列兩行:
template_file_name.label=Template name
template_file_name.desc=Template description.
這時在標籤中指定的範本名稱會包含在「新建 SQLJ 檔案」精靈中的範本清單中。當選取了清單中的範本時,
它的說明會顯示在清單旁邊的顯示框中。
- 使用精靈來建立 SQLJ 檔案、選取範本,
然後檢視產生的 SQLJ 檔案中所產生的程式碼。
如果您需要對範本進行變更,
可以使用下列其中一種方法:
- 直接在 ...\com.ibm.etools.sqlj\templates 目錄中使用文字編輯器來變更範本檔。
- 使用工作台來變更 JET 專案中的範本,
然後將更新後的檔案複製到 SQLJ 外掛程式目錄 (...\com.ibm.etools.sqlj\templates)。
下次您使用「新建 SQLJ 檔案」精靈建立新的 SQLJ 檔案時,SQLJ 外掛程式就會偵測到您的範本檔已變更,
並且會使用更新後的範本。