com.aoindustries.util.logging

Class QueuedHandler

java.lang.Object

java.util.logging.Handler

com.aoindustries.util.logging.QueuedHandler

public abstract class QueuedHandler
extends Handler

An implementation of Handler that queues log records and handles them in the background. Two actions are taken for each record, each in a separate background process. The first writes the System.err with a high priority. The second is an implementation-defined logging method. The log records are processed in the order received, regardless of level.

Defaults to using ErrorPrinterFormatter.

Author:

AO Industries, Inc.

See Also:

ErrorPrinterFormatter

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	QueuedHandler(String consoleExecutorThreadName, String customExecutorThreadName)

Method Summary

Modifier and Type	Method and Description
void	close()
protected abstract void	doCustomLogging(Formatter formatter, LogRecord record, String fullReport) This is called in a background Thread.
void	flush()
void	publish(LogRecord record)
protected abstract boolean	useCustomLogging(LogRecord record) The log record will only be queued when this returns true.

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QueuedHandler

protected QueuedHandler(String consoleExecutorThreadName,
                        String customExecutorThreadName)

Method Detail

publish

public final void publish(LogRecord record)

Specified by:

publish in class Handler

flush

public void flush()

Specified by:

flush in class Handler

close

public void close()
           throws SecurityException

Specified by:

close in class Handler

Throws:

SecurityException

useCustomLogging

protected abstract boolean useCustomLogging(LogRecord record)

The log record will only be queued when this returns true.

doCustomLogging

protected abstract void doCustomLogging(Formatter formatter,
                                        LogRecord record,
                                        String fullReport)

This is called in a background Thread.

Parameters:

formatter - the formatter at the time the record was queued

record - the queued record

fullReport - the complete message generated by the formatter before the record was queued. The message is generated before so it can have accurate thread and time information.