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 引数が空であるが null String でない場合、localhost が使用されます。

パラメータ:

host - ターゲットホスト。

port - ターゲットポート。

例外:

IllegalArgumentException - ホストまたはポートが無効な場合。

IOException - ターゲットのホストとポートに接続できない場合。

メソッドの詳細

close

public void close()
           throws SecurityException

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

オーバーライド:

close、クラス: StreamHandler

例外:

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

publish

public void publish(LogRecord record)

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

オーバーライド:

publish、クラス: StreamHandler

パラメータ:

record - ログイベントの説明。null レコードは何の通知もなく無視され、発行されない