- java.lang.Object
-
- java.util.logging.Handler
-
- java.util.logging.StreamHandler
-
- java.util.logging.ConsoleHandler
-
public class ConsoleHandler extends StreamHandler
ThisHandlerpublishes log records toSystem.err. By default theSimpleFormatteris used to generate brief summaries.Configuration: By default each
ConsoleHandleris initialized using the followingLogManagerconfiguration 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
Filterclass to use (defaults to noFilter). - <handler-name>.formatter
specifies the name of a
Formatterclass 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
ConsoleHandlerwould 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 aConsoleHandlerforSystem.err.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclose()OverrideStreamHandler.closeto do a flush but not to close the output stream.voidpublish(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
Loggerobject, which initialized theLogRecordand forwarded it here.- Overrides:
publishin classStreamHandler- Parameters:
record- description of the log event. A null record is silently ignored and is not published
-
close
public void close()
OverrideStreamHandler.closeto do a flush but not to close the output stream. That is, we do not closeSystem.err.- Overrides:
closein classStreamHandler
-
-