ConsoleHandler (Java Platform SE 7 ) (original) (raw)

• java.lang.Object

• • java.util.logging.Handler
  • • java.util.logging.StreamHandler
      • • java.util.logging.ConsoleHandler

• ---

public class ConsoleHandler
extends StreamHandler
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 followingLogManager configuration properties. If properties are not defined (or have invalid values) then the specified default values are used.

• java.util.logging.ConsoleHandler.level specifies the default level for the Handler (defaults to Level.INFO).

• java.util.logging.ConsoleHandler.filter specifies the name of a Filter class to use (defaults to no Filter).

• java.util.logging.ConsoleHandler.formatter specifies the name of a Formatter class to use (defaults to java.util.logging.SimpleFormatter).

• java.util.logging.ConsoleHandler.encoding the name of the character set encoding to use (defaults to the default platform encoding).
  Since:
  1.4

• • Constructor Summary

  Constructors

  Constructor and Description
  ConsoleHandler() Create a ConsoleHandler for System.err.

  • Method Summary

  Methods

  Modifier and Type	Method and Description
  void	close() Override StreamHandler.close to do a flush but not to close the output stream.
  void	publish(LogRecord record) Publish a LogRecord.

     * ### Methods inherited from class java.util.logging.[StreamHandler](../../../java/util/logging/StreamHandler.html "class in java.util.logging")  
     `[flush](../../../java/util/logging/StreamHandler.html#flush%28%29), [isLoggable](../../../java/util/logging/StreamHandler.html#isLoggable%28java.util.logging.LogRecord%29), [setEncoding](../../../java/util/logging/StreamHandler.html#setEncoding%28java.lang.String%29), [setOutputStream](../../../java/util/logging/StreamHandler.html#setOutputStream%28java.io.OutputStream%29)`  
     * ### Methods inherited from class java.util.logging.[Handler](../../../java/util/logging/Handler.html "class in java.util.logging")  
     `[getEncoding](../../../java/util/logging/Handler.html#getEncoding%28%29), [getErrorManager](../../../java/util/logging/Handler.html#getErrorManager%28%29), [getFilter](../../../java/util/logging/Handler.html#getFilter%28%29), [getFormatter](../../../java/util/logging/Handler.html#getFormatter%28%29), [getLevel](../../../java/util/logging/Handler.html#getLevel%28%29), [reportError](../../../java/util/logging/Handler.html#reportError%28java.lang.String,%20java.lang.Exception,%20int%29), [setErrorManager](../../../java/util/logging/Handler.html#setErrorManager%28java.util.logging.ErrorManager%29), [setFilter](../../../java/util/logging/Handler.html#setFilter%28java.util.logging.Filter%29), [setFormatter](../../../java/util/logging/Handler.html#setFormatter%28java.util.logging.Formatter%29), [setLevel](../../../java/util/logging/Handler.html#setLevel%28java.util.logging.Level%29)`  
     * ### Methods inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../java/lang/Object.html#clone%28%29), [equals](../../../java/lang/Object.html#equals%28java.lang.Object%29), [finalize](../../../java/lang/Object.html#finalize%28%29), [getClass](../../../java/lang/Object.html#getClass%28%29), [hashCode](../../../java/lang/Object.html#hashCode%28%29), [notify](../../../java/lang/Object.html#notify%28%29), [notifyAll](../../../java/lang/Object.html#notifyAll%28%29), [toString](../../../java/lang/Object.html#toString%28%29), [wait](../../../java/lang/Object.html#wait%28%29), [wait](../../../java/lang/Object.html#wait%28long%29), [wait](../../../java/lang/Object.html#wait%28long,%20int%29)`

• • Constructor Detail

     * #### ConsoleHandler  
     public ConsoleHandler()  
     Create a  
     ConsoleHandler  
      for  
     System.err  
     .  
      The ConsoleHandler is configured based onLogManager properties (or their default values).  

  • Method Detail

    * #### publish  
    public void publish([LogRecord](../../../java/util/logging/LogRecord.html "class in java.util.logging") record)  
    Publish a  
    LogRecord  
    .  
     The logging request was made initially to a Logger object, which initialized the LogRecord and forwarded it here.  
    **Overrides:**  
    `[publish](../../../java/util/logging/StreamHandler.html#publish%28java.util.logging.LogRecord%29)` in class `[StreamHandler](../../../java/util/logging/StreamHandler.html "class in java.util.logging")`  
    Parameters:  
    `record` \- description of the log event. A null record is silently ignored and is not published  
    * #### close  
    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  
    .  
    **Overrides:**  
    `[close](../../../java/util/logging/StreamHandler.html#close%28%29)` in class `[StreamHandler](../../../java/util/logging/StreamHandler.html "class in java.util.logging")`

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.