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
-
コンストラクタのサマリー
コンストラクタ説明LogManager
プロパティまたはそのデフォルトだけを使用して、SocketHandler
を作成します。SocketHandler
(String host, int port) 指定されたホストとポートを使ってSocketHandler
を構築します。 -
メソッドのサマリー
クラス 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 IOExceptionLogManager
プロパティまたはそのデフォルトだけを使用して、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レコードは何の通知もなく無視され、発行されない
-