クラス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

      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()
      この出力ストリームを閉じます。
      オーバーライド:
      close、クラスStreamHandler

    • publish

      public void publish(LogRecord record)
      LogRecordを書式設定して公開します。
      オーバーライド:
      publish、クラスStreamHandler
      パラメータ:
      record - ログ・イベントの説明。 nullレコードは何の通知もなく無視され、発行されない