java.util.logging
클래스 LogManager

java.lang.Object 
  java.util.logging.LogManager

public class LogManager
extends Object 

Logger와 로그 서비스의 공유 상태세트를 관리하기 위해서 사용되는 단일의 글로벌 LogManager 객체가 있습니다.

이 LogManager에는 다음의 기능이 있습니다.

• Logger 객체의 계층적 이름 공간을 관리한다. 모든 이름 첨부 Logger는 이 이름 공간에 포함된다
• 로그 제어의 프로퍼티세트를 관리한다. 이러한 프로퍼티는 스스로를 구성하기 위해서 Handler 및 다른 로그 객체에 의해 사용되는 간결한 키와 값의 페어세트이다

글로벌 LogManager 객체는 LogManager.getLogManager()를 사용해 취득할 수 있습니다. LogManager 객체는 클래스를 초기화할 경우에 작성되어 그 후 변경을 할 수 없습니다.

LogManager 클래스는 시작시에 java.util.logging.manager 시스템 프로퍼티를 사용해 배치됩니다.

디폴트로 LogManager는 JRE 디렉토리의 프로퍼티 파일 lib/logging.properties 로부터 그 초기설정을 읽어들입니다. 프로퍼티 파일을 편집하는 경우, 그 JRE 모든 사용에 대해서 디폴트의 로그 구성을 변경할 수 있습니다.

또, LogManager는 초기 구성의 read를 보다 상세하게 제어할 수 있는 다음의 2개의 시스템 프로퍼티 옵션을 사용합니다.

• java.util.logging.config.class
• java.util.logging.config.file

이 2개의 프로퍼티는 Preferences API 에의해 java 커멘드에 대한 커멘드행 프로퍼티의 정의로서 또는 JNI_CreateJavaVM 에게 건네지는 시스템 프로퍼티의 정의로서 설정할 수 있습니다 .

java.util.logging.config.class 프로퍼티가 설정되는 경우, 프로퍼티의 값은 클래스명으로서 다루어집니다. 지정된 클래스가 로드 되어 객체의 인스턴스가 생성되어 그 객체의 생성자가 초기 구성의 read를 실시합니다. 이 객체는 구성을 제어하기 위해서 다른 시스템 프로퍼티를 사용하는 경우가 있습니다. 대체 구성 클래스는 readConfiguration(InputStream)를 사용해, LogManager 프로퍼티를 정의할 수 있습니다.

java.util.logging.config.class 프로퍼티가 설정되지 않는 경우, java.util.logging.config.file 시스템 프로퍼티를 사용해, java.util.Properties 형식에서 프로퍼티 파일을 지정할 수 있습니다. 초기 로그 구성은 이 파일로부터 읽힙니다.

이러한 프로퍼티의 모두 정의되지 않는 경우, 전술대로 LogManager는 JRE 디렉토리의 프로퍼티 파일 lib/logging.properties 로부터 그 초기 구성을 읽어들입니다.

로거와 Handler 프로퍼티는 핸들러나 로거에 관해서 닷으로 단락지어진 이름에서 시작되는 이름을 가집니다.

글로벌 로그의 프로퍼티에는 다음의 것이 있습니다.

• handlers 프로퍼티. 이것은 공백에서 단락지어진 핸들러 클래스의 클래스명의 리스트를 정의해, 루트 Logger ("" 라는 이름의 Logger)의 핸들러로서 로드해 등록한다. 각 클래스명은 디폴트 생성자를 가지는 Handler 클래스에 대한 이름이 아니면 안된다. 이러한 Handler는 최초로 사용될 때 늦어 작성되는 것에 주의한다
• <logger>.handlers 프로퍼티. 이것은 공백 또는 콤마로 단락지어진 핸들러 클래스의 클래스명의 리스트를 정의해, 지정한 로거의 핸들러로서 로드해 등록한다. 각 클래스명은 디폴트 생성자를 가지는 Handler 클래스에 대한 이름이 될 필요가 있다. 이러한 Handler는 최초로 사용될 때 늦어 작성되는 것에 주의한다
• <logger>.useParentHandlers 프로퍼티. 이것은 불리언 값을 정의한다. 디폴트에서는 모든 로거가 자신의 로깅멧세이지를 처리하는데 더해 그 부모를 호출해, 많은 경우에 루트 로거에서도 메세지가 처리되는 결과가 된다. 이 프로퍼티를 false 로 설정할 때는 Handler를 이 로거에 구성할 필요가 있다. 그렇게 하지 않는 경우, 로깅멧세이지가 전달되지 않는다
• config 프로퍼티. 이 프로퍼티는 임의의 설정 코드를 실행할 수 있도록 하는 것을 목적으로 한다. 프로퍼티는 공백에서 단락지어진 클래스명의 리스트를 정의한다. 각 이름 첨부 클래스에 대해서 새로운 인스턴스가 작성된다. 각 클래스의 디폴트 생성자는 임의의 코드를 실행해, 로거의 레벨의 설정, 핸들러의 추가 필터의 추가 등 로그 구성의 갱신을 할 수 있다

