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 () 디폴트의 constructor 입니다.

메소드의 개요

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()

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

메소드의 상세

publish

public abstract void publish(LogRecord  record)

LogRecord 를 발행합니다.

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

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

파라미터:

record - 로그 이벤트의 설명

flush

public abstract void flush()

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

close

public abstract void close()
                    throws SecurityException 

Handler 를 닫아 관련하는 모든 리소스를 해방합니다.

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

예외:

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 고유의 체크도 실시할 수가 있습니다.

파라미터:

record - LogRecord

반환값:

LogRecord 의 로그를 취하는 경우는 true