org.spf4j.test.log

Class TestLoggers

java.lang.Object

org.spf4j.test.log.TestLoggers

All Implemented Interfaces:

org.slf4j.ILoggerFactory

public final class TestLoggers
extends Object
implements org.slf4j.ILoggerFactory

Author:

Zoltan Farkas

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	EXECUTED_FROM_IDE

Method Summary

Modifier and Type	Method and Description
LogCollection<ArrayDeque<LogRecord>>	collect(Level minimumLogLevel, int maxNrLogs, boolean collectPrinted) Collect up to a number of log messages.
<T> LogCollection<T>	collect(String category, Level fromLevel, boolean passThrough, Collector<LogRecord,?,T> collector) Collect a bunch of logs.
<R> LogCollection<R>	collect(String category, Level fromLevel, Level toLevel, boolean passThrough, Collector<LogRecord,?,R> collector, ToIntFunction<List<LogHandler>> whereTo)
<T> LogCollection<T>	collect(String category, Level fromLevel, Level toLevel, boolean passThrough, Collector<LogRecord,?,T> collector) Collect a bunch of logs.
LogAssert	dontExpect(String category, Level minimumLogLevel, org.hamcrest.Matcher<LogRecord>... matchers) the opposite of expect.
LogAssert	expect(String category, Level minimumLogLevel, int nrTimes, long timeout, TimeUnit unit, org.hamcrest.Matcher<LogRecord>... matchers)
LogAssert	expect(String category, Level minimumLogLevel, int nrTimes, org.hamcrest.Matcher<LogRecord>... matchers) Ability to assert is you expect a sequence of logs to be repeated.
LogAssert	expect(String category, Level minimumLogLevel, long timeout, TimeUnit unit, org.hamcrest.Matcher<LogRecord>... matchers)
LogAssert	expect(String category, Level minimumLogLevel, org.hamcrest.Matcher<LogRecord>... matchers) Create an log expectation that can be asserted like: LogAssert expect = TestLoggers.expect("org.spf4j.test", Level.ERROR, Matchers.hasProperty("format", Matchers.equalTo("Booo"))); LOG.error("Booo", new RuntimeException()); expect.assertObservation();
LogAssert	expectUncaughtException(long timeout, TimeUnit unit, org.hamcrest.Matcher<UncaughtExceptionDetail> matcher) Assert uncaught exceptions.(from threads)
LogConfig	getConfig()
Logger	getJulGlobal()
Logger	getJulRoot()
org.slf4j.Logger	getLogger(String name) Return an appropriate SimpleLogger instance by name.
HandlerRegistration	ignore(String category, Level from, Level to) all logs from category and specified levels will be ignored...
HandlerRegistration	intercept(String category, LogHandler handler) Ability to intercept log messages logged under a category
HandlerRegistration	interceptAllLevels(String category, AllLevelsLogHandler handler) Convenience method for functional use.
void	interceptInContext(String category, LogHandler handler)
void	print(String category, Level level) Print logs above a category and log level.
void	print(String category, Level level, boolean greedy)
static TestLoggers	sys()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

EXECUTED_FROM_IDE

public static final boolean EXECUTED_FROM_IDE

Method Detail

sys

public static TestLoggers sys()

getConfig

public LogConfig getConfig()

print

public void print(String category,
                  Level level)

Print logs above a category and log level.

Parameters:

category - the log category.

level - the log level.

print

public void print(String category,
                  Level level,
                  boolean greedy)

intercept

@CheckReturnValue
public HandlerRegistration intercept(String category,
                                                       LogHandler handler)

Ability to intercept log messages logged under a category

Parameters:

category - the logger category name (a.b.c)

handler - the log handler to register.

Returns:

a registration handle, that you can use to unregister.

interceptInContext

@CheckReturnValue
public void interceptInContext(String category,
                                                 LogHandler handler)

collect

@CheckReturnValue
public <T> LogCollection<T> collect(String category,
                                                      Level fromLevel,
                                                      boolean passThrough,
                                                      Collector<LogRecord,?,T> collector)

Collect a bunch of logs.

Type Parameters:

T - the type of object to collect into.

Parameters:

category - the log category (a.b.c)

fromLevel - from level to collect.

passThrough - pass the logs to lower category handlers or not.

collector - the collector to collect the logs.

Returns:

collected logs.

collect

@CheckReturnValue
public <T> LogCollection<T> collect(String category,
                                                      Level fromLevel,
                                                      Level toLevel,
                                                      boolean passThrough,
                                                      Collector<LogRecord,?,T> collector)

