reactor.test.util

Class LoggerUtils

java.lang.Object

reactor.test.util.LoggerUtils

public final class LoggerUtils
extends Object

This class eases testing interested in what reactor classes emit using loggers.

Author:

Eric Bottard

Method Summary

Modifier and Type	Method and Description
static void	disableCapture() Disable capturing, forgetting about the logger set via enableCaptureWith(Logger).
static void	enableCaptureWith(Logger testLogger) Set the logger used for capturing.
static Disposable	useCurrentLoggersWithCapture() Sets a logger factory that will return loggers that not only use the original logging framework used by reactor, but also use the logger set via enableCaptureWith(Logger), irrespective of its name or how it was obtained.

Methods inherited from class java.lang.Object

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

Method Detail

useCurrentLoggersWithCapture

public static Disposable useCurrentLoggersWithCapture()
                                               throws IllegalStateException

Sets a logger factory that will return loggers that not only use the original logging framework used by reactor, but also use the logger set via enableCaptureWith(Logger), irrespective of its name or how it was obtained. The expectation here is that tests that want to assess that something is logged by reactor will pass a TestLogger instance to enableCaptureWith(Logger), trigger the operation under scrutiny, assert the logger contents and reset state by calling disableCapture().

This method should be called very early in the application/tests lifecycle, before reactor classes have created their loggers.

Returns:

a disposable that re-installs the original factory when disposed

Throws:

IllegalStateException

enableCaptureWith

public static void enableCaptureWith(Logger testLogger)

Set the logger used for capturing.

Throws:

IllegalStateException - if a previous logger has been set but not cleared via disableCapture()

disableCapture

public static void disableCapture()

Disable capturing, forgetting about the logger set via enableCaptureWith(Logger).