JavaTM Platform
Standard Ed. 6

java.util.logging
クラス SocketHandler

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 構成プロパティーを使って初期化されます。プロパティーが未定義である場合 (または無効な値を持つ場合)、指定されたデフォルト値が使用されます。

出力の入出力ストリームはバッファーされますが、各 LogRecord が書き込まれるとフラッシュされます。

導入されたバージョン:
1.4

コンストラクタの概要
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
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

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
この出力ストリームを閉じます。

オーバーライド:
クラス StreamHandler 内の close
例外:
SecurityException - セキュリティーマネージャーが存在し、呼び出し元が LoggingPermission("control")) を持たない場合

publish

public void publish(LogRecord record)
LogRecord をフォーマットして発行します。

オーバーライド:
クラス StreamHandler 内の publish
パラメータ:
record - ログイベントの説明。null レコードは何の通知もなく無視され、発行されない

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。