패키지 java.util.logging

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

참조:
설명

인터페이스의 개요

Filter

Filter 는 로그 레벨이 제공하는 제어 이상으로, 로그 대상을 치밀하게 제어하기 위해서 사용됩니다.

클래스의 개요

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 는 시스템이 다른 기능 area에 대해서 로깅을 사용 가능 또는 사용 불가로 할 수 있습니다. 예를 들어, 필드 서비스 엔지니어가, 모든 AWT 이벤트의 트레이스에 관심은 있지만, 소켓 이벤트나 메모리의 관리에 관심이 없는 경우가 있기 때문입니다.

null 포인터

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

관련 항목

제어 플로우(flow)의 개요에 대해서는 다음을 참조해 주세요. 「Java 로깅의 개요」

도입된 버젼:

1.4