Java API 초기화 및 준비

문서 스펙 구성 및 문서 생성을 시작하기 전에 Java™ API를 초기화하고 로깅 메소드를 선택해야 합니다.

프로시저

  1. 필수: API 초기화 메소드를 선택하십시오.
    • 자동: %RPE_HOME% 환경 변수는 Rational® Publishing Engine 설치에서 configsource 디렉토리의 경로를 식별하는 데 사용됩니다.
    • 프로그래밍 방식: AppUtils.setProductHome(path)을 사용하여 Rational Publishing Engine 설치에서 configsource 디렉토리의 경로를 설정하십시오.
    팁: API를 프로그래밍 방식으로 초기화하도록 권장합니다. API를 프로그래밍 방식으로 초기화하면 애플리케이션이 Rational Publishing Engine 설치 내의 디렉토리에 의존하지 않고 configsource 디렉토리에서 제공됩니다.
  2. 옵션: 로깅 메소드를 선택하십시오.
    • 애플리케이션에서 로거를 사용하려면 Rational Publishing Engine을 구성하십시오.
      • 로깅에 필요한 org.apache.commons.logging.Log 클래스의 인스턴스를 작성하십시오.
      • 애플리케이션이 공통 로깅을 사용하지 않는 경우, IRPELogger 인터페이스를 구현하는 클래스의 인스턴스와 함께 Rational Publishing Engine을 제공할 수 있습니다. 이 클래스는 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 애플리케이션이 진행상태 창에 표시하는 메시지와 동일합니다.

피드백