java.util.logging
클래스 Logger

java.lang.Object 
  java.util.logging.Logger

public class Logger
extends Object 

Logger 객체를 사용해, 특정의 시스템 또는 어플리케이션 컴퍼넌트의 메세지의 로그를 취합니다. 보통, Logger는 계층적인 닷으로 단락지어진 이름 공간을 사용해 이름을 붙일 수 있습니다. Logger 이름은 임의의 캐릭터 라인을 사용할 수 있습니다만, 일반적으로 java.net 또는 javax.swing와 같은 로그를 취하는 컴퍼넌트의 패키지명 또는 클래스명에 근거할 필요가 있습니다. 게다가 Logger 이름 공간에 포함되지 않는 익명의 Logger를 작성할 수도 있습니다.

Logger 객체는 getLogger 팩토리 메서드의 어떤 것인지를 호출하는 것으로 취득됩니다. 이 객체는 새로운 Logger를 작성하는지, 또는 기존의 적절한 Logger를 리턴합니다.

로그 메세지는 등록된 Handler 객체에 전송 됩니다. 이 객체는 콘솔, 파일, OS 로그 등 다양한 출력 먼저 메세지를 전송 할 수 있습니다.

각 Logger는 Logger 이름 공간에 있는 기존의 상위 클래스에 가장 가까운 「부모」Logger를 추적합니다.

각 Logger는 각각에 관련한 Level를 가집니다. 이것은 이 로거가 대상으로 하는 최소 Level를 반영합니다. Logger 레벨이 null로 설정되는 경우, Logger 유효한 레벨은 그 부모로부터 상속되고 그리고 또 부모는 그 부모로부터 재귀적으로 유효한 레벨을 취득합니다. 이것은 트리의 상위 방향으로 아래와 같이 행해집니다.

로그 레벨은 LogManager 클래스의 설명에 기술되고 있도록, 로그 구성 파일의 프로퍼티에 근거해 구성할 수 있습니다 . 다만, 로그 레벨은 Logger.setLevel 메서드의 호출에 의해 동적으로 변경되는 경우도 있습니다. 로거의 레벨이 변경되는 경우, 레벨이 null 자식 로거는 그 부모로부터 유효한 레벨을 상속하고 있으므로 변경에 의해자식 로거가 영향을 받는 일도 있습니다.

로그가 호출할 것에 Logger는 최초로 로거의 유효한 로그 레벨에 대해서 SEVERE 또는 FINE 등 요구 레벨의 간단한 검사를 실시합니다. 요구 레벨이 로그 레벨보다 낮은 경우, 즉시 로그의 호출이 복귀합니다.

이 초기 (간이) 테스트에 합격하면, Logger는 로그 메세지를 기술하기 위해서 LogRecord를 할당합니다. 다음에 Filter가 있는 경우는 그것을 호출해, 로그 레코드를 통지할 수 있을지 어떨지의 것보다 상세한 검사를 실시합니다. 거기에 합격하면, 출력 Handler에 LogRecord를 통지합니다. 디폴트에서는 로거는 부모의 Handler 에도 통지합니다. 이것은 계층의 상위 방향으로 재귀적으로 행해집니다.

각 Logger는 각각에 관련한 ResourceBundle 명을 가집니다. 이름 첨부 번들은 로그 메세지를 지역 대응화하기 위해서 사용됩니다. Logger가 독자적인 ResourceBundle 명을 가지지 않는 경우는 그 부모로부터 ResourceBundle 명을 상속합니다. 이것은 트리의 상위 방향으로 재귀적으로 행해집니다.

대부분의 로거출력 메서드는 msg 인수를 취득합니다. 이 msg 인수는 raw 치나 지역 대응 키의 머지않아인가입니다. 포맷 처리시에 로거가 지역 대응 ResourceBundle를 가지고 있든가 또는 상속하고 있는 경우 및 ResourceBundle가 msg 캐릭터 라인의 매핑을 가지고 있는 경우는 msg 캐릭터 라인은 지역화 된 값으로 옮겨집니다. 그 외의 경우는 원의 msg 캐릭터 라인이 사용됩니다. 보통, 포매터는 java.text.MessageFormat 스타일의 포맷 처리를 실시해, 파라미터를 포맷 합니다. 이 때문에 예를 들어 포맷 캐릭터 라인 {0} {1} 은 2개의 파라미터를 캐릭터 라인으로서 포맷 합니다.

