java.util.logging
클래스 Handler

java.lang.Object 
  java.util.logging.Handler

알려진 직계 서브 클래스:

MemoryHandler, StreamHandler

public abstract class Handler
extends Object 

Handler 객체는 Logger로 부터 로그 메세지를 취득해, 그것들을 써냅니다. 예를 들어이 객체는 콘솔이나 파일에 출력해, 네트워크 로그 서비스에 송신해, OS 로그에의 전송등을 실행합니다.

Handler는 setLevel(Level.OFF)를 실행해 사용 불가로 해, setLevel를 적절한 레벨로 실행해 재차 사용 가능하게 할 수 있습니다 .

보통, Handler 클래스는 LogManager 프로퍼티를 사용해 Handler Filter, Formatter 및 Level 기본값을 설정합니다. 각 구상 Handler 클래스에 대해서는 각각의 문서를 참조하십시오.

도입된 버전 :

1.4

생성자 개요

protected

Handler () 디폴트의 생성자 입니다.

메서드 개요

abstract void	close () Handler를 닫아, 관련된 모든 자원을 해방합니다.
abstract void	flush () 버퍼링 된 출력을 플래시 합니다.
String	getEncoding () 이 Handler 캐릭터셋를 리턴합니다.
ErrorManager	getErrorManager () 이 Handler ErrorManager를 취득합니다.
Filter	getFilter () 이 Handler 현재의 Filter를 취득합니다.
Formatter	getFormatter () 이 Handler Formatter를 리턴합니다.
Level	getLevel () 이 Handler가 로그를 취하는 메세지를 지정하는 로그 레벨을 취득합니다.
boolean	isLoggable (LogRecord record) 이 Handler가 지정된 LogRecord 로그를 실제로 취할지 어떨지를 조사합니다.
abstract void	publish (LogRecord record) LogRecord를 발행합니다.
protected void	reportError (String msg, Exception ex, int code) 이 Handler ErrorManager에 에러를 통지하는 간이 protected 메서드입니다.
void	setEncoding (String encoding) 이 Handler가 사용하는 캐릭터셋를 설정합니다.
void	setErrorManager (ErrorManager em) 이 Handler ErrorManager를 정의합니다.
void	setFilter (Filter newFilter) 이 Handler 출력을 제어하는 Filter를 설정합니다.
void	setFormatter (Formatter newFormatter) Formatter를 설정합니다.
void	setLevel (Level newLevel) 이 Handler가 로그를 취하는 메세지 레벨을 지정하는 로그 레벨을 설정합니다.

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

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

생성자 상세

Handler

protected Handler()

디폴트의 생성자 입니다. Handler 결과는 로그 레벨 Level.ALL를 가져, Formatter와 Filter는 가지지 않습니다. 디폴트의 ErrorManager 인스턴스는 ErrorManager로 서 인스톨 됩니다.

메서드의 상세

publish

public abstract void publish(LogRecord  record)

LogRecord를 발행합니다.

초기 상태에서는 로깅의 요구는 Logger 객체에 대해서 행해져 이 객체는 LogRecord를 초기화해 여기에 전송 했습니다.

Handler는 필요에 따라서 메세지의 포맷 처리를 담당합니다. 포맷 처리에는 지역 대응이 포함됩니다.

파라미터:

record - 로그 이벤트의 설명. null 레코드는 단지 무시되는 것만으로 통지는 행해지지 않는다

flush

public abstract void flush()

버퍼링 된 출력을 플래시 합니다.

close

public abstract void close()
                    throws SecurityException 

Handler를 닫아, 관련된 모든 자원을 해방합니다.

close 메서드는 flush를 실행하고 나서 Handler를 닫습니다. Close가 불려 간 뒤는 이 Handler는 사용되지 않습니다. 메서드의 호출은 아무것도 실시하지 않고 무시되는지, 실행시 예외를 Throw 합니다.

예외:

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

setFormatter

public void setFormatter(Formatter  newFormatter)
                  throws SecurityException 

Formatter를 설정합니다. 이 Formatter를 사용해, 이 Handler LogRecord를 포맷 합니다.

