Inicjowanie i przygotowywanie interfejsu API języka Java

Przed rozpoczęciem konfigurowania specyfikacji dokumentów i generowania dokumentów należy zainicjować interfejs API języka Java™ i wybrać metodę rejestrowania.

Procedura

  1. Wymagane: Wybierz metodę inicjowania interfejsu API:
    • Automatycznie: zmienna środowiskowa %RPE_HOME% służy do identyfikowania ścieżki do katalogów config i source w instalacji produktu Rational Publishing Engine.
    • Programowo: ustaw ścieżkę do katalogów config i source w instalacji produktu Rational Publishing Engine za pomocą metody AppUtils.setProductHome(ścieżka).
    Wskazówka: Zalecaną metodą jest programowe inicjowanie interfejsu API. Jeśli interfejs API zostanie zainicjowany programowo, aplikacja jest dostarczana wraz z katalogami config i source i nie jest zależna od katalogów w instalacji produktu Rational Publishing Engine.
  2. Opcjonalne: Wybierz metodę rejestrowania:
    • Skonfiguruj produkt Rational Publishing Engine, aby użyć programu rejestrującego w aplikacji:
      • Utwórz instancję klasy org.apache.commons.logging.Log na potrzeby rejestrowania.
      • Jeśli aplikacja nie korzysta ze wspólnego rejestrowania, można udostępnić produktowi Rational Publishing Engine instancję klasy implementującej interfejs IRPELogger. Ta klasa transformuje wywołania rejestrowania produktu Rational Publishing Engine w wywołania do mechanizmu rejestrowania aplikacji użytkownika.
    • Skonfiguruj program rejestrujący produktu Rational Publishing Engine w aplikacji użytkownika:
      • Użyj programu rejestrującego produktu Rational Publishing Engine w aplikacji użytkownika. Przykład:
        AppUtils.getLogger().info( "Uruchamianie produktu RPE");
      • Skonfiguruj program rejestrujący Log4j przed użyciem jakiejkolwiek funkcji produktu Rational Publishing Engine:
        • Jeśli plik log4j.properties znajduje się w głównym folderze projektu, zainicjuj program rejestrujący Log4j, wykonując następującą operację:
          PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
        • Jeśli plik log4j.properties nie znajduje się w głównym folderze projektu, zainicjuj program rejestrujący Log4j, wykonując następującą operację:
          PropertyConfigurator.configure( new File(
          AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  3. Opcjonalne: Nawiąż połączenie z powiadomieniami o postępie. Komunikaty powiadomień mogą być wysyłane do generatorów raportów za pośrednictwem komendy RPEListener. Te komunikaty są tymi samymi komunikatami, które są wyświetlane przez aplikację Launcher w oknie postępu podczas generowania dokumentu.

Opinia