ResourceBundle 이름을 ResourceBundle에 매핑 하면, Logger는 최초로 Thread ContextClassLoader 사용을 시도합니다. 이것이 null인 경우, 대신에 SystemClassLoader 사용을 시도합니다. 초기의 구현에 있어서의 일시적인 이행 기능으로서 Logger가 ContextClassLoader 또는 SystemClassLoader 로부터 ResourceBundle를 검출할 수 없는 경우는 Logger는 클래스의 스택을 검색해, 연속하는 호출 ClassLoader를 사용해 ResourceBundle 검출을 시도합니다. 이 호출 스택 검색에서는 컨테이너가 ContextClassLoader 사용으로 이행할 수 있도록 합니다만, 장래의 버전 으로 삭제될 가능성이 있습니다.

지역 대응을 포함한 포맷 처리는 보통 Formatter를 호출하는 출력 Handler를 담당합니다.

포맷 처리는 동기적으로 행해질 필요가 없는 것에 주의해 주세요. 이것은 LogRecord가 실제로 외부 세면대에 출력해질 때까지 지연 할 수 있습니다.

로깅메서드는 다음의 5개의 주된 카테고리로 분류됩니다.

• 로그 레벨, 메세지 캐릭터 라인 및 그 메세지 캐릭터 라인에의 임의의 파라미터를 얻는 log 메서드세트

• log 메서드에 유사하지만, 명시적인 소스 클래스명과 메서드명도 얻는 logp 메서드세트 (logp는 「log precise」의 약어)

• logp 메서드에 유사하지만, 로그 메세지의 지역화에 사용하는 명시적인 자원 번들명도 얻는 logrb 메서드세트 (logrb는 「log with resource bundle」의 약어)

• 메서드의 엔트리 (entering 메서드), 메서드의 복귀 (exiting 메서드) 및 예외의 Throw (throwing 메서드)를 추적하기 위한 간이 메서드

• 최후는 매우 간단한 케이스로 사용되는 간이 메서드세트. 개발자가 지정된 로그 레벨로 간단한 캐릭터 라인의 로그를 단지 취하고 싶을 때에 사용한다. 이러한 메서드는 「severe」, 「warning」, 「info」 등 표준 Level 명을 기념하여 이름을 붙일 수 있어 단일의 인수, 메세지 캐릭터 라인을 취득한다

명시적인 소스명과 메서드명을 취득하지 않는 메서드의 경우, Logging 체제는 「최선의 노력」을 실시해 어느 클래스와 메서드가 로그 메서드에 불러 들여졌는지를 판정합니다. 다만, 이 자동적으로 추정된 정보는 단순한 개략적인 것인가 완전히 잘못되어 있는 것 조차 있는 것을 인식하는 것이 중요합니다. 가상 머신은 JIT 컴파일시에 확장 최적화를 실시할 수가 있어 스택 프레임을 완전하게 삭제할 수 있습니다만, 클래스와 메서드의 호출의 확실한 검출은 할 수 없습니다.

Logger 모든 메서드는 multi-thread 세이프입니다.

상속에 관한 정보: LogManager 클래스는 이름 공간의 임의의 포인트에 대해서 지명된 Logger를 독자적으로 구현할 수 있는 것에 주의해 주세요. 이 때문에 Logger 임의의 서브 클래스는 새로운 LogManager 클래스와 함께 구현되어 있지 않은 경우, LogManager 클래스로부터의 Logger 인스턴스의 취득에는 주의가 필요하고, isLoggable 및 log(LogRecord)등의 오퍼레이션을 그 인스턴스에 위양 할 필요가 있습니다. 모든 로그 출력을 보충하기 위해서 서브 클래스는 log(LogRecord) 메서드만을 오버라이드(override) 할 필요가 있는 것에 주의해 주세요. 다른 모든 로그 메서드는 이 log(LogRecord) 메서드의 호출로서 구현됩니다.

도입된 버전 :

1.4

필드 개요

static Logger

global 「글로벌광ogger 객체는 Logging 패키지를 부담없이 사용하는 개발자를 간단하게 사용할 수 있도록 제공됩니다.

생성자 개요

protected

Logger (String name, String resourceBundleName) 이름 첨부 하부조직의 로거를 구축하는 protected 메서드입니다.

메서드 개요

