JRas 프레임워크(더 이상 사용되지 않음)
JRas 확장 클래스는 여러 시나리오에 필요한 유연성 및 동작을 제공하지 않으므로, 다양한 확장점이 정의되어 있습니다. 사용자가 사용자의 구현 클래스를 작성하여 필요한 동작을 확보할 수 있습니다.
더 이상 사용되지 않음: 이 주제에서 설명한 JRas 프레임워크는 더 이상 사용되지 않습니다. 그러나 Java™ 로깅을 사용하여 유사한 결과를 얻을 수 있습니다.
일반적으로, JRas 확장을 사용하려면 메시지 로거 또는 추적 로거를 확보하는 관리자 클래스를 호출해야 합니다. 사용자가 사용자의 메시지 또는 추적 로거 서브클래스를 직접 제공하도록 합니다. 일반적으로, 사용자 제공 확장기능을 사용하여 통합 조작 모드에 영향을 주지 못합니다. 통합 조작 모드의 동작은 WebSphere® Application Server 런타임 및 JRas 확장 클래스로만 판별됩니다.
핸들러
독립형 JRas 로깅 툴킷은 RASIHandler 인터페이스를 정의합니다. 모든 핸들러는 이 인터페이스를 구현해야 합니다. 따라서 사용자가 RASIHandler 인터페이스를 구현하는 핸들러 클래스를 직접 작성할 수 있습니다. 사용자 정의 핸들러의 인스턴스를 직접 작성하여 관리자 클래스에서 확보된 로거에 추가하십시오.
독립형 JRas 로깅 툴킷은 몇 가지 핸들러 구현 클래스를 제공합니다. 이러한 핸들러 클래스는 J2EE(Java 2 Platform, Enterprise Edition) 환경에서 사용하기에 부적절합니다. 사용자가 독립형 JRas 로깅 툴킷에서 제공한 핸들러 클래스를 직접 사용하거나 서브클래스화할 수 없습니다. 그렇게 하면 프로그래밍 모델을 위반하는 것입니다.
포맷터
독립형 JRas 로깅 툴킷은 RASIFormatter 인터페이스를 정의합니다. 모든 포맷터는 이 인터페이스를 구현해야 합니다. 따라서 사용자가 RASIFormatter 인터페이스를 구현하는 포맷터 클래스를 직접 작성할 수 있습니다. 사용자 정의 핸들러에만 이러한 클래스를 추가할 수 있습니다. 사용자 정의 포맷터를 사용하도록 WebSphere Application Server 핸들러를 구성할 수는 없습니다. 대신, 사용자가 사용자 포맷터의 인스턴스를 직접 작성하여 사용자의 핸들러에 추가해야 합니다.
핸들러의 경우와 마찬가지로, 독립형 JRas 로깅 툴킷은 몇 가지 포맷터 구현 클래스를 제공합니다. 이러한 포맷터의 직접 사용은 지원되지 않습니다.
메시지 이벤트 유형
독립형 JRas 툴킷은 RASIMessageEvent 인터페이스에서 메시지 이벤트 유형을 정의합니다. 또한 WebSphere Application Server는 이후 사용을 위해 메시지 이벤트 유형 범위를 저장합니다. RASIMessageEvent 인터페이스는 세 가지 유형 0x01, 0x02, 0x04 값을 정의합니다. 0x08 - 0x8000 값은 이후 사용을 위해 예약되어 있습니다. 사용자가 인터페이스를 확장하여 고유한 메시지 이벤트 유형을 제공할 수 있습니다. 사용자 정의 메시지 유형은 0x1000 값 이상이어야 합니다.
관리자 클래스에서 검색된 메시지 로거는 자체 메시지 마스크를 pass로 설정하거나 RASIMessageEvent 인터페이스에 정의된 모든 메시지 이벤트 유형을 처리합니다. 사용자 정의 메시지 유형을 처리하려면 관리자 클래스로부터 메시지 로거를 확보한 후 사용자 코드별 상태로 메시지 로거 마스크를 수동으로 설정해야 합니다. WebSphere Application Server는 메시지 유형 관리를 위해 내장 시스템 관리를 지원하지 않습니다.
메시지 이벤트 오브젝트
독립형 JRas 툴킷은 RASMessageEvent 구현 클래스를 제공합니다. 메시지 로거에서 메시지 로깅 메소드가 호출되고 메시지 유형이 현재 사용 가능한 경우, 로거에서 이 클래스의 이벤트를 작성하여 현재 로거에 등록된 모든 핸들러에 분배합니다.
사용자의 메시지 이벤트 클래스를 제공할 수 있지만 RASIEvent 인터페이스를 구현해야 합니다. 사용자가 이러한 사용자 정의 메시지 이벤트 클래스의 인스턴스를 직접 작성해야 합니다. 인스턴스가 작성되면 메시지 로거의 fireRASEvent 메소드를 직접 호출하여 사용자의 메시지 이벤트가 메시지 로거로 전달됩니다. WebSphere Application Server 메시지 로거가 로거의 로깅 메소드(msg.message) 호출에 응답하여 직접 사용자 정의 유형의 인스턴스를 작성할 수 없습니다. 또한 사용자 정의 메시지 유형의 인스턴스는 WebSphere Application Server 핸들러로 처리되지 않습니다. RASMessageEvent 클래스의 인스턴스를 직접 작성할 수 없습니다.
추적 이벤트 유형
독립형 JRas 툴킷은 RASITraceEvent 인터페이스에서 추적 이벤트 유형을 정의합니다. 이 인터페이스를 확장하여 사용자의 추적 이벤트 유형을 제공할 수 있습니다. 이 경우, 사용자 정의 추적 이벤트 유형이 RASITraceEvent 인터페이스에 정의된 유형 값과 충돌하지 않도록 해야 합니다.
관리자 클래스에서 검색된 추적 로거에는 일반적으로 모든 유형을 거부하도록 설정된 추적 마스크가 있습니다. 다른 시작 상태는 WebSphere Application Server 시스템 관리 기능을 사용하여 지정 가능합니다. 또한 WebSphere Application Server 시스템 관리 기능을 사용하여 런타임 시 로거에 대한 추적 마스크의 상태를 변경할 수 있습니다.
사용자 정의 추적 유형을 처리하려면 사용자 코드별 상태로 추적 로거 마스크를 수동으로 설정해야 합니다. 시작 시 또는 런타임에서 사용자 정의 추적 유형을 관리하는 데에는 WebSphere Application Server 시스템 관리 기능을 사용할 수 없습니다.
추적 이벤트 오브젝트
독립형 JRas 툴킷은 RASTraceEvent 구현 클래스를 제공합니다. WebSphere Application Server 추적 로거에서 추적 로깅 메소드가 호출되고 유형이 현재 사용 가능한 경우, 로거에서 이 클래스의 이벤트를 작성하고 현재 로거에 등록된 모든 핸들러에 분배합니다.
사용자의 추적 이벤트 클래스를 제공할 수 있습니다. 이러한 추적 이벤트 클래스는 RASIEvent 인터페이스를 구현해야 합니다. 사용자가 이러한 사용자 정의 이벤트 클래스의 인스턴스를 작성해야 합니다. 인스턴스가 작성되면 추적 로거의 fireRASEvent 메소드를 직접 호출하여 추적 이벤트가 추적 로거로 전달됩니다. WebSphere Application Server 추적 로거가 추적 로거의 추적 메소드(entry, exit, trace) 호출에 응답하여 직접 사용자 정의 유형의 인스턴스를 작성할 수 없습니다. 또한 사용자 정의 추적 유형의 인스턴스는 WebSphere Application Server 핸들러로 처리되지 않습니다. RASTraceEvent 클래스의 인스턴스를 직접 작성할 수 없습니다.
사용자 정의 유형, 사용자 정의 이벤트, WebSphere Application Server
정의에 따라 WebSphere Application Server 핸들러는 사용자 정의 메시지 또는 추적 유형이나 사용자 정의 메시지 또는 추적 이벤트 클래스를 처리합니다. 사용자 정의 유형 또는 사용자 정의 이벤트 클래스의 메시지 및 추적 항목은 WebSphere Application Server 런타임 로그로 쓸 수 없습니다.