- java.lang.Object
- java.util.logging.Handler
- java.util.logging.StreamHandler
- java.util.logging.ConsoleHandler
public class ConsoleHandler extends StreamHandler
ThisHandler
publishes log records toSystem.err
. By default theSimpleFormatter
is used to generate brief summaries.Configuration: By default each
ConsoleHandler
is initialized using the followingLogManager
configuration properties where<handler-name>
refers to the fully-qualified class name of the handler. If properties are not defined (or have invalid values) then the specified default values are used.- <handler-name>.level specifies the default level for the
Handler
(defaults toLevel.INFO
). - <handler-name>.filter specifies the name of a
Filter
class to use (defaults to noFilter
). - <handler-name>.formatter specifies the name of a
Formatter
class to use (defaults tojava.util.logging.SimpleFormatter
). - <handler-name>.encoding the name of the character set encoding to use (defaults to the default platform encoding).
For example, the properties for
ConsoleHandler
would be:- java.util.logging.ConsoleHandler.level=INFO
- java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
For a custom handler, e.g. com.foo.MyHandler, the properties would be:
- com.foo.MyHandler.level=INFO
- com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter
- Since:
- 1.4
- <handler-name>.level specifies the default level for the
Constructor Summary
Constructors Constructor Description ConsoleHandler()
Create aConsoleHandler
forSystem.err
.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
OverrideStreamHandler.close
to do a flush but not to close the output stream.void
publish(LogRecord record)
Publish aLogRecord
.Methods declared in class java.util.logging.StreamHandler
flush, isLoggable, setEncoding, setOutputStream
Methods declared in class java.util.logging.Handler
getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel
Method Detail
publish
public void publish(LogRecord record)
Publish aLogRecord
.The logging request was made initially to a
Logger
object, which initialized theLogRecord
and forwarded it here.- Overrides:
publish
in classStreamHandler
- Parameters:
record
- description of the log event. A null record is silently ignored and is not published
close
public void close()
OverrideStreamHandler.close
to do a flush but not to close the output stream. That is, we do not closeSystem.err
.- Overrides:
close
in classStreamHandler