void	addHandler (Handler handler) 로그 Handler를 추가해 로그 메세지를 받아들입니다.
void	config (String msg) CONFIG 메세지의 로그를 취합니다.
void	entering (String sourceClass, String sourceMethod) 메서드 엔트리의 로그를 취합니다.
void	entering (String sourceClass, String sourceMethod, Object param1) 1개의 파라미터를 가지는 메서드 엔트리의 로그를 취합니다.
void	entering (String sourceClass, String sourceMethod, Object [] params) 파라미터의 배열을 가지는 메서드 엔트리의 로그를 취합니다.
void	exiting (String sourceClass, String sourceMethod) 메서드 복귀의 로그를 취합니다.
void	exiting (String sourceClass, String sourceMethod, Object result) 결과 객체를 가지는 메서드 복귀의 로그를 취합니다.
void	fine (String msg) FINE 메세지의 로그를 취합니다.
void	finer (String msg) FINER 메세지의 로그를 취합니다.
void	finest (String msg) FINEST 메세지의 로그를 취합니다.
static Logger	getAnonymousLogger () 익명 Logger를 작성합니다.
static Logger	getAnonymousLogger (String resourceBundleName) 익명 Logger를 작성합니다.
Filter	getFilter () 이 Logger 현재의 필터를 리턴합니다.
Handler []	getHandlers () 이 로거에 관련한 Handler를 리턴합니다.
Level	getLevel () 이 로거에 임해서 지정된 로그 레벨을 리턴합니다.
static Logger	getLogger (String name) 이름 첨부 하부조직의 로거를 검출하든가 또는 작성합니다.
static Logger	getLogger (String name, String resourceBundleName) 이름 첨부 하부조직의 로거를 검출하든가 또는 작성합니다.
String	getName () 이 로거의 이름을 리턴합니다.
Logger	getParent () 이 로거의 부모를 리턴합니다.
ResourceBundle	getResourceBundle () 현재의 디폴트 로케일로 이 로거의 지역 대응 자원 번들을 취득합니다.
String	getResourceBundleName () 이 로거의 지역 대응 자원 번들명을 취득합니다.
boolean	getUseParentHandlers () 이 로거가 출력을 그 친로거에 송신하고 있을지 어떨지를 검출합니다.
void	info (String msg) INFO 메세지의 로그를 취합니다.
boolean	isLoggable (Level level) 지정된 레벨의 메세지가 이 로거로 실제로 로그를 빼앗길지 어떨지를 조사합니다.
void	log (Level level, String msg) 인수가 없는 메세지의 로그를 취합니다.
void	log (Level level, String msg, Object param1) 1개의 객체의 파라미터를 가지는 메세지의 로그를 취합니다.
void	log (Level level, String msg, Object [] params) 객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.
void	log (Level level, String msg, Throwable thrown) 관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.
void	log (LogRecord record) LogRecord 로그를 취합니다.
void	logp (Level level, String sourceClass, String sourceMethod, String msg) 소스 클래스와 메서드를 지정하는 인수가 없는 메세지의 로그를 취합니다.
void	logp (Level level, String sourceClass, String sourceMethod, String msg, Object param1) 소스 클래스와 메서드를 지정해, 로그 메세지에 대해서 단일의 객체 파라미터를 가지는 메세지의 로그를 취합니다.
void	logp (Level level, String sourceClass, String sourceMethod, String msg, Object [] params) 소스 클래스와 메서드를 지정하는 객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.
void	logp (Level level, String sourceClass, String sourceMethod, String msg, Throwable thrown) 소스 클래스와 메서드를 지정해, 관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.
void	logrb (Level level, String sourceClass, String sourceMethod, String bundleName, String msg) 소스 클래스, 메서드 및 자원 번들명을 지정해, 인수가 없는 메세지의 로그를 취합니다.
void	logrb (Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object param1) 소스 클래스, 메서드 및 자원 번들명을 지정해, 로그 메세지에 대해서 단일의 객체 파라미터를 가지는 메세지의 로그를 취합니다.
void	logrb (Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Object [] params) 소스 클래스, 메서드 및 자원 번들명을 지정해, 객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.
void	logrb (Level level, String sourceClass, String sourceMethod, String bundleName, String msg, Throwable thrown) 소스 클래스, 메서드 및 자원 번들명을 지정해, 관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.
void	removeHandler (Handler handler) 로그 Handler를 삭제합니다.
void	setFilter (Filter newFilter) 필터를 설정해 이 Logger 출력을 제어합니다.
void	setLevel (Level newLevel) 이 로거에 의해 로그가 취해지는 메세지 레벨을 지정하는 로그 레벨을 설정합니다.
void	setParent (Logger parent) 이 Logger 부모를 설정합니다.
void	setUseParentHandlers (boolean useParentHandlers) 이 로거가 출력을 그 친 Logger에 송신할지 어떨지를 지정합니다.
void	severe (String msg) SEVERE 메세지의 로그를 취합니다.
void	throwing (String sourceClass, String sourceMethod, Throwable thrown) 예외를 Throw 하는 로그를 취합니다.
void	warning (String msg) WARNING 메세지의 로그를 취합니다.

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

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