LogManager 구성시에 로드 된 모든 클래스는 모든 사용자 클래스 패스 이전에 우선 시스템의 클래스 패스로 검색되는 것에 주의해 주세요. 이것에는 LogManager 클래스, 모든 config 클래스, 모든 handler 클래스가 포함됩니다.

Logger는 닷으로 단락지어진 이름에 근거하는 네이밍 계층에 포함됩니다. 그 결과, 「a.b.c」는 「a.b」의 자식이 됩니다만, 「a.b1」 및 「a.b2」는 피어가 됩니다.

이름이 「. level」로 끝나는 모든 프로퍼티는 Logger 로그 레벨을 정의한다고 보여집니다. 따라서, 「foo.level」는 「foo」라고 불리는 로거 및 네이밍 계층에 있는 그자식 의 로그 레벨을 재귀적으로 정의합니다. 로그 레벨은 프로퍼티 파일로 정의된 순서로 적용됩니다. 따라서, 트리내의자식 노드에 대한 레벨의 설정은 부모에 대한 설정의 후에 실시할 필요가 있습니다. 프로퍼티명 「. level」를 사용해, 트리의 루트의 레벨을 설정할 수 있습니다.

LogManager 객체의 모든 메서드는 multi-thread 세이프입니다.

도입된 버전 :

1.4

필드 개요

static String

LOGGING_MXBEAN_NAME LoggingMXBean ObjectName 캐릭터 라인 표현입니다.

생성자 개요

protected

LogManager () protected 생성자 입니다.

메서드 개요

boolean	addLogger (Logger logger) 이름 첨부 로거를 추가합니다.
void	addPropertyChangeListener (PropertyChangeListener l) 로그 프로퍼티의 재독 보고 포함시에 호출되는 이벤트 리스너를 추가합니다.
void	checkAccess () 현재의 컨텍스트이 로그 구성의 변경에 있어 신뢰할 수 있을지 어떨지를 조사합니다.
Logger	getLogger (String name) 이름 첨부 로거를 검출하는 메서드입니다.
Enumeration <String >	getLoggerNames () 기존의 로거의 이름의 열거를 리턴합니다.
static LoggingMXBean	getLoggingMXBean () 로거를 관리하는 LoggingMXBean를 리턴합니다.
static LogManager	getLogManager () 글로벌 LogManager를 리턴합니다.
String	getProperty (String name) 로그 프로퍼티의 값을 취득합니다.
void	readConfiguration () 로그의 프로퍼티를 재차 초기화해 로그 구성을 재차 읽어들입니다.
void	readConfiguration (InputStream ins) 로그의 프로퍼티를 재차 초기화해, 로그 구성이 지정된 스트림로부터 재차 읽어들입니다.
void	removePropertyChangeListener (PropertyChangeListener l) 프로퍼티 변경 이벤트의 이벤트 리스너를 삭제합니다.
void	reset () 로그의 구성을 리셋 합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

LOGGING_MXBEAN_NAME

public static final String  LOGGING_MXBEAN_NAME

LoggingMXBean ObjectName 캐릭터 라인 표현입니다.

관련 항목:

정수 필드값

생성자 상세

LogManager

protected LogManager()

protected 생성자 입니다. 이것은 J2EE 컨테이너 등 컨테이너의 어플리케이션이 객체를 서브 클래스에 넣어지도록 보호됩니다. 이것은 값이 LogManager.getLogManager 호출에 의해 취득되는 LogManager 객체는 다만 1개 밖에 없다고 여겨지고 있으므로 public 형이 아닙니다.

메서드의 상세

getLogManager

public static LogManager  getLogManager()

글로벌 LogManager를 리턴합니다.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  l)
                               throws SecurityException 

로그 프로퍼티의 재독 보고 포함시에 호출되는 이벤트 리스너를 추가합니다. 동일한 이벤트 Listener 인스턴스를 복수 추가하면, 프로퍼티 이벤트 리스너 테이블에 복수의 엔트리가 존재하게 됩니다.

파라미터:

l - 이벤트 리스너

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

NullPointerException - PropertyChangeListener가 null인 경우

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  l)
                                  throws SecurityException 

프로퍼티 변경 이벤트의 이벤트 리스너를 삭제합니다. addPropertyChangeListener 복수의 호출을 사용해, 동일한 리스너 인스턴스가 리스너 테이블에 추가되고 있는 경우, 그 리스너의 모든 인스턴스를 리스너 테이블에서 삭제하려면, 동일한 수의 removePropertyChangeListener 호출이 필요하게 됩니다.

