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

この出力ストリームを閉じます。

オーバーライド:

クラス StreamHandler 内の close

例外:

SecurityException - セキュリティマネージャが存在し、呼び出し元が LoggingPermission("control")) を持たない場合

publish

public void publish(LogRecord record)

LogRecord をフォーマットして発行します。

オーバーライド:

クラス StreamHandler 内の publish

パラメータ:

record - ログイベントの説明。null レコードは単に無視されるだけで、通知は行われない