필드의 상세

global

public static final Logger  global

「글로벌광ogger 객체는 Logging 패키지를 부담없이 사용하는 개발자를 간단하게 사용할 수 있도록 제공됩니다. 제품등으로 로깅팍케이지를 본격적으로 사용하는 개발자는 적절한 이름을 가지는 자기 자신의 Logger 객체를 작성해 사용할 필요가 있어, 그것에 의해 로깅을 Logger 마다 적절한 세분도로 제어할 수 있습니다.

글로벌 로거는 Logger.getLogger("global")의 호출에 의해 초기화됩니다.

생성자 상세

Logger

protected Logger(String  name,
                 String  resourceBundleName)

이름 첨부 하부조직의 로거를 구축하는 protected 메서드입니다.

당초, 로거는 Level가 null, useParentHandlers가 true 로 구성됩니다.

파라미터:

name - 로거의 이름. 이것은 java.net 또는 javax.swing와 같이 닷으로 단락지어져 보통 하부조직의 패키지명 또는 클래스명에 근거한 이름이 아니면 안된다. 익명 Logger는 null

resourceBundleName - 이 로거의 메세지를 지역화하기 위해서 사용되는 ResourceBundle 이름. 메세지의 지역 대응이 불요의 경우는 null

예외:

MissingResourceException - ResourceBundleName가 null이 아닌 경우로 대응하는 자원이 발견되지 않는 경우

메서드의 상세

getLogger

public static Logger  getLogger(String  name)

이름 첨부 하부조직의 로거를 검출하든가 또는 작성합니다. 이미 로거가 지정된 이름으로 작성되고 있는 경우, 그것이 리턴됩니다 . 그렇지 않은 경우는 새로운 로거가 작성됩니다.

새로운 로거가 작성되는 경우, 그 로그 레벨은 LogManager 구성에 근거해 설정되어 또 그 로그 출력을 부모의 핸들러에 송신하도록 설정됩니다. 이것은 LogManager 글로벌 이름 공간에 등록됩니다.

파라미터:

name - 로거의 이름. 이것은 java.net 또는 javax.swing와 같이 닷으로 단락지어져 보통 하부조직의 패키지명 또는 클래스명에 근거한 이름이 아니면 안된다

반환값:

적절한 Logger

예외:

NullPointerException - 이름이 null인 경우

getLogger

public static Logger  getLogger(String  name,
                               String  resourceBundleName)

이름 첨부 하부조직의 로거를 검출하든가 또는 작성합니다. 이미 로거가 지정된 이름으로 작성되고 있는 경우, 그것이 리턴됩니다 . 그렇지 않은 경우는 새로운 로거가 작성됩니다.

새로운 로거가 작성되는 경우, 그 로그 레벨은 LogManager 구성에 근거해 설정되어 또 그 로그 출력을 부모 로거 Handler에 송신하도록 설정됩니다. 이것은 LogManager 글로벌 이름 공간에 등록됩니다.

이름 첨부 Logger가 이미 존재해, 아직 지역 대응 자원 번들을 가지지 않는 경우, 지정된 자원 번들명이 사용됩니다. 이름 첨부 Logger가 이미 존재해, 다른 자원 번들명을 가지는 경우, IllegalArgumentException가 발생 됩니다.

파라미터:

name - 로거의 이름. 이것은 java.net 또는 javax.swing와 같이 닷으로 단락지어져 보통 하부조직의 패키지명 또는 클래스명에 근거한 이름이 아니면 안되는

resourceBundleName - 이 로거의 메세지를 지역화하기 위해서 사용되는 ResourceBundle 이름. 메세지의 지역 대응이 불요의 경우는 null

반환값:

적절한 Logger

예외:

MissingResourceException - 이름 첨부 ResourceBundle가 발견되지 않는 경우

IllegalArgumentException - Logger가 이미 존재해, 다른 자원 번들명을 사용하고 있는 경우

NullPointerException - 이름이 null인 경우

getAnonymousLogger

public static Logger  getAnonymousLogger()

익명 Logger를 작성합니다. 새롭게 작성된 Logger는 LogManager 이름 공간에 등록되지 않습니다. 로거의 갱신시에 액세스 체크는 없습니다.

