java.util.logging
클래스 SocketHandler

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

public class SocketHandler
extends StreamHandler 

간결한 네트워크 로그 Handler 입니다.

LogRecord 는 넷트워크스트림 접속에 통지됩니다. 디폴트로,XMLFormatter 클래스는 포맷 처리에 사용됩니다.

구성: 각 SocketHandler 는 디폴트로, 다음의 LogManager 구성 프로퍼티을 사용해 초기화됩니다. 프로퍼티이 지정되지 않은 경우 (또는 무효인 값을 가지는 경우), 지정된 디폴트 값가 사용됩니다.

• java.util.logging.SocketHandler.level 는,Handler 의 디폴트 레벨을 지정한다 (디폴트는 Level.ALL)
• java.util.logging.SocketHandler.filter 는, 사용하는 Filter 클래스의 이름을 지정한다 (디폴트는 Filter 없음)
• java.util.logging.SocketHandler.formatter 는, 사용하는 Formatter 클래스의 이름을 지정한다 (디폴트는 java.util.logging.XMLFormatter)
• java.util.logging.SocketHandler.encoding 는, 사용하는 캐릭터 세트 인코딩의 이름 (디폴트는, 디폴트 플랫폼의 인코딩)
• java.util.logging.SocketHandler.host 는, 접속하는 타겟 호스트명을 지정한다 (디폴트 없음)
• java.util.logging.SocketHandler.port 는, 사용하는 타겟 TCP 포트를 지정한다 (디폴트 없음)

출력의 입출력 스트림은 버퍼 됩니다만, 각 LogRecord 가 기입해지면(자) 플래시 됩니다.

도입된 버젼:

1.4

생성자 의 개요

SocketHandler ()
LogManager 프로퍼티 또는 그 디폴트만을 사용해,SocketHandler 를 작성합니다.

SocketHandler (String host, int port)
지정된 호스트와 포트를 사용해 SocketHandler 를 구축합니다.

메소드의 개요

void	close () 이 출력 스트림을 닫습니다.
void	publish (LogRecord record) LogRecord 를 포맷 해 발행합니다.

클래스 java.util.logging. StreamHandler 로부터 상속된 메소드

flush , isLoggable , setEncoding , setOutputStream

클래스 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

생성자 의 상세

SocketHandler

public SocketHandler()
              throws IOException 

LogManager 프로퍼티 또는 그 디폴트만을 사용해,SocketHandler 를 작성합니다.

예외:

IllegalArgumentException - 호스트 또는 포트가 무효인지, LogManager 프로퍼티으로서 지정되어 있지 않은 경우

IOException - 타겟의 호스트와 포트에 접속할 수 없는 경우

SocketHandler

public SocketHandler(String  host,
                     int port)
              throws IOException 

지정된 호스트와 포트를 사용해 SocketHandler 를 구축합니다. SocketHandler 는, 지정된 host 인수와 port 인수가 사용되지 않는 한,LogManager 프로퍼티 또는 그 디폴트 값에 근거해 구성됩니다. host 인수가 빈 상태(empty)이지만 null String 가 아닌 경우, localhost 가 사용됩니다.

파라미터:

host - 타겟 호스트

port - 타겟 포트

예외:

IllegalArgumentException - 호스트 또는 포트가 무효인 경우

IOException - 타겟의 호스트와 포트에 접속할 수 없는 경우

메소드의 상세

close

public void close()
           throws SecurityException 

이 출력 스트림을 닫습니다.

오버라이드(override):

클래스 StreamHandler 내의 close

예외:

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

publish

public void publish(LogRecord  record)

LogRecord 를 포맷 해 발행합니다.

오버라이드(override):

클래스 StreamHandler 내의 publish

파라미터:

record - 로그 이벤트의 설명. null 레코드는 아무 통지도 없게 무시되어 발행되지 않는다