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 를 작성합니다.

파라미터:

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 - 로그 이벤트의 설명

isLoggable

public boolean isLoggable(LogRecord  record)

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

이 메소드는 LogRecord 가 적절한 레벨을 가져, 모든 Filter 를 채울지 어떨지를 조사합니다. 또, 출력 스트림이 아직 할당할 수 있지 않은 경우는 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")를 가지지 않는 경우