モジュール java.logging

パッケージ 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構成プロパティを使用して初期化されます。<handler-name>は、ハンドラの完全修飾クラス名を示します。 プロパティが未定義である場合(または無効な値を持つ場合)、指定されたデフォルト値が使用されます。

• <handler-name>.levelは、Handler (デフォルトはLevel.ALLです)のデフォルト・レベルを指定します。
• <handler-name>.filterは、(デフォルトはFilterではありません)を使用するFilterクラスの名前を指定します。
• <handler-name>.formatterは、(デフォルトはjava.util.logging.XMLFormatterです)を使用するFormatterクラスの名前を指定します。
• <handler-name>.encodingは使用する文字セット・エンコーディングの名前を指定します(デフォルトは、デフォルト・プラットフォームのエンコーディング)。
• <handler-name>.hostは、接続先のターゲット・ホスト名を指定します(デフォルトなし)。
• <handler-name>.portは、使用するターゲットTCPポートを指定します(デフォルトなし)。

たとえば、SocketHandlerのプロパティは次のようになります。

• java.util.logging.SocketHandler.level=INFO
• java.util.logging.SocketHandler.formatter=java.util.logging.SimpleFormatter

カスタム・ハンドラ(例: com.foo.MyHandler)の場合、プロパティは次のようになります。

• com.foo.MyHandler.level=INFO
• com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter

出力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プロパティ(またはデフォルト値)に基づいて構成されます。 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レコードは何の通知もなく無視され、発行されない