java.util.logging
클래스 StreamHandler

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

알려진 직계 서브 클래스:

ConsoleHandler, FileHandler, SocketHandler

public class StreamHandler
extends Handler 

스트림에 근거하는 로그 Handler 입니다.

이것은 주로 다른 로그 Handlers 구현에 사용되는 base class 또는 지원 클래스로서 사용됩니다.

LogRecord는 지정된 java.io.OutputStream에 통지됩니다.

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

• java.util.logging.StreamHandler.level는 Handler 디폴트 레벨을 지정한다 (디폴트는 Level.INFO)
• java.util.logging.StreamHandler.filter는 사용하는 Filter 클래스의 이름을 지정한다 (디폴트는 Filter 없음)
• java.util.logging.StreamHandler.formatter는 사용하는 Formatter 클래스의 이름을 지정한다 (디폴트는 java.util.logging.StreamFormatter)
• java.util.logging.StreamHandler.encoding는 사용하는 캐릭터셋 인코딩의 이름 (디폴트는 디폴트 플랫폼의 인코딩)

도입된 버전 :

1.4

생성자 개요

StreamHandler ()
현재의 출력 스트림을 가지지 않는 StreamHandler를 작성합니다.

StreamHandler (OutputStream out, Formatter formatter)
지정된 Formatter와 출력 스트림을 가지는 StreamHandler를 작성합니다.

메서드 개요

void	close () 현재의 출력 스트림을 닫습니다.
void	flush () 모든 버퍼 된 메세지를 플래시 합니다.
boolean	isLoggable (LogRecord record) 이 Handler가 지정된 LogRecord 로그를 실제로 취할지 어떨지를 조사합니다.
void	publish (LogRecord record) LogRecord를 포맷의해 발행합니다.
void	setEncoding (String encoding) 이 Handler가 사용하는 캐릭터셋를 설정 또는 변경합니다.
protected void	setOutputStream (OutputStream out) 출력 스트림을 변경합니다.

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

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

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

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

생성자 상세

StreamHandler

public StreamHandler()

현재의 출력 스트림을 가지지 않는 StreamHandler를 작성합니다.

StreamHandler

public StreamHandler(OutputStream  out,
                     Formatter  formatter)

지정된 Formatter와 출력 스트림을 가지는 StreamHandler를 작성합니다.

파라미터:

out - 타겟 출력 스트림

formatter - 출력의 포맷에 사용되는 Formatter

메서드의 상세

setOutputStream

protected void setOutputStream(OutputStream  out)
                        throws SecurityException 

출력 스트림을 변경합니다.

현재의 출력 스트림이 있는 경우, Formatter 말미의 캐릭터 라인이 출력해져 스트림은 플래시 되어 닫혀집니다. 다음에 이 출력 스트림은 새로운 출력 스트림로 옮겨집니다.

파라미터:

out - 새로운 출력 스트림. null은 불가

예외:

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

setEncoding

public void setEncoding(String  encoding)
                 throws SecurityException,

                        UnsupportedEncodingException 

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

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

오버라이드(override):

클래스 Handler 내의 setEncoding

파라미터:

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

예외:

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

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

publish

public void publish(LogRecord  record)

LogRecord를 포맷의해 발행합니다.

StreamHandler는 우선 OutputStream가 있을지 어떨지, 지정된 LogRecord가 적어도 필요한 로그 레벨을 가지고 있을지 어떨지를 조사합니다. 이것들이 없는 경우, 아무것도 하지 않고 돌아옵니다. 이것들이 있는 경우, 관련된 임의의 Filter를 호출해 레코드를 통지할 수 있을지 어떨지를 조사합니다. 통지할 수 있는 경우, Formatter를 호출해 레코드를 포맷 해, 결과를 현재의 출력 스트림에 출력합니다.

이것이 지정된 OutputStream에 출력해지는 최초의 LogRecord인 경우, LogRecord가 출력해지기 전에 Formatter 「선두」의 캐릭터 라인이 스트림에 출력해집니다.

정의:

클래스 Handler 내의 publish

파라미터:

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

isLoggable

public boolean isLoggable(LogRecord  record)

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

이 메서드는 LogRecord가 적절한 레벨을 가져, 모든 Filter를 채울지 어떨지를 조사합니다. 또, 출력 스트림이 아직 할당할 수 있지 않은지, LogRecord가 Null인 경우는 false를 리턴합니다.

오버라이드(override):

클래스 Handler 내의 isLoggable

파라미터:

record - LogRecord

반환값:

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

flush

public void flush()

모든 버퍼 된 메세지를 플래시 합니다.

정의:

클래스 Handler 내의 flush

close

public void close()
           throws SecurityException 

현재의 출력 스트림을 닫습니다.

출력 스트림이 닫혀지기 전에 Formatter 「말미」의 캐릭터 라인이 스트림에 출력해집니다. 게다가Formatter 「선두」의 캐릭터 라인이 아직 스트림에 출력해지지 않은 경우는 「말미」의 캐릭터 라인의 전에 출력해집니다.

정의:

클래스 Handler 내의 close

예외:

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

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