프로그래밍 모델 요약
이 절에서 설명된 프로그래밍 모델은 이미 소개된 일부 개념을 확립하고 이를 요약합니다. 이 절은 사용법 요구사항 및 제한사항을 형식화합니다. 다음과 같은 프로그래밍 지침을 따르지 않는 방식의 WebSphere® Application Server JRas 확장의 사용은 허용되지 않습니다.
참고: 이 태스크 및 하위 태스크에서 설명한 JRas 프레임워크는 더 이상 사용되지 않습니다. 그러나 Java™ 로깅을 사용하여 유사한 결과를 얻을 수 있습니다.
다음과 같은 세 가지 구별 조작 모드로
WebSphere Application Server JRas 확장을
사용할 수 있습니다. 프로그래밍 모델 개념 및 제한사항은 모든 조작 모드에 대해 동일하게 적용됩니다.
- 독립형 JRas 로깅 툴킷에서 제공하는 구현 클래스는 달리 언급되어 있지 않는 한 직접 사용할 수 없습니다. 해당 클래스의 직접 사용은 지원되지 않습니다. IBM® 지원 센터는 독립형 JRas 로깅 툴킷에서 제공하는 클래스의 직접 사용과 관련된 진단 지원 또는 버그 수정을 제공하지 않습니다.
- 사용자가 관리자 클래스에서 직접 메시지 및 추적 로거를 확보해야 합니다. 로거의 인스턴스를 직접 작성할 수는 없습니다.
- 사용자는 WebSphere Application Server 메시지 및 추적 로거 클래스를 바꿀 수 없습니다.
- 사용자는 관리자 클래스로 전달된 로거 이름이 고유하도록 보장해야 하며, 설명된 이름 지정 제한조건을 따라야 합니다. 관리자 클래스에서 로거가 확보되면, setName 메소드를 호출하여 로거의 이름을 변경하려 시도할 수 없습니다.
- 이름 지정된 로거는 한 번 이상 사용할 수 있습니다. 지정된 모든 이름의 경우, 관리자 클래스에 대한 첫 번째 관리자 클래스 호출 결과 해당 이름과 연관된 로거가 작성됩니다. 동일한 이름을 지정하는 관리자 클래스에 대한 후속 호출은 기존 로거에 대한 참조를 리턴합니다.
- 관리자 클래스가 로거의 계층 구조 네임스페이스를 유지보수합니다. 점으로 구분된 완전한 클래스 이름을 사용하여 로거를 식별하십시오. 점 또는 마침표 외에, 로거 이름에서는 별표(*), 쉼표(.), 등호(=), 콜론(:) 또는 따옴표(')와 같은 구두 문자를 사용할 수 없습니다.
- 그룹 이름은 로거 이름과 동일한 이름 지정 제한사항을 따라야 합니다.
- 관리자 클래스에서 리턴된 로거는 독립형 JRas 로깅 툴킷에서 제공하는 RASMessageLogger 및 RASTraceLogger 클래스의 서브클래스입니다. 사용자는 RASMessageLogger 및 RASTraceLogger 클래스로 정의된 공용 메소드를 호출할 수 있습니다. 제공된 서브클래스에서 채택한 공용 메소드는 호출할 수 없습니다.
- 사용자가 독립형 또는 결합 모드로 작업하려는 경우, 사용자의 핸들러 또는 포맷터 서브클래스를 제공해야 합니다. 독립형 JRas 로깅 툴킷에서 제공하는 핸들러 및 포맷터 클래스는 사용할 수 없습니다. 사용자 작성 핸들러 및 포맷터는 설명된 지침을 따라야 합니다.
- 관리자 클래스에서 확보한 로거는 설치되는 WebSphere Application Server 핸들러와 함께 제공됩니다. 이 핸들러는 WebSphere Application Server 런타임으로 정의된 로그에 메시지 및 추적 레코드를 기록합니다. 지정된 시스템 관리 인터페이스를 사용하여 이러한 로그를 관리하십시오.
- 사용자는 언제든 프로그래밍 방식으로 로거에서 사용자 정의 핸들러를 추가하고 제거할 수 있습니다. 사용자 정의 핸들러를 여러 개 추가하거나 제거할 수 있습니다. 사용자가 추가할 핸들러의 인스턴스를 작성하고, 핸들러 마스크 값 및 포맷터를 설정하여 핸들러를 구성한 다음, addHandler 메소드를 사용하여 로거에 핸들러를 추가해야 합니다. 또한 때에 따라 사용자 정의 핸들러의 마스크를 프로그래밍 방식으로 업데이트해야 합니다.
- 로거에 대한 getHandlers 메소드를 호출하고 결과를 처리하여 로거 내에 설치된 핸들러에 대한 참조를 가져올 수 있습니다. 사용자는 이러한 방법으로 확보한 핸들러에 대한 메소드는 호출할 수 없습니다. removeHandler 메소드를 호출하고 WebSphere Application Server 핸들러에 대한 참조를 전달하여 로거에서 WebSphere Application Server 핸들러를 제거할 수는 있습니다. 제거되면, WebSphere Application Server 핸들러를 로거에 다시 추가할 수 없습니다.
- 사용자의 메시지 유형을 정의할 수 있습니다. 사용자 정의 메시지 유형의 동작 및 해당 정의의 제한사항은 JRas 프레임워크(더 이상 사용되지 않음)에서 설명됩니다.
- 자체 메시지 이벤트 클래스를 정의할 수 있습니다. 사용자 정의 메시지 이벤트 클래스 사용은 JRas 프레임워크(더 이상 사용되지 않음)에서 설명됩니다.
- 사용자의 추적 유형을 정의할 수 있습니다. 사용자 정의 추적 유형의 동작 및 해당 정의의 제한사항은 JRas 프레임워크(더 이상 사용되지 않음)에서 설명됩니다.
- 사용자의 추적 이벤트 클래스를 정의할 수 있습니다. 사용자 정의 추적 이벤트 클래스 사용은 JRas 프레임워크(더 이상 사용되지 않음)에서 설명됩니다.
- 사용자가 프로그래밍 방식으로 사용자 정의 유형에 해당하는 메시지 및 추적 로거 마스크의 비트를 유지보수해야 합니다. WebSphere Application Server 기능이 사전 정의된 유형을 관리하는 데 사용되는 경우, 이러한 업데이트는 유형에 해당하는 비트 상태를 수정해서는 안 됩니다. 사용자가 사전 정의된 유형에 대한 소유권 책임이 있는 경우, 모든 마스크 비트를 변경할 수 있습니다.