クラスConsoleHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

java.util.logging.ConsoleHandler

public class ConsoleHandler extends StreamHandler

このHandlerは、ログ・レコードをSystem.errに公開します。 デフォルトでは、SimpleFormatterを使用して簡単なサマリーが生成されます。

構成: デフォルトでは、各ConsoleHandlerは、次のLogManager構成プロパティを使用して初期化されます。<handler-name>は、ハンドラの完全修飾クラス名を示します。 プロパティが未定義である場合(または無効な値を持つ場合)、指定されたデフォルト値が使用されます。

• <handler-name>.levelは、Handler (デフォルトはLevel.INFOです)のデフォルト・レベルを指定します。
• <handler-name>.filterは、(デフォルトはFilterではありません)を使用するFilterクラスの名前を指定します。
• <handler-name>.formatterは、(デフォルトはjava.util.logging.SimpleFormatterです)を使用するFormatterクラスの名前を指定します。
• <handler-name>.encodingは使用する文字セット・エンコーディングの名前を指定します(デフォルトは、デフォルト・プラットフォームのエンコーディング)。

たとえば、ConsoleHandlerのプロパティは次のようになります。

• java.util.logging.ConsoleHandler.level=INFO
• java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter

カスタム・ハンドラ(例: com.foo.MyHandler)の場合、プロパティは次のようになります。

• com.foo.MyHandler.level=INFO
• com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter

導入されたバージョン:

1.4

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

コンストラクタ

コンストラクタ	説明
ConsoleHandler()	System.errのConsoleHandlerを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	close()	StreamHandler.closeをオーバーライドしてフラッシュしますが、出力ストリームはクローズしません。
void	publish(LogRecord record)	LogRecordを公開します。

クラスで宣言されたメソッド StreamHandler

flush, isLoggable, setEncoding, setOutputStream

修飾子と型	メソッド	説明
void	flush()	すべてのバッファされたメッセージをフラッシュします。
boolean	isLoggable(LogRecord record)	このHandlerが特定のLogRecordを実際にログに記録するかどうかを確認します。
void	setEncoding(String encoding)	(または変更)に、このHandlerで使用される文字エンコーディングを設定します。
protected void	setOutputStream(OutputStream out)	出力ストリームを変更します。

クラス Handlerで宣言されたメソッド

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

修飾子と型	メソッド	説明
String	getEncoding()	このHandlerの文字エンコーディングを返します。
ErrorManager	getErrorManager()	このHandlerのErrorManagerを取得します。
Filter	getFilter()	このHandlerの現在のFilterを取得します。
Formatter	getFormatter()	このHandlerのFormatterを返します。
Level	getLevel()	このHandlerによってログに記録されるメッセージを指定するログ・レベルを取得します。
protected void	reportError(String msg, Exception ex, int code)	このHandlerのErrorManagerにエラーを通知する簡易protected簡易メソッドです。
void	setErrorManager(ErrorManager em)	このHandlerのErrorManagerを定義します。
void	setFilter(Filter newFilter)	Filterを設定して、このHandlerの出力を制御します。
void	setFormatter(Formatter newFormatter)	Formatterを設定します。
void	setLevel(Level newLevel)	このHandlerによってログに記録されるメッセージ・レベルを指定するログ・レベルを設定します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

ConsoleHandler

public ConsoleHandler()

System.errのConsoleHandlerを作成します。

ConsoleHandlerは、LogManagerプロパティ(またはデフォルト値)に基づいて構成されます。

メソッドの詳細

publish

public void publish(LogRecord record)

LogRecordを公開します。

ロギング・リクエストは最初にLoggerオブジェクトに行われ、LogRecordを初期化し、ここに転送しました。

オーバーライド:

publish、クラスStreamHandler

実装要件:

このメソッドは同期されず、サブクラスがsuper.publish()をコールするか、ユーザー引数をフォーマットする場合、オーバーライドされたpublish()メソッドをsynchronizedとして定義しないでください。 詳細は、java.util.logging.Handlerのディスカッションを参照してください。

パラメータ:

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

close

public void close()

StreamHandler.closeをオーバーライドしてフラッシュしますが、出力ストリームはクローズしません。 つまり、System.errは閉じません。

オーバーライド:

close、クラスStreamHandler