# ConsoleHandler

public class **ConsoleHandler** extends [StreamHandler](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html)  
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

<br />

### Public Constructor Summary

|---|---|
|   | [ConsoleHandler](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/ConsoleHandler.html#ConsoleHandler())() Create a ConsoleHandler for System.err. |

### Public Method Summary

|---|---|
| void | [close](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/ConsoleHandler.html#close())() Override StreamHandler.close to do a flush but not to close the output stream. |
| void | [publish](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/ConsoleHandler.html#publish(java.util.logging.LogRecord))([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record) Publish a LogRecord. |

### Inherited Method Summary

From class [java.util.logging.StreamHandler](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html)

|---|---|
| synchronized void | [close](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#close())() Close the current output stream. |
| synchronized void | [flush](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#flush())() Flush any buffered messages. |
| boolean | [isLoggable](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#isLoggable(java.util.logging.LogRecord))([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record) Check if this Handler would actually log a given LogRecord. |
| synchronized void | [publish](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#publish(java.util.logging.LogRecord))([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record) Format and publish a LogRecord. |
| synchronized void | [setEncoding](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#setEncoding(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) encoding) Set (or change) the character encoding used by this Handler. |
| synchronized void | [setOutputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/StreamHandler.html#setOutputStream(java.io.OutputStream))([OutputStream](https://developers.google.com/j2objc/javadoc/jre/reference/java/io/OutputStream.html) out) Change the output stream. |

From class [java.util.logging.Handler](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html)

|---|---|
| abstract void | [close](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#close())() Close the Handler and free all associated resources. |
| abstract void | [flush](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#flush())() Flush any buffered output. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [getEncoding](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#getEncoding())() Return the character encoding for this Handler. |
| [ErrorManager](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/ErrorManager.html) | [getErrorManager](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#getErrorManager())() Retrieves the ErrorManager for this Handler. |
| [Filter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Filter.html) | [getFilter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#getFilter())() Get the current Filter for this Handler. |
| [Formatter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Formatter.html) | [getFormatter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#getFormatter())() Return the Formatter for this Handler. |
| [Level](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Level.html) | [getLevel](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#getLevel())() Get the log level specifying which messages will be logged by this Handler. |
| boolean | [isLoggable](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#isLoggable(java.util.logging.LogRecord))([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record) Check if this Handler would actually log a given LogRecord. |
| abstract void | [publish](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#publish(java.util.logging.LogRecord))([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record) Publish a LogRecord. |
| void | [reportError](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#reportError(java.lang.String,%20java.lang.Exception,%20int))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) msg, [Exception](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Exception.html) ex, int code) Protected convenience method to report an error to this Handler's ErrorManager. |
| synchronized void | [setEncoding](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#setEncoding(java.lang.String))([String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) encoding) Set the character encoding used by this Handler. |
| synchronized void | [setErrorManager](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#setErrorManager(java.util.logging.ErrorManager))([ErrorManager](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/ErrorManager.html) em) Define an ErrorManager for this Handler. |
| synchronized void | [setFilter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#setFilter(java.util.logging.Filter))([Filter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Filter.html) newFilter) Set a Filter to control output on this Handler. |
| synchronized void | [setFormatter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#setFormatter(java.util.logging.Formatter))([Formatter](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Formatter.html) newFormatter) Set a Formatter. |
| synchronized void | [setLevel](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Handler.html#setLevel(java.util.logging.Level))([Level](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/Level.html) newLevel) Set the log level specifying which message levels will be logged by this Handler. |

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Public Constructors

#### public
**ConsoleHandler**
()

Create a ConsoleHandler for System.err.


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

## Public Methods

#### public void
**close**
()

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

#### public void
**publish**
([LogRecord](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/logging/LogRecord.html) record)

Publish a LogRecord.


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

<br />

##### Parameters

| record | description of the log event. A null record is silently ignored and is not published |
|---|---|