패키지 java.util.logging

Java^TM 2 플랫폼의 코어로깅 기능의 클래스와 인터페이스를 제공합니다.

참조처:
설명

인터페이스 개요

Filter	Filter는 로그 레벨이 제공하는 제어 이상으로 로그 대상을 치밀하게 제어하기 위해서 사용됩니다.
LoggingMXBean	로깅파시리티의 관리 인터페이스입니다.

클래스 개요

ConsoleHandler	이 Handler는 System.err에 로그 레코드를 발행합니다.
ErrorManager	ErrorManager 객체는 Handler에 접속되어 로깅시에 Handler 로 발생하는 에러를 처리합니다.
FileHandler	단순 파일의 로깅 Handler 입니다.
Formatter	Formatter는 LogRecord 포맷 처리를 지원 합니다.
Handler	Handler 객체는 Logger로 부터 로그 메세지를 취득해, 그것들을 써냅니다.
Level	Level 클래스는 로그 출력의 제어에 사용되는 표준 로그 레벨세트를 정의합니다.
Logger	Logger 객체를 사용해, 특정의 시스템 또는 어플리케이션 컴퍼넌트의 메세지의 로그를 취합니다.
LoggingPermission	SecurityManager에 의해 실행되는 코드가 Logger.setLevel 등의 로그 제어 메서드의 어느쪽이든을 호출할 때, SecurityManager가 체크하는 접근 권한입니다.
LogManager	Logger와 로그 서비스의 공유 상태세트를 관리하기 위해서 사용되는 단일의 글로벌 LogManager 객체가 있습니다.
LogRecord	LogRecord 객체를 사용해, 로그의 체제와 개개의 로그 Handler 간의 로깅의 요구를 건네줍니다.
MemoryHandler	메모리의 순환 버퍼의 요구를 버퍼 처리하는 Handler 입니다.
SimpleFormatter	LogRecord 개요를 판독 가능한 형식에서 출력합니다.
SocketHandler	간결한 네트워크 로그 Handler 입니다.
StreamHandler	스트림에 근거하는 로그 Handler 입니다.
XMLFormatter	LogRecord를 표준 XML 형식에서 포맷 합니다.

패키지 java.util.logging 설명

Java^TM 2 플랫폼의 코어로깅 기능의 클래스와 인터페이스를 제공합니다. 로깅 API 주된 목적은 고객의 사이트에서의 소프트웨어의 관리와 서비스를 지원하는 것입니다.

로그를 사용하는 주된 4개의 목적은 다음과 같습니다.

1. 「최종 사용자와 시스템 관리 책임자에 한 문제의 진단」. 이것은 자원의 부족, 시큐러티 장해 및 단순한 설정 에러 등, 로컬로 수복 또는 추적 가능한 자주 있는 문제의 간결한 로깅으로부터 구성된다
2. 「필드 서비스 엔지니어에 한 문제의 진단」. 필드 서비스 엔지니어가 사용하는 로그 정보는 시스템 관리 책임자가 필요한 정보보다 꽤 복잡하고 상세한 경우가 있다. 보통 이러한 정보는 특별한 하부조직내에서 부가적인 로깅이 필요하게 된다
3. 「개발 조직에 한 문제의 진단」. 필드에서 문제가 발생하면, 경우에 따라서는 받아들여진 로그 정보는 진단을 위해서 원의 개발 팀에 되돌려질 필요가 있다. 이 로그 정보는 매우 상세하고, 꽤 불가해한 것이 될 우려가 있다. 경우에 따라서는 이러한 정보에는 특정의 하부조직의 내부 실행의 상세한 트레이스가 포함된다
4. 「개발자에 한 문제의 진단」. 로깅 API를 사용해, 개발중의 어플리케이션의 디버그를 지원할 수도 있다. 이것에는 저레벨의 라이브러리가 생성하는 로그 정보와 함께 타겟 어플리케이션이 생성하는 로그 정보가 포함된다. 다만, 로그 정보를 이와 같이 사용하는 것은 지극히 적절한 것은 않지만, 로깅 API는 개발 환경에 이미 존재하는 보통 의 데밧깅과 프로 파일링 툴을 옮겨놓는 것은 아닌 것에 주의할 필요가 있다

이 패키지의 주된 요소는 다음과 같습니다.

• 「Logger」: 어플리케이션이 로그 호출을 실시하는 메인엔티티. Logger 객체를 사용해, 특정의 시스템 또는 어플리케이션 컴퍼넌트의 메세지의 로그를 취한다
• 「LogRecord」: 이것을 사용해, 로그 체제와 개개의 로그 핸들러와의 사이의 로깅 요구를 건네준다
• 「Handler」: LogRecord 객체를, 메모리, 출력 스트림, 콘솔, 파일 및 소켓 등 다양한 출력 먼저 export 한다. Handler 다양한 서브 클래스는 이 목적을 위해서 존재한다. 추가의 Handler가 Sun 이외로 개발되어 코어 플랫폼에 더해제공되는 경우가 있다
• 「Level」: 로그 출력을 제어하기 위해서 사용되는 표준 로그 레벨세트를 정의한다. 프로그램은 다른 레벨에서의 출력을 무시해 일부의 레벨의 로그를 출력하도록 구성할 수 있다
• 「Filter」: 로그 레벨이 제공하는 제어를 넘은 로그 데이터에 대한 치밀한 제어를 실시한다. 로깅 API 에서는 로그 출력을 제어하기 위해서 어플리케이션 코드가 임의의 필터에 접속할 수 있게 하는 다용도의 필터 도구를 지원 한다
• 「Formatter」: LogRecord 객체의 포맷 처리의 지원를 실시한다. 이 패키지에는 각각 plaintext 또는 XML 로 로그 레코드의 포맷 처리를 실시하는 SimpleFormatter와 XMLFormatter 2개의 포매터가 포함된다. Handler와 같게, 추가의 Formatter가 Sun 이외로 개발되는 경우가 있다

로깅 API는 정적 구성 제어 및 동적 구성 제어의 양쪽 모두를 제공합니다. 정적 제어에서는 필드 서비스 스탭이 특정의 구성을 설정해, 새로운 로그 설정으로 어플리케이션을 재시작할 수 있도록 합니다. 동적 제어는 현재 가동중의 프로그램내에서 로그 구성을 갱신할 수 있도록 합니다. 또, API는 시스템이 다른 기능 영역에 대해서 로깅을 사용 가능 또는 사용 불가로 할 수 있습니다. 예를 들어 필드 서비스 엔지니어가 모든 AWT 이벤트의 트레이스에 관심은 있지만, 소켓 이벤트나 메모리의 관리에 관심이 없는 경우가 있기 때문입니다.

null 포인터

일반적으로 javadoc 문서로 그 밖에 주기되어 있지 않은 한, 메서드와 생성자는 null 인수를 건네받으면 NullPointerException을 Throw 합니다. 이 규칙의 일반적인 예외로서는 Logger 클래스의 로그 간이 메서드 config, entering, exiting, fine, finer, finest, log, logp, logrb, severe, throwing 및 warning 메서드가 초기 Level 인수를 제외한 모든 인수에 대해 null 치를 받아들이는 것이 들고 있습니다 (존재하는 경우).

관련 문서

제어 흐름의 개요에 대해서는 「Java 로깅의 개요」를 참조하십시오.

도입된 버전 :

1.4