java.util.logging
클래스 MemoryHandler

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

public class MemoryHandler
extends Handler 

메모리의 순환 버퍼의 요구를 버퍼 처리하는 Handler 입니다.

보통, 이 Handler는 착신하는 LogRecord를 그 메모리밧파에 포함하는 것만으로 이전의 레코드를 파기합니다. 이 버퍼링은 매우 싸게 들어 포맷 처리의 코스트가 들지 않게 합니다. 특정의 트리거의 조건아래에서 MemoryHandler는 현재의 버퍼의 내용을 타겟 Handler에 푸쉬 해, 일반적으로 이 핸들러가 그 내용을 외부에 통지합니다.

버퍼의 푸쉬를 트리거 모델에게는 주로 다음의 3 개가 있습니다.

• 착신하는 LogRecord가 사전 정의된 레벨 pushLevel 보다 큰 형태를 가진다
• 외부 클래스가 명시적으로 push 메서드를 호출한다
• 서브 클래스가 log 메서드를 오버라이드(override) 해, 각 착신 LogRecord를 주사 해, 레코드가 희망하는 기준에 일치하는 경우에 push를 호출한다

구성: 디폴트로 각 MemoryHandler는 다음에 나타내는 LogManager 구성 프로퍼티를 사용해 초기화됩니다. 프로퍼티가 미정도리의 경우 (또는 무효인 값을 가지는 경우), 지정된 디폴트의 값이 사용됩니다. 기본값이 미정도리의 경우, RuntimeException가 발생 됩니다.

• java.util.logging.MemoryHandler.level는 Handler 레벨을 지정한다 (디폴트는 Level.ALL)
• java.util.logging.MemoryHandler.filter는 사용하는 Filter 이름을 지정한다 (디폴트는 Filter 없음)
• java.util.logging.MemoryHandler.size는 버퍼 사이즈를 정의한다 (디폴트는 1000)
• java.util.logging.MemoryHandler.push는 pushLevel를 정의한다 (디폴트는 level.SEVERE)
• java.util.logging.MemoryHandler.target는 타겟의 Handler 클래스의 이름을 지정한다 (디폴트 없음)

도입된 버전 :

1.4

생성자 개요

MemoryHandler ()
MemoryHandler를 작성해 LogManager 구성 프로퍼티에 근거해 구성합니다.

MemoryHandler (Handler target, int size, Level pushLevel)
MemoryHandler를 작성합니다.

메서드 개요

void	close () Handler를 닫아 관련된 모든 자원을 해방합니다.
void	flush () 타겟 Handler를 플래시 합니다.
Level	getPushLevel () pushLevel를 리턴합니다.
boolean	isLoggable (LogRecord record) 이 Handler가 지정된 LogRecord를 내부 버퍼에 실제로 로깅 할지 어떨지를 조사합니다.
void	publish (LogRecord record) 내부 버퍼에 LogRecord를 포함합니다.
void	push () 임의의 버퍼 처리된 출력을 타겟 Handler에 푸쉬 합니다.
void	setPushLevel (Level newLevel) pushLevel를 설정합니다.

클래스 java.util.logging. Handler 로부터 상속된 메서드

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

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

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

생성자 상세

MemoryHandler

public MemoryHandler()

MemoryHandler를 작성해 LogManager 구성 프로퍼티에 근거해 구성합니다.

MemoryHandler

public MemoryHandler(Handler  target,
                     int size,
                     Level  pushLevel)

MemoryHandler를 작성합니다.

MemoryHandler는 지정된 pushLevel 인수와 버퍼 사이즈 인수가 사용되지 않는 한, LogManager 프로퍼티 또는 그 기본값에 근거해 구성됩니다.

파라미터:

target - 출력을 통지하는 Handler

size - 버퍼 처리하는 로그 레코드의 수 (제로보다 크지 않으면 안 된다)

pushLevel - 푸쉬를 실시하는 메세지 레벨

예외:

IllegalArgumentException - 사이즈가 0 이하이다

메서드의 상세

publish

public void publish(LogRecord  record)

내부 버퍼에 LogRecord를 포함합니다.

Filter가 있는 경우, 그 isLoggable 메서드가 불려가 지정된 로그 레코드가 로그를 취하는 것이 가능한지 어떤지를 조사합니다. 가능하지 않은 경우, 그대로 복귀합니다. 가능한 경우, 지정된 레코드가 내부 순환 버퍼에 복사됩니다. 다음에 레코드의 레벨 프로퍼티가 pushLevel 라고 비교됩니다. 지정된 레벨이 pushLevel 보다 큰가 또는 동일한 경우, push가 불려가 버퍼 처리된 모든 레코드를 타겟 출력 Handler에 출력합니다.

정의:

클래스 Handler 내의 publish

파라미터:

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

push

public void push()

임의의 버퍼 처리된 출력을 타겟 Handler에 푸쉬 합니다.

버퍼가 클리어 됩니다.

flush

public void flush()

타겟 Handler를 플래시 합니다.

MemoryHandler 버퍼의 현재의 내용은 써내지지 않은 것에 주의해 주세요. 써내려면 push가 필요하게 됩니다.

정의:

클래스 Handler 내의 flush

close

public void close()
           throws SecurityException 

Handler를 닫아 관련된 모든 자원을 해방합니다. 이것에 의해 타겟 Handler도 닫혀집니다.

정의:

클래스 Handler 내의 close

예외:

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

setPushLevel

public void setPushLevel(Level  newLevel)
                  throws SecurityException 

pushLevel를 설정합니다. LogRecord가 내부 버퍼에 카피되면, 그 레벨이 pushLevel 보다 큰가 동일한 경우, push가 호출됩니다.

파라미터:

newLevel - pushLevel 새로운 값

예외:

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

getPushLevel

public Level  getPushLevel()

pushLevel를 리턴합니다.

반환값:

pushLevel 값

isLoggable

public boolean isLoggable(LogRecord  record)

이 Handler가 지정된 LogRecord를 내부 버퍼에 실제로 로깅 할지 어떨지를 조사합니다.

이 메서드는 LogRecord가 적절한 레벨을 가지고 있을지 어떨지 및 모든 Filter를 채우고 있는지를 조사합니다. 다만, LogRecord에 의해 버퍼의 내용이 「푸쉬」될까는 조사하지 않습니다. LogRecord가 Null인 경우, false를 리턴합니다.

오버라이드(override):

클래스 Handler 내의 isLoggable

파라미터:

record - LogRecord

반환값:

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