이 팩토리 메서드는 주로 애플릿으로부터의 사용을 대상으로 하고 있습니다. 결과의 Logger가 익명이기 때문에 작성 클래스는 private 로서 보관 유지됩니다. 이것은 보통 의 시큐러티 체크를 불필요하게 하므로 신뢰할 수 없는 애플릿 코드가 Logger 제어 상태를 갱신할 수 있게 됩니다. 예를 들어 애플릿은 익명 Logger 로 setLevel 또는 addHandler를 실행할 수 있습니다.

새로운 로거가 익명의 경우여도, 그 부모로서 루트 로거 ("")를 가지도록 구성할 수 있습니다. 이것은 디폴트로 루트 로거로부터 유효한 레벨과 핸들러를 상속하는 것을의미합니다.

반환값:

새롭게 작성된 private Logger

getAnonymousLogger

public static Logger  getAnonymousLogger(String  resourceBundleName)

익명 Logger를 작성합니다. 새롭게 작성된 Logger는 LogManager 이름 공간에 등록되지 않습니다. 로거의 갱신시에 액세스 체크는 없습니다.

이 팩토리 메서드는 주로 애플릿으로부터의 사용을 대상으로 하고 있습니다. 결과의 Logger가 익명이기 때문에 작성 클래스는 private 로서 보관 유지됩니다. 이것은 보통 의 시큐러티 체크를 불필요하게 하므로 신뢰할 수 없는 애플릿 코드가 Logger 제어 상태를 갱신할 수 있게 됩니다. 예를 들어 애플릿은 익명 Logger 로 setLevel 또는 addHandler를 실행할 수 있습니다.

새로운 로거가 익명의 경우여도, 그 부모로서 루트 로거 ("")를 가지도록 구성할 수 있습니다. 이것은 디폴트로 루트 로거로부터 유효한 레벨과 핸들러를 상속하는 것을의미합니다.

파라미터:

resourceBundleName - 이 로거의 메세지를 지역화하기 위해서 사용되는 ResourceBundle 이름. 메세지의 지역 대응이 불요의 경우는 null

반환값:

새롭게 작성된 private Logger

예외:

MissingResourceException - 이름 첨부 ResourceBundle가 발견되지 않는 경우

getResourceBundle

public ResourceBundle  getResourceBundle()

현재의 디폴트 로케일로 이 로거의 지역 대응 자원 번들을 취득합니다. 결과가 null인 경우, Logger는 그 부모로부터 상속된 자원 번들을 사용하는 것에 주의해 주세요.

반환값:

지역 대응 번들 (null인 경우가 있다)

getResourceBundleName

public String  getResourceBundleName()

이 로거의 지역 대응 자원 번들명을 취득합니다. 결과가 null인 경우, Logger는 그 부모로부터 상속된 자원 번들을 사용하는 것에 주의해 주세요.

반환값:

지역 대응 번들의 이름 (null인 경우가 있다)

setFilter

public void setFilter(Filter  newFilter)
               throws SecurityException 

필터를 설정해 이 Logger 출력을 제어합니다.

초기의 「레벨」검사에 합격하면, Logger는 이 Filter를 호출해 로그 레코드가 실제로 통지될지 어떨지를 조사합니다.

파라미터:

newFilter - 필터 객체 (null인 경우가 있다)

예외:

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

getFilter

public Filter  getFilter()

이 Logger 현재의 필터를 리턴합니다.

반환값:

필터 객체 (null인 경우가 있다)

log

public void log(LogRecord  record)

LogRecord 로그를 취합니다.

이 클래스외의 모든 로그 메서드는 이 메서드를 통해서 호출해, 실제로 로깅을 실행합니다. 서브 클래스는 이 메서드만을 오버라이드(override)의해 모든 로그 작업을 수중에 넣을 수가 있습니다.

파라미터:

record - 통지되는 LogRecord

log

public void log(Level  level,
                String  msg)

인수가 없는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

log

public void log(Level  level,
                String  msg,
                Object  param1)

1개의 객체의 파라미터를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

param1 - 메세지의 파라미터

log

public void log(Level  level,
                String  msg,
                Object [] params)

객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

params - 메세지의 파라미터의 배열

log

public void log(Level  level,
                String  msg,
                Throwable  thrown)

관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 인수가 등록된 모든 출력 핸들러에 전송 된 LogRecord에 포함됩니다.

발생되는 인수는 LogRecord 파라미터의 프로퍼티가 아니고, LogRecord 발생되는 프로퍼티에 포함되는 것에 주의해 주세요. 이와 같이, 이 인수는 출력 Formatter에 의해 특별히 처리되어 LogRecord 메세지 프로퍼티의 포맷 처리 파라미터로서는 취급되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