Collect a bunch of logs.

Type Parameters:

T - the type of object to collect into.

Parameters:

category - the log category (a.b.c)

fromLevel - from level to collect.

toLevel - to level to collect.

passThrough - pass the logs to lower category handlers or not.

collector - the collector to collect the logs.

Returns:

collected logs.

collect

@CheckReturnValue
public <R> LogCollection<R> collect(String category,
                                                      Level fromLevel,
                                                      Level toLevel,
                                                      boolean passThrough,
                                                      Collector<LogRecord,?,R> collector,
                                                      ToIntFunction<List<LogHandler>> whereTo)

interceptAllLevels

@CheckReturnValue
public HandlerRegistration interceptAllLevels(String category,
                                                                AllLevelsLogHandler handler)

Convenience method for functional use.

Parameters:

category - the log category.

handler - a functional handler.

Returns:

a registration handle to allow you to undo the registration.

ignore

@CheckReturnValue
public HandlerRegistration ignore(String category,
                                                    Level from,
                                                    Level to)

all logs from category and specified levels will be ignored... (unless there are more specific handlers)

Parameters:

category - the log category.

from - from log level.

to - to log level.

Returns:

a registration handle to allow you to undo this filtering.

expect

@CheckReturnValue
public LogAssert expect(String category,
                                          Level minimumLogLevel,
                                          org.hamcrest.Matcher<LogRecord>... matchers)

Create an log expectation that can be asserted like: LogAssert expect = TestLoggers.expect("org.spf4j.test", Level.ERROR, Matchers.hasProperty("format", Matchers.equalTo("Booo"))); LOG.error("Booo", new RuntimeException()); expect.assertObservation();

Parameters:

category - the category under which we should expect these messages.

minimumLogLevel - minimum log level of expected log messages

matchers - a succession of LogMessages with each matching a Matcher is expected.

Returns:

an assertion handle.

expect

@CheckReturnValue
public LogAssert expect(String category,
                                          Level minimumLogLevel,
                                          long timeout,
                                          TimeUnit unit,
                                          org.hamcrest.Matcher<LogRecord>... matchers)

dontExpect

@CheckReturnValue
public LogAssert dontExpect(String category,
                                              Level minimumLogLevel,
                                              org.hamcrest.Matcher<LogRecord>... matchers)

the opposite of expect.

Parameters:

category - the category under which we should expect these messages.

minimumLogLevel - minimum log level of expected log messages

matchers - a succession of LogMessages with each matching a Matcher is NOT expected.

Returns:

an assertion handle.

expect

public LogAssert expect(String category,
                        Level minimumLogLevel,
                        int nrTimes,
                        org.hamcrest.Matcher<LogRecord>... matchers)

Ability to assert is you expect a sequence of logs to be repeated.

Parameters:

category - the log category (a.b.c)

minimumLogLevel - the minimum log level of expected messages.

nrTimes - number of time the sequence should appear.

matchers - the sequence of matchers.

Returns:

the assertion handle.

expect

public LogAssert expect(String category,
                        Level minimumLogLevel,
                        int nrTimes,
                        long timeout,
                        TimeUnit unit,
                        org.hamcrest.Matcher<LogRecord>... matchers)

expectUncaughtException

@Beta
public LogAssert expectUncaughtException(long timeout,
                                               TimeUnit unit,
                                               org.hamcrest.Matcher<UncaughtExceptionDetail> matcher)

Assert uncaught exceptions.(from threads)

Parameters:

timeout - timeout to wait for this assertion. from the point in time of assertion invocation.

unit -

matcher - the exception matcher.

Returns:

the assertion handle.

collect

public LogCollection<ArrayDeque<LogRecord>> collect(Level minimumLogLevel,
                                                    int maxNrLogs,
                                                    boolean collectPrinted)

Collect up to a number of log messages.

Parameters:

minimumLogLevel - the minimum log level of the messages.

maxNrLogs - the max number of messages to collect.

collectPrinted - collect messages that have been printed or not.

Returns:

the collection of messages.

getLogger

public org.slf4j.Logger getLogger(String name)

Return an appropriate SimpleLogger instance by name.

Specified by:

getLogger in interface org.slf4j.ILoggerFactory

getJulGlobal

public Logger getJulGlobal()

getJulRoot

public Logger getJulRoot()

toString

public String toString()

Overrides:

toString in class Object