일부의 Handler는 Formatter를 사용하지 않습니다. 그 경우, Formatter는 기억되는 것만으로 사용되지 않습니다.

파라미터:

newFormatter - 사용하는 Formatter (null 이외)

예외:

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

getFormatter

public Formatter  getFormatter()

이 Handler Formatter를 리턴합니다.

반환값:

Formatter (null인 경우가 있다)

setEncoding

public void setEncoding(String  encoding)
                 throws SecurityException,

                        UnsupportedEncodingException 

이 Handler가 사용하는 캐릭터셋를 설정합니다.

인코딩은, LogRecord가 Handler에 출력해지기 전으로 설정할 필요가 있습니다.

파라미터:

encoding - 지원 되는 캐릭터셋의 이름. null인 경우는 디폴트 플랫폼의 인코딩을 나타낸다

예외:

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

UnsupportedEncodingException - 지정된 캐릭터셋가 지원 되어 있지 않은 경우

getEncoding

public String  getEncoding()

이 Handler 캐릭터셋를 리턴합니다.

반환값:

인코딩명. null인 경우는 디폴트의 인코딩이 사용되는 것을 나타낸다

setFilter

public void setFilter(Filter  newFilter)
               throws SecurityException 

이 Handler 출력을 제어하는 Filter를 설정합니다.

publish가 호출할 것에 Handler는 이 Filter (null이 아닌 경우)를 호출해 LogRecord가 통지되었는지, 또는 파기되었는지를 조사합니다.

파라미터:

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

예외:

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

getFilter

public Filter  getFilter()

이 Handler 현재의 Filter를 취득합니다.

반환값:

Filter 객체 (null인 경우가 있다)

setErrorManager

public void setErrorManager(ErrorManager  em)

이 Handler ErrorManager를 정의합니다.

ErrorManager error 메서드는 이 Handler를 사용중에 에러가 발생했을 경우에 호출합니다.

파라미터:

em - 새로운 ErrorManager

예외:

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

getErrorManager

public ErrorManager  getErrorManager()

이 Handler ErrorManager를 취득합니다.

예외:

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

reportError

protected void reportError(String  msg,
                           Exception  ex,
                           int code)

이 Handler ErrorManager에 에러를 통지하는 간이 protected 메서드입니다. 이 메서드는 시큐러티 체크를 하지 않고 ErrorManager를 취득해 사용하는 것에 주의해 주세요. 이 때문에 호출원이 특권 첨부가 아닌 환경에서 사용됩니다.

파라미터:

msg - 기술 캐릭터 라인 (null인 경우가 있다)

ex - 예외 (null인 경우가 있다)

code - ErrorManager 로 정의된 에러 코드

setLevel

public void setLevel(Level  newLevel)
              throws SecurityException 

이 Handler가 로그를 취하는 메세지 레벨을 지정하는 로그 레벨을 설정합니다. 이 값보다 작은 메세지 레벨은 파기됩니다.

이것은 개발자가 다량의 로깅을 온으로 설정할 수가 있도록 하는 한편으로 특정의 Handler에 송신되는 메세지를 제한할 수 있도록하기 위한 것입니다.

파라미터:

newLevel - 로그 레벨의 새로운 값

예외:

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

getLevel

public Level  getLevel()

이 Handler가 로그를 취하는 메세지를 지정하는 로그 레벨을 취득합니다. 이 값보다 작은 메세지 레벨은 파기됩니다.

반환값:

로그를 취하는 메세지 레벨

isLoggable

public boolean isLoggable(LogRecord  record)

이 Handler가 지정된 LogRecord 로그를 실제로 취할지 어떨지를 조사합니다.

이 메서드는 LogRecord가 적절한 Level를 가지고 있을지 어떨지 및 임의의 Filter 조건을 채울지 어떨지를 조사합니다. 또, 이 메서드는 핸들러가 LogRecord 로그를 취하는 것을 방지한다, 다른 Handler 고유의 체크도 실시할 수 있습니다 . LogRecord가 Null인 경우는 false를 리턴합니다.

파라미터:

record - LogRecord

반환값:

LogRecord가 로그를 빼앗기는 경우는 true