FileDocCategorySizeDatePackage
ConsoleHandler.javaAPI DocJava SE 5 API3174Fri Aug 26 14:57:26 BST 2005java.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 following LogManager 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).

version
1.12, 12/19/03
since
1.4

Fields Summary
Constructors Summary
public ConsoleHandler()
Create a ConsoleHandler for System.err.

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

	sealed = false;
	configure();
	setOutputStream(System.err);
	sealed = true;
Methods Summary
public voidclose()
Override StreamHandler.close to do a flush but not to close the output stream. That is, we do not close System.err.

	flush();
private voidconfigure()

        LogManager manager = LogManager.getLogManager();
	String cname = getClass().getName();

	setLevel(manager.getLevelProperty(cname +".level", Level.INFO));
	setFilter(manager.getFilterProperty(cname +".filter", null));
	setFormatter(manager.getFormatterProperty(cname +".formatter", new SimpleFormatter()));
	try {
	    setEncoding(manager.getStringProperty(cname +".encoding", null));
	} catch (Exception ex) {
	    try {
	        setEncoding(null);
	    } catch (Exception ex2) {
		// doing a setEncoding with null should always work.
		// assert false;
	    }
	}
public voidpublish(java.util.logging.LogRecord record)
Publish a LogRecord.

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

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

	super.publish(record);	
	flush();