執行 Ant Script

如果您希望能更容易執行 DB2® SQLJ 設定檔自訂程式 db2sqljcustomize,可以使用 Ant Script。當您對 EAR 檔執行批次 SQLJ ejbdeploy 指令時,所產生的就是這個特定的 Ant Script。

Ant Script 是針對相關 EAR 中每個 EJB JAR 的每個自行設定檔而執行。這個 Script 會以修改過的自行設定檔,更新每個 EJB JAR 檔,並且將 EAR 中的 JAR 檔換成修改過的版本。這個 Ant Script 是對應的 EAR 檔所特有,會修改現有的 EAR 檔。這個 Ant Script 會對相關 EAR 檔中每個 EJB JAR 的每個自行設定檔,執行 DB2 SQLJ 設定檔自訂程式。

註: 如果您需要再執行一次 ejbdeploy 指令,也必須將 Ant Script 再執行一次。除非您已經變更 EAR 中的 JAR 檔數目或名稱,或者變更任何 JAR 檔所用的資料庫後端系統 ID,否則不必產生新的內容檔。

執行 Script

  1. 執行 Ant Script,指定內容目標。
    ant -buildfile out.ear.xml properties

    此舉會建立一個名叫 out.ear.properties 的內容檔。這個檔案所含的內容,會為 對應於 EAR 檔中每一個自行設定檔的套件,指定一個預設名稱,例如:

    pkg.One.jar.DB2UDBNT_V8_1=PKG2_
    
    pkg.Two.jar.DB2UDBNT_V8_1=PKG1_

    在這個範例中,EAR 檔含有兩個 EJB JAR 檔:One.jarTwo.jar

  2. 編輯所產生的內容檔,來變更套件名稱。您也可以在這個檔案指定其他內容,例如,資料庫 URL、使用者或密碼:
    url.One.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dbx
    user.One.jar.DB2UDBNT_V8_1=dbuser
    password.One.jar.DB2UDBNT_V8_1=dbpassword
    pkg.One.jar.DB2UDBNT_V8_1=TEST
    url.Two.jar.DB2UDBNT_V8_1=jdbc:db2://localhost:50000/dby
    pkg.Two.jar.DB2UDBNT_V8_1=WORK
    註: DB2 只會使用您所指定之名稱的前七個字元。DB2 SQLJ 設定檔自訂程式會使用這個名稱,在資料庫中建立四個套件。如果您指定的名稱是 PKG,則自訂程式所建立的套件就叫 PKG1、PKG2、PKG3 和 PKG4。
  3. 確定資料庫中有 Enterprise Bean 的資料庫表格,否則,自訂步驟就會失敗。
  4. 確定 DB2 的 db2jcc.jar 位於類別路徑中。在安裝 DB2 第 8 版時,它應該已經新增至類別路徑了。
    註: 您在一開始使用 DB2 第 8 版 fix pack 2 時, 也必須將授權 JAR 檔新增至類別路徑中。JAR 檔所含的授權檔,容許您與伺服器連線。授權 JAR 檔會根據您所用的資料庫伺服器類型而有所不同。
    • db2jcc_license_cu.jar - 適用於 Windows®、UNIX® 和 Cloudscape™ 伺服器
    • db2jcc_license_cisuz.jar - 適用於所有的伺服器
    • db2jcc_license_c.jar - 限用於 Cloudscape 伺服器
總而言之,下列事件是自訂步驟的結果:
  1. 建立四個含有靜態 SQL 的資料庫套件,這些套件分別適用於每一個隔離層次

    針對這些在資料庫中建立的套件,Script 會使用一組預設名稱。

  2. 更新所產生的自行設定檔

    這個 Script 會以修改過的自行設定檔更新每一個 EJB JAR 檔,並且將 EAR 中的 JAR 檔,換成修改過的版本。這個 Ant Script 是對應的 EAR 檔所特有,它會修改現有的 EAR 檔。您也可以利用內容,為每一個自行設定檔指定 URL、使用者及密碼。依預設,自行設定檔的內容是從廣域內容設定的。

    特定 EAR 檔的這個 Script,會從 ejbdeploy.sqlj.properties 及 ear_name.properties(預設值)這兩個檔案讀取內容,其中 ear_name 是指 EAR 檔的檔名。ejbdeploy.sqlj.properties 檔適用於所有由 ejbdeploy 指令所產生的 Ant Script,其中 ear_name.properties 是專屬於 EAR 的 Ant Script。在執行該 Script 時,您可以指定 script.property.file 內容,讓 Ant Script 使用 ear_name.properties 以外的檔案。

    提示: ejbdeploy.sqlj.properties 檔是指定廣域內容的好地方,例如,您的資料庫使用者 ID 和密碼。
    註: 下面是有關更新後之設定檔的注意事項:
    • 所產生的程式碼,必須能夠在執行時期使用它們。
    • 它們必須包含在實際的 EJB JAR 檔中,該檔是安裝在 WebSphere® Application Server 上。

如需有關執行 Ant 的資訊,請參閱 ant.apache.org/manual/index.html 下的 Apache Ant 手冊

現在您就可以將更新後的 EAR 檔,安裝在 WebSphere Application Server 上了。

相關概念
DB2 SQLJ 設定檔自訂程式
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.