지정된 리스너가 발견되지 않는 경우는 아무것도 실시하지 않고 복귀합니다.

파라미터:

l - 이벤트 리스너 (null인 경우가 있다)

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

addLogger

public boolean addLogger(Logger  logger)

이름 첨부 로거를 추가합니다. 이것은 같은 이름 로거가 이미 등록되어 있는 경우, 아무것도 하지 않고 false를 리턴합니다.

Logger 팩토리 메서드는 이 메서드를 호출해, 새로운에 작성된 각 Logger를 등록합니다.

어플리케이션은 Logger 객체에 대한 스스로의 참조를 보관 유지해, 참조가 가비지 컬렉트되지 않게 할 필요가 있습니다. LogManager는 약참조만을 보관 유지할 수 있습니다 .

파라미터:

logger - 새로운 로거

반환값:

인수 로거가 정상적으로 등록되었을 경우는 true, 그 이름 로거가 이미 존재하는 경우는 false

예외:

NullPointerException - 로거의 이름이 null인 경우

getLogger

public Logger  getLogger(String  name)

이름 첨부 로거를 검출하는 메서드입니다.

신뢰할 수 없는 코드가 임의의 이름 로거를 작성하는 경우가 있으므로 이 메서드는 보안상 중요한 로깅용의 Logger 검출에는 사용하지 말아 주세요.

파라미터:

name - 로거의 이름

반환값:

일치하는 로거, 또는 발견되지 않는 경우는 null

getLoggerNames

public Enumeration <String > getLoggerNames()

기존의 로거의 이름의 열거를 리턴합니다.

주: Logger는 새로운 클래스가 로드 되면 동적으로 추가됩니다. 이 메서드는 현재 등록되어 있는 로거에만 붙어 통지합니다.

반환값:

로거이름의 캐릭터 라인의 열거

readConfiguration

public void readConfiguration()
                       throws IOException,

                              SecurityException 

로그의 프로퍼티를 재차 초기화해 로그 구성을 재차 읽어들입니다.

구성 프로퍼티의 배치에는 시작시에 사용된 같은 규칙이 사용됩니다. 이 때문에 보통 로그의 프로퍼티는 시작시에 사용된 같은 파일로부터 재독 보고 붐비어 됩니다.

새로운 구성 파일의 모든 로그 레벨의 정의는 타겟의 Logger가 있는 경우는 Logger.setLevel()를 사용해 적용됩니다.

PropertyChangeEvent는 프로퍼티가 읽히고 나서 트리거 됩니다.

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

IOException - 구성을 읽어들일 때 입출력의 문제가 발생했을 경우

reset

public void reset()
           throws SecurityException 

로그의 구성을 리셋 합니다.

모든 이름 첨부 로거에 관해서는 리셋 오퍼레이션은 모든 Handler를 삭제해 닫고 나서, 루트 로거이외를 레벨 null 로 설정합니다. 루트 로거의 레벨은 Level.INFO 로 설정됩니다.

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

readConfiguration

public void readConfiguration(InputStream  ins)
                       throws IOException,

                              SecurityException 

로그의 프로퍼티를 재차 초기화해, 로그 구성이 지정된 스트림로부터 재차 읽어들입니다. 이것은 java.util.Properties 형식이 아니면 안됩니다. PropertyChangeEvent는 프로퍼티가 읽히고 나서 트리거 됩니다.

새로운 구성 파일의 모든 로그 레벨의 정의는 타겟의 Logger가 있는 경우는 Logger.setLevel()를 사용해 적용됩니다.

파라미터:

ins - 프로퍼티를 읽어들이는 스트림

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

IOException - 스트림로부터의 read에 문제가 있는 경우

getProperty

public String  getProperty(String  name)

로그 프로퍼티의 값을 취득합니다. 프로퍼티가 발견되지 않는 경우, 이 메서드는 null을 리턴합니다.

파라미터:

name - 프로퍼티명

반환값:

프로퍼티의 값

checkAccess

public void checkAccess()
                 throws SecurityException 

현재의 컨텍스트이 로그 구성의 변경에 있어 신뢰할 수 있을지 어떨지를 조사합니다. 이것에는 LoggingPermission("control")가 필요합니다.

이 체크에 실패했을 경우는 SecurityException을 Throw 합니다. 그렇지 않은 경우는 정상적으로 복귀합니다.

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 LoggingPermission("control")를 가지지 않는 경우

getLoggingMXBean

public static LoggingMXBean  getLoggingMXBean()

로거를 관리하는 LoggingMXBean를 리턴합니다. LoggingMXBean는 platform MBeanServer 메서드로부터도 취득할 수 있습니다.

반환값:

LoggingMXBean 객체

관련 항목:

ManagementFactory