起始設定和準備 Java API

在您開始配置文件規格並產生文件之前,您必須先起始設定 Java™ API,並選取一種記載方法。

程序

  1. 必要性的: 選取用來起始設定 API 的方法:
    • 自動:使用 RPE_HOME 環境變數來識別 Rational® Publishing Engine 安裝架構中 configsource 目錄的路徑。
    • 以程式設計方式:使用 AppUtils.setProductHome(path),來設定 Rational Publishing Engine 安裝架構中 configsource 目錄的路徑。
    提示: 建議的方法是以程式設計方式來起始設定 API。在您以程式設計方式來起始設定 API 時,應用程式隨附在 configsource 目錄中,而不需靠 Rational Publishing Engine 安裝架構中的目錄來提供。
  2. 選擇性的: 選取記載方法:
    • Rational Publishing Engine 配置成使用您應用程式中的日誌程式:
      • 建立 org.apache.commons.logging.Log 類別實例以便記載。
      • 如果您的應用程式不使用一般記載,您可以為 Rational Publishing Engine 提供一個實作 IRPELogger 介面的類別實例。這個類別會將呼叫 Rational Publishing Engine 記載,轉換成呼叫您應用程式的記載。
    • 在您的應用程式中配置 Rational Publishing Engine 日誌程式:
      • 在您的應用程式中使用 Rational Publishing Engine 日誌程式。範例:
        AppUtils.getLogger().info( "Starting RPE");
      • 使用任何 Rational Publishing Engine 功能之前,先配置 Log4j 日誌程式:
        • 如果 log4j.properties 檔位於您專案的根資料夾中,請輸入下列指令,來起始設定 Log4j 日誌程式:
          PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
        • 如果 log4j.properties 檔不在您專案的根資料夾中,請輸入下列指令,來起始設定 Log4j 日誌程式:
          PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  3. 選擇性的: 連接至進度通知。 報告產生者可透過 RPEListener 傳送通知訊息。這些訊息與產生文件期間 Launcher 應用程式顯示在進度視窗中的訊息相同。

意見