compact1、compact2、compact3

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構成プロパティを使用して初期化されます。ここで<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

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
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

この出力ストリームを閉じます。

オーバーライド:

close、クラス: StreamHandler

例外:

SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。

publish

public void publish(LogRecord record)

LogRecordをフォーマットして発行します。

オーバーライド:

publish、クラス: StreamHandler

パラメータ:

record - ログ・イベントの説明。nullレコードは何の通知もなく無視され、発行されない