thrown - 로그 메세지에 관련한 Throwable

logp

public void logp(Level  level,
                 String  sourceClass,
                 String  sourceMethod,
                 String  msg)

소스 클래스와 메서드를 지정하는 인수가 없는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

logp

public void logp(Level  level,
                 String  sourceClass,
                 String  sourceMethod,
                 String  msg,
                 Object  param1)

소스 클래스와 메서드를 지정해, 로그 메세지에 대해서 단일의 객체 파라미터를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

param1 - 로그 메세지의 파라미터

logp

public void logp(Level  level,
                 String  sourceClass,
                 String  sourceMethod,
                 String  msg,
                 Object [] params)

소스 클래스와 메서드를 지정하는 객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

params - 메세지의 파라미터의 배열

logp

public void logp(Level  level,
                 String  sourceClass,
                 String  sourceMethod,
                 String  msg,
                 Throwable  thrown)

소스 클래스와 메서드를 지정해, 관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 인수가 등록된 모든 출력 핸들러에 전송 된 LogRecord에 포함됩니다.

발생되는 인수는 LogRecord 파라미터의 프로퍼티가 아니고, LogRecord 발생되는 프로퍼티에 포함되는 것에 주의해 주세요. 이와 같이, 이 인수는 출력 Formatter에 의해 특별히 처리되어 LogRecord 메세지 프로퍼티의 포맷 처리 파라미터로서는 취급되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

thrown - 로그 메세지에 관련한 Throwable

logrb

public void logrb(Level  level,
                  String  sourceClass,
                  String  sourceMethod,
                  String  bundleName,
                  String  msg)

소스 클래스, 메서드 및 자원 번들명을 지정해, 인수가 없는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

msg 캐릭터 라인은 이름 첨부 자원 번들을 사용해 지역화 됩니다. 자원 번들명이 null, 비어있는 String, 또는 무효인 경우, msg 캐릭터 라인은 지역화 되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

bundleName - msg를 지역화하기 위한 자원 번들명. null인 경우가 있는

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

logrb

public void logrb(Level  level,
                  String  sourceClass,
                  String  sourceMethod,
                  String  bundleName,
                  String  msg,
                  Object  param1)

소스 클래스, 메서드 및 자원 번들명을 지정해, 로그 메세지에 대해서 단일의 객체 파라미터를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

msg 캐릭터 라인은 이름 첨부 자원 번들을 사용해 지역화 됩니다. 자원 번들명이 null, 비어있는 String, 또는 무효인 경우, msg 캐릭터 라인은 지역화 되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

bundleName - msg를 지역화하기 위한 자원 번들명. null인 경우가 있는

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

param1 - 로그 메세지의 파라미터

logrb

public void logrb(Level  level,
                  String  sourceClass,
                  String  sourceMethod,
                  String  bundleName,
                  String  msg,
                  Object [] params)

소스 클래스, 메서드 및 자원 번들명을 지정해, 객체의 인수의 배열을 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 대응하는 LogRecord가 작성되어 등록된 모든 출력 Handler 객체에 전송 됩니다.

msg 캐릭터 라인은 이름 첨부 자원 번들을 사용해 지역화 됩니다. 자원 번들명이 null, 비어있는 String, 또는 무효인 경우, msg 캐릭터 라인은 지역화 되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

bundleName - msg를 지역화하기 위한 자원 번들명. null인 경우가 있는

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

params - 메세지의 파라미터의 배열

logrb

public void logrb(Level  level,
                  String  sourceClass,
                  String  sourceMethod,
                  String  bundleName,
                  String  msg,
                  Throwable  thrown)

소스 클래스, 메서드 및 자원 번들명을 지정해, 관련된 Throwable 정보를 가지는 메세지의 로그를 취합니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 인수가 등록된 모든 출력 핸들러에 전송 된 LogRecord에 포함됩니다.

msg 캐릭터 라인은 이름 첨부 자원 번들을 사용해 지역화 됩니다. 자원 번들명이 null, 비어있는 String, 또는 무효인 경우, msg 캐릭터 라인은 지역화 되지 않습니다.

발생되는 인수는 LogRecord 파라미터의 프로퍼티가 아니고, LogRecord 발생되는 프로퍼티에 포함되는 것에 주의해 주세요. 이와 같이, 이 인수는 출력 Formatter에 의해 특별히 처리되어 LogRecord 메세지 프로퍼티의 포맷 처리 파라미터로서는 취급되지 않습니다.

파라미터:

level - 메세지 레벨 식별자의 1개. 예를 들어 SEVERE

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 로깅의 요구를 발행한 메서드명

bundleName - msg를 지역화하기 위한 자원 번들명. null인 경우가 있는

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

thrown - 로그 메세지에 관련한 Throwable

entering

public void entering(String  sourceClass,
                     String  sourceMethod)

메서드 엔트리의 로그를 취합니다.

이것은 메서드의 엔트리의 로그를 취하기 위해서 사용되는 간이 메서드입니다. 메세지 「ENTRY」, 로그 레벨 FINER 및 지정된 sourceMethod와 sourceClass를 가지는 LogRecord가 기록됩니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 엔트리 하고 있는 메서드명

entering

public void entering(String  sourceClass,
                     String  sourceMethod,
                     Object  param1)

1개의 파라미터를 가지는 메서드 엔트리의 로그를 취합니다.

이것은 메서드의 엔트리의 로그를 취하기 위해서 사용되는 간이 메서드입니다. 메세지 「ENTRY {0}」, 로그 레벨 FINER 및 지정된 sourceMethod, sourceClass, 파라미터를 가지는 LogRecord가 기록됩니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 엔트리 하고 있는 메서드명

param1 - 엔트리 하고 있는 메서드의 파라미터

entering

public void entering(String  sourceClass,
                     String  sourceMethod,
                     Object [] params)

파라미터의 배열을 가지는 메서드 엔트리의 로그를 취합니다.

이것은 메서드의 엔트리의 로그를 취하기 위해서 사용되는 간이 메서드입니다. 그 후에 파라미터 배열의 각 엔트리의 포맷 {N} 인디케이터(indicator)가 계속되는 메세지 「ENTRY」, 로그 레벨 FINER, 지정된 sourceMethod, sourceClass 및 파라미터를 가지는 LogRecord가 기록됩니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 엔트리 하고 있는 메서드명

params - 엔트리 하고 있는 메서드의 파라미터의 배열

exiting

public void exiting(String  sourceClass,
                    String  sourceMethod)

메서드 복귀의 로그를 취합니다.

이것은 메서드로부터의 복귀의 로그를 취하기 위해서 사용되는 간이 메서드입니다. 메세지 「RETURN」, 로그 레벨 FINER 및 지정된 sourceMethod와 sourceClass를 가지는 LogRecord가 기록됩니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 메서드의 이름

exiting

public void exiting(String  sourceClass,
                    String  sourceMethod,
                    Object  result)

결과 객체를 가지는 메서드 복귀의 로그를 취합니다.

이것은 메서드로부터의 복귀의 로그를 취하기 위해서 사용되는 간이 메서드입니다. 메세지 「RETURN {0}」, 로그 레벨 FINER 및 지정된 sourceMethod, sourceClass 및 결과 객체를 가지는 LogRecord가 기록됩니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 메서드의 이름

result - 리턴된 객체

throwing

public void throwing(String  sourceClass,
                     String  sourceMethod,
                     Throwable  thrown)

예외를 Throw 하는 로그를 취합니다.

이것은 메서드가 예외를 Throw 해, 메서드가 종료하는 로그를 취하기 위한 간이 메서드입니다. 로깅은 FINER 레벨을 사용해 실행됩니다.

지정된 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 인수가 등록된 모든 출력 핸들러에 전송 된 LogRecord에 포함됩니다. LogRecord 메세지는 「THROW」로 설정됩니다.

발생되는 인수는 LogRecord 파라미터의 프로퍼티가 아니고, LogRecord 발생되는 프로퍼티에 포함되는 것에 주의해 주세요. 이와 같이, 이 인수는 출력 Formatter에 의해 특별히 처리되어 LogRecord 메세지 프로퍼티의 포맷 처리 파라미터로서는 취급되지 않습니다.

파라미터:

sourceClass - 로깅의 요구를 발행한 클래스명

sourceMethod - 메서드의 이름

thrown - Throw 된 Throwable

severe

public void severe(String  msg)

SEVERE 메세지의 로그를 취합니다.

SEVERE 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 핸들러에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

warning

public void warning(String  msg)

WARNING 메세지의 로그를 취합니다.

WARNING 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

info

public void info(String  msg)

INFO 메세지의 로그를 취합니다.

INFO 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

config

public void config(String  msg)

CONFIG 메세지의 로그를 취합니다.

CONFIG 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

fine

public void fine(String  msg)

FINE 메세지의 로그를 취합니다.

FINE 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

finer

public void finer(String  msg)

FINER 메세지의 로그를 취합니다.

