Added in API level 1

ConsoleHandler

open class ConsoleHandler : StreamHandler
kotlin.Any
   ↳ java.util.logging.Handler
   ↳ java.util.logging.StreamHandler
   ↳ java.util.logging.ConsoleHandler

This Handler publishes log records to System.err. By default the SimpleFormatter is used to generate brief summaries.

Configuration: By default each ConsoleHandler is initialized using the following LogManager 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 to Level.INFO).
  • <handler-name>.filter specifies the name of a Filter class to use (defaults to no Filter).
  • <handler-name>.formatter specifies the name of a Formatter class to use (defaults to java.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

Summary

Public constructors

Create a ConsoleHandler for System.err.

Public methods
open Unit

Override StreamHandler.close to do a flush but not to close the output stream.

open Unit
publish(record: LogRecord!)

Publish a LogRecord.

Inherited functions

Public constructors

ConsoleHandler

Added in API level 1
ConsoleHandler()

Create a ConsoleHandler for System.err.

The ConsoleHandler is configured based on LogManager properties (or their default values).

Public methods

close

Added in API level 1
open fun close(): Unit

Override StreamHandler.close to do a flush but not to close the output stream. That is, we do not close System.err.

publish

Added in API level 1
open fun publish(record: LogRecord!): Unit

Publish a LogRecord.

The logging request was made initially to a Logger object, which initialized the LogRecord and forwarded it here.

Parameters
record LogRecord!: description of the log event. A null record is silently ignored and is not published