Inicializace a příprava rozhraní API prostředí Java

Než začnete konfigurovat specifikace dokumentu a generovat dokumenty, musíte inicializovat rozhraní Java™ API a vybrat metodu protokolování.

Postup

  1. Požadované: Vyberte metodu inicializace rozhraní API:
    • Automaticky: Proměnná prostředí RPE_HOME se používá k identifikaci cesty k adresářům config a source v instalaci produktu Rational Publishing Engine.
    • Programově: Cestu k adresářům config a source v instalaci produktu Rational Publishing Engine nastavte příkazem AppUtils.setProductHome(cesta).
    Tip: Doporučuje se programová metoda inicializace rozhraní API. Když inicializujete rozhraní API programově, aplikace je dodána s adresáři config a source a nespoléhá na adresáře v instalaci produktu Rational Publishing Engine.
  2. Volitelné: Vyberte metodu protokolování:
    • Nakonfigurujte produkt Rational Publishing Engine k použití modulu protokolování v aplikaci:
      • Vytvořte instanci třídy org.apache.commons.logging.Log pro protokolování.
      • Pokud vaše aplikace nepoužívá běžné protokolování, můžete poskytnout produktu Rational Publishing Engine instanci třídy implementující rozhraní IRPELogger. Tato třída transformuje volání protokolování produktu Rational Publishing Engine na volání protokolování aplikace.
    • Nakonfigurujte modul protokolování produktu Rational Publishing Engine ve své aplikaci:
      • Použijte modul protokolování produktu Rational Publishing Engine ve své aplikaci. Příklad:
        AppUtils.getLogger().info( "Starting RPE");
      • Před použitím jakékoli funkce produktu Rational Publishing Engine nakonfigurujte modul protokolování Log4j:
        • Pokud se soubor log4j.properties nachází v kořenové složce vašeho projektu, inicializujte modul protokolování Log4j takto:
          PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
        • Pokud se soubor log4j.properties nenachází v kořenové složce vašeho projektu, inicializujte modul protokolování Log4j takto:
          PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  3. Volitelné: Připojte se k oznámením o průběhu. Generátorům sestav lze odeslat zprávy oznámení přes RPEListener. Jedná se o tytéž zprávy, jaké zobrazuje spouštěcí aplikace v okně s postupem operace během generování dokumentů.

Zpětná vazba