Package de.galan.commons.logging

Class Say

java.lang.Object

de.galan.commons.logging.Say

public class Say
extends Object

Facade for the logging-framework (currently Log4j2). Uses the PayloadContextMessage for parameterization of messages. Supports Parameterized messages, using {} as placeholder, eg.:
info("Hello {}", "world"); // => "Hello {world}"
info("Hello {} {}", "beautiful", "world"); // => "Hello {beautiful} {world}"
error("Something failed: {}", ex, "do'h"); // => "Hello {beautiful} {world}"


If the parameters should be available as json-encoded metadata for eg. logstash, you can provide names to the parameters. Example:
info("Hello {location}", "world"); // ThreadContext will provide the json in a field called "payload"

Additionally you can provide fields using a fluent interface using field(..) or f(..):
Say.field("key", "value").field("other", someObject).info("Hello {location}", "world");

You can omit the curly braces in the message by setting the environment-variable SAY_FIELDS_ENCLOSED to "false".

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Say.ContextBuilder	Using fluent interface to construct ThreadContext informations (formerly known as MDC /NDC)

Constructor Summary

Constructors

Constructor	Description
Say()

Method Summary

Modifier and Type	Method	Description
static void	debug(Object message)
static void	debug(Object message, Object... args)
static void	debug(Object message, Throwable throwable)
static void	debug(Object message, Throwable throwable, Object... args)
static void	error(Object message)
static void	error(Object message, Object... args)
static void	error(Object message, Throwable throwable)
static void	error(Object message, Throwable throwable, Object... args)
static Say.ContextBuilder	f(String key, Object value)
static void	fatal(Object message)
static void	fatal(Object message, Object... args)
static void	fatal(Object message, Throwable throwable)
static void	fatal(Object message, Throwable throwable, Object... args)
static Say.ContextBuilder	field(String key, Object value)
static void	info(Object message)
static void	info(Object message, Object... args)
static void	info(Object message, Throwable throwable)
static void	info(Object message, Throwable throwable, Object... args)
protected static void	log(org.apache.logging.log4j.Level level, Class<?> callerClass, Object message, Throwable throwable, Object... args)
protected static org.apache.logging.log4j.message.Message	payload(Object message, Object[] arguments, Throwable throwable)
static void	please()
static void	trace(Object message)
static void	trace(Object message, Object... args)
static void	trace(Object message, Throwable throwable)
static void	trace(Object message, Throwable throwable, Object... args)
static void	warn(Object message)
static void	warn(Object message, Object... args)
static void	warn(Object message, Throwable throwable)
static void	warn(Object message, Throwable throwable, Object... args)

Methods inherited from class java.lang.Object

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

Constructor Details

Say

public Say()

Method Details

payload

protected static org.apache.logging.log4j.message.Message payload(Object message,
 Object[] arguments,
 Throwable throwable)

log

protected static void log(org.apache.logging.log4j.Level level,
 Class<?> callerClass,
 Object message,
 Throwable throwable,
 Object... args)

f

public static Say.ContextBuilder f(String key,
 Object value)

field

public static Say.ContextBuilder field(String key,
 Object value)

trace

public static void trace(Object message)

trace

public static void trace(Object message,
 Object... args)

trace

public static void trace(Object message,
 Throwable throwable)

trace

public static void trace(Object message,
 Throwable throwable,
 Object... args)

debug

public static void debug(Object message)

debug

public static void debug(Object message,
 Object... args)

debug

public static void debug(Object message,
 Throwable throwable)

debug

public static void debug(Object message,
 Throwable throwable,
 Object... args)

info

public static void info(Object message)

info

public static void info(Object message,
 Object... args)

info

public static void info(Object message,
 Throwable throwable)

info

public static void info(Object message,
 Throwable throwable,
 Object... args)

warn

public static void warn(Object message)

warn

public static void warn(Object message,
 Object... args)

warn

public static void warn(Object message,
 Throwable throwable)

warn

public static void warn(Object message,
 Throwable throwable,
 Object... args)

error

public static void error(Object message)

error

public static void error(Object message,
 Object... args)

error

public static void error(Object message,
 Throwable throwable)

error

public static void error(Object message,
 Throwable throwable,
 Object... args)

fatal

public static void fatal(Object message)

fatal

public static void fatal(Object message,
 Object... args)

fatal

public static void fatal(Object message,
 Throwable throwable)

fatal

public static void fatal(Object message,
 Throwable throwable,
 Object... args)

please

public static void please()