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 입니다.

LogRecords는 넷트워크스트림 접속에 통지됩니다. 디폴트로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 포트를 지정한다 (디폴트 없음)

출력 IO 스트림은 버퍼 처리됩니다만, 각 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는 지정된 타겟 호스트 및 포트 인수가 사용되는 것을 제외해, LogManager 프로퍼티 (또는 기본값)에 근거해 구성됩니다. 호스트 인수가 비어있지만 null 캐릭터 라인이 아닌 경우, 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 레코드는 단지 무시되는 것만으로 통지는 행해지지 않는다