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
-
コンストラクタのサマリー
コンストラクタ説明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
は、指定されたターゲット・ホストおよびポート引数が使用されることを除き、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レコードは何の通知もなく無視され、発行されない
-