JavaTM 2
Platform
Std. Ed. v1.4.0

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 構成プロパティを使用して初期化されます。プロパティが未定義の場合 (または無効な値を持つ場合)、指定されたデフォルトの値が使用されます。

出力の入出力ストリームはバッファされますが、各 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 のプロパティまたはそのデフォルト値に基づいて構成されます。

パラメータ:
host - ターゲットホスト
port - ターゲットポート
例外:
IllegalArgumentException - ホストまたはポートが無効な場合
IOException - ターゲットホストとポートに接続できない場合
メソッドの詳細

close

public void close()
           throws SecurityException
この出力ストリームを閉じます。

オーバーライド:
クラス StreamHandler 内の close
例外:
SecurityException - セキュリティマネージャが存在し、呼び出し元が LoggingPermission("control")) を持たない場合

publish

public void publish(LogRecord record)
LogRecord をフォーマットして発行します。

オーバーライド:
クラス StreamHandler 内の publish
パラメータ:
record - ログイベントの説明

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.