- 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
構成プロパティを使用して初期化されます。ここで<handler-name>
はハンドラの完全修飾クラス名を示します。 プロパティが未定義である場合(または無効な値を持つ場合)、指定されたデフォルト値が使用されます。- <handler-name>.levelは
Handler
のデフォルト・レベルを指定します(デフォルトはLevel.ALL
)。 - <handler-name>.filterは使用する
Filter
クラスの名前を指定します(デフォルトはFilter
なし)。 - <handler-name>.formatterは使用する
Formatter
クラスの名前を指定します(デフォルトはjava.util.logging.XMLFormatter
)。 - <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
出力の入出力ストリームはバッファされますが、各
LogRecord
が書き込まれるとフラッシュされます。- 導入されたバージョン:
- 1.4
- <handler-name>.levelは
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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
-
-
-
-
コンストラクタの詳細
-
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レコードは何の通知もなく無視され、発行されない
-
-