FINER 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

finest

public void finest(String  msg)

FINEST 메세지의 로그를 취합니다.

FINEST 메세지 레벨로 현재 로거가 사용 가능한 경우, 지정된 메세지는 등록된 모든 출력 Handler 객체에 전송 됩니다.

파라미터:

msg - 캐릭터 라인 메세지, 또는 메세지 카탈로그의 키

setLevel

public void setLevel(Level  newLevel)
              throws SecurityException 

이 로거에 의해 로그가 취해지는 메세지 레벨을 지정하는 로그 레벨을 설정합니다. 이 값보다 작은 메세지 레벨은 파기됩니다. 레벨의 값 Level.OFF를 사용해, 로깅을 오프로 합니다.

새로운 레벨이 null인 경우, 이 노드가 null 이외의 특정의 레벨치를 가지는 가장 가까운 상위 노드로부터, 그 레벨을 상속하는 것을의미합니다.

파라미터:

newLevel - 로그 레벨의 새로운 값 (null인 경우가 있다)

예외:

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

getLevel

public Level  getLevel()

이 로거에 임해서 지정된 로그 레벨을 리턴합니다. 결과가 null인 경우, 이 로거의 유효한 레벨은 그 부모로부터 상속되는 것을의미합니다.

반환값:

이 Logger 레벨

isLoggable

public boolean isLoggable(Level  level)

지정된 레벨의 메세지가 이 로거로 실제로 로그를 빼앗길지 어떨지를 조사합니다. 이 검사는 Logger 유효한 레벨에 근거합니다. 이 레벨은 그 부모로부터 상속되는 경우가 있습니다.

파라미터:

level - 메세지의 로그를 취하는 레벨

반환값:

지정된 메세지 레벨로 현재 로그가 취해지고 있는 경우는 true

getName

public String  getName()

이 로거의 이름을 리턴합니다.

반환값:

로거의 이름. 익명 Logger인 경우는 null

addHandler

public void addHandler(Handler  handler)
                throws SecurityException 

로그 Handler를 추가해 로그 메세지를 받아들입니다.

디폴트로 Logger는 그 출력을 부모 로거에도 송신합니다. 보통, 루트 Logger는 모든 로거의 디폴트 핸들러로서 실질적으로 동작하는 Handler 세트에 의해 구성됩니다.

파라미터:

handler - 로그 Handler

예외:

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

removeHandler

public void removeHandler(Handler  handler)
                   throws SecurityException 

로그 Handler를 삭제합니다.

지정된 Handler가 발견되지 않는가 null인 경우, 아무것도 실시하지 않고 복귀합니다.

파라미터:

handler - 로그 Handler

예외:

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

getHandlers

public Handler [] getHandlers()

이 로거에 관련한 Handler를 리턴합니다.

반환값:

모든 등록된 Handler 배열

setUseParentHandlers

public void setUseParentHandlers(boolean useParentHandlers)

이 로거가 출력을 그 친 Logger에 송신할지 어떨지를 지정합니다. 이것은 모든 LogRecord가 부모의 Handler 에도 출력해져 또한 그 부모에게도 출력해질 가능성이 있는 것을의미합니다. 이것은 이름 공간의 상위 방향으로 재귀적으로 행해집니다.

파라미터:

useParentHandlers - 출력이 로거의 부모에게 송신되는 경우는 true

예외:

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

getUseParentHandlers

public boolean getUseParentHandlers()

이 로거가 출력을 그 친로거에 송신하고 있을지 어떨지를 검출합니다.

반환값:

출력이 로거의 부모에게 송신되는 경우는 true

getParent

public Logger  getParent()

이 로거의 부모를 리턴합니다.

이 메서드는 이름 공간에서 가장 가까운 현존 하는 부모를 리턴합니다. 따라서, Logger가 「a.b.c.d」라고 불려 「a.b」라고 불리는 Logger가 작성되어, 로거 「a.b.c」가 존재하지 않는 경우, Logger 「a.b.c.d」의 getParent 호출은 Logger 「a.b」를 리턴합니다.

이름 공간의 루트 Logger를 호출하는 경우, 결과는 null이 됩니다.

반환값:

가장 가까운 기존의 친 Logger

setParent

public void setParent(Logger  parent)

이 Logger 부모를 설정합니다. 이 메서드는 LogManager에 의해 사용되어 이름 공간이 변경되었을 때에 Logger를 갱신합니다.

이것은 어플리케이션 코드로부터 호출해서는 안됩니다.

파라미터:

parent - 새로운 친로거

예외:

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