public class SocketHandler extends StreamHandler
LogRecordはネットワーク・ストリーム接続に通知されます。 デフォルトで、XMLFormatterクラスはフォーマット処理に使用されます。
構成: デフォルトで各SocketHandlerは次のLogManager構成プロパティを使用して初期化されます。ここで<handler-name>はハンドラの完全修飾クラス名を示します。 プロパティが未定義である場合(または無効な値を持つ場合)、指定されたデフォルト値が使用されます。
たとえば、SocketHandler
のプロパティは次のようになります。
カスタム・ハンドラ(例: com.foo.MyHandler)の場合、プロパティは次のようになります。
出力の入出力ストリームはバッファされますが、各LogRecordが書き込まれるとフラッシュされます。
コンストラクタ | 説明 |
---|---|
SocketHandler() |
LogManagerプロパティまたはそのデフォルトだけを使用して、SocketHandlerを作成します。
|
SocketHandler(String host, int port) |
指定されたホストとポートを使ってSocketHandlerを構築します。
|
修飾子と型 | メソッド | 説明 |
---|---|---|
void |
close() |
この出力ストリームを閉じます。
|
void |
publish(LogRecord record) |
LogRecordをフォーマットして発行します。
|
flush, isLoggable, setEncoding, setOutputStream
getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel
public SocketHandler() throws IOException
IllegalArgumentException
- ホストまたはポートが無効であるか、LogManagerプロパティとして指定されていない場合。IOException
- ターゲットのホストとポートに接続できない場合。public SocketHandler(String host, int port) throws IOException
host
- ターゲット・ホスト。port
- ターゲット・ポート。IllegalArgumentException
- ホストまたはポートが無効な場合。IOException
- ターゲットのホストとポートに接続できない場合。public void close() throws SecurityException
close
、クラスStreamHandler
SecurityException
- セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。public void publish(LogRecord record)
publish
、クラスStreamHandler
record
- ログ・イベントの説明。 nullレコードは何の通知もなく無視され、発行されない バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。