com.kdgregory.logging.common.util

Interface ThreadFactory

All Known Implementing Classes:

DefaultThreadFactory

public interface ThreadFactory

Creates and starts a new thread for running the LogWriter.

Appenders create a background thread (via factory) at the same time that they create the logwriter (also via factory), and pass the latter to the former. In normal operation they'll use DefaultThreadFactory. However, tests may instead use an factory that doesn't actually create a thread (so all operations happen inline) or use some other configuration.

To handle unexpected thread death, the appender must provide an uncaught exception handler. A typical handler logs what happens and then shuts down the appender(the assumption is that recoverable exceptions will be handled).

Method Summary

Modifier and Type	Method and Description
void	startWriterThread(LogWriter writer, Thread.UncaughtExceptionHandler exceptionHandler)

Method Detail

startWriterThread

void startWriterThread(LogWriter writer,
                       Thread.UncaughtExceptionHandler exceptionHandler)