log

public final void log()

Terminal log statement when a message is not required. A log method must terminate all fluent logging chains and the no-argument method can be used if there is no need for a log message. For example:


logger.at(INFO).withCause(error).log();

However as it is good practice to give all log statements a meaningful log message, use of this method should be rare.


public final void log(String msg)

Logs the given literal string without interpreting any argument placeholders.

Important: This is intended only for use with hard-coded, literal strings which cannot contain user data. If you wish to log user generated data, you should do something like:


log("user data=%s", value);
This serves to give the user data context in the log file but, more importantly, makes it clear which arguments may contain PII and other sensitive data (which might need to be scrubbed during logging). This recommendation also applies to all the overloaded log() methods below.
public final void log(String msg, @Nullable() Object p1)

Logs a formatted representation of the given parameter, using the specified message template. The message string is expected to contain argument placeholder terms appropriate to the logger's choice of parser.

Note that printf-style loggers are always expected to accept the standard Java printf formatting characters (e.g. "%s", "%d" etc...) and all flags unless otherwise stated. Null arguments are formatted as the literal string "null" regardless of formatting flags.

Parameters

msg

the message template string containing a single argument placeholder.


public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6, @Nullable() Object p7)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6, @Nullable() Object p7, @Nullable() Object p8)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6, @Nullable() Object p7, @Nullable() Object p8, @Nullable() Object p9)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6, @Nullable() Object p7, @Nullable() Object p8, @Nullable() Object p9, @Nullable() Object p10)
public final void log(String msg, @Nullable() Object p1, @Nullable() Object p2, @Nullable() Object p3, @Nullable() Object p4, @Nullable() Object p5, @Nullable() Object p6, @Nullable() Object p7, @Nullable() Object p8, @Nullable() Object p9, @Nullable() Object p10, Array<Object> rest)
public final void log(String msg, char p1)
public final void log(String msg, byte p1)
public final void log(String msg, short p1)
public final void log(String msg, int p1)
public final void log(String msg, long p1)
public final void log(String msg, @Nullable() Object p1, boolean p2)
public final void log(String msg, @Nullable() Object p1, char p2)
public final void log(String msg, @Nullable() Object p1, byte p2)
public final void log(String msg, @Nullable() Object p1, short p2)
public final void log(String msg, @Nullable() Object p1, int p2)
public final void log(String msg, @Nullable() Object p1, long p2)
public final void log(String msg, @Nullable() Object p1, float p2)
public final void log(String msg, @Nullable() Object p1, double p2)
public final void log(String msg, boolean p1, @Nullable() Object p2)
public final void log(String msg, char p1, @Nullable() Object p2)
public final void log(String msg, byte p1, @Nullable() Object p2)
public final void log(String msg, short p1, @Nullable() Object p2)
public final void log(String msg, int p1, @Nullable() Object p2)
public final void log(String msg, long p1, @Nullable() Object p2)
public final void log(String msg, float p1, @Nullable() Object p2)
public final void log(String msg, double p1, @Nullable() Object p2)
public final void log(String msg, boolean p1, boolean p2)
public final void log(String msg, char p1, boolean p2)
public final void log(String msg, byte p1, boolean p2)
public final void log(String msg, short p1, boolean p2)
public final void log(String msg, int p1, boolean p2)
public final void log(String msg, long p1, boolean p2)
public final void log(String msg, float p1, boolean p2)
public final void log(String msg, double p1, boolean p2)
public final void log(String msg, boolean p1, char p2)
public final void log(String msg, char p1, char p2)
public final void log(String msg, byte p1, char p2)
public final void log(String msg, short p1, char p2)
public final void log(String msg, int p1, char p2)
public final void log(String msg, long p1, char p2)
public final void log(String msg, float p1, char p2)
public final void log(String msg, double p1, char p2)
public final void log(String msg, boolean p1, byte p2)
public final void log(String msg, char p1, byte p2)
public final void log(String msg, byte p1, byte p2)
public final void log(String msg, short p1, byte p2)
public final void log(String msg, int p1, byte p2)
public final void log(String msg, long p1, byte p2)
public final void log(String msg, float p1, byte p2)
public final void log(String msg, double p1, byte p2)
public final void log(String msg, boolean p1, short p2)
public final void log(String msg, char p1, short p2)
public final void log(String msg, byte p1, short p2)
public final void log(String msg, short p1, short p2)
public final void log(String msg, int p1, short p2)
public final void log(String msg, long p1, short p2)
public final void log(String msg, float p1, short p2)
public final void log(String msg, double p1, short p2)
public final void log(String msg, boolean p1, int p2)
public final void log(String msg, char p1, int p2)
public final void log(String msg, byte p1, int p2)
public final void log(String msg, short p1, int p2)
public final void log(String msg, int p1, int p2)
public final void log(String msg, long p1, int p2)
public final void log(String msg, float p1, int p2)
public final void log(String msg, double p1, int p2)
public final void log(String msg, boolean p1, long p2)
public final void log(String msg, char p1, long p2)
public final void log(String msg, byte p1, long p2)
public final void log(String msg, short p1, long p2)
public final void log(String msg, int p1, long p2)
public final void log(String msg, long p1, long p2)
public final void log(String msg, float p1, long p2)
public final void log(String msg, double p1, long p2)
public final void log(String msg, boolean p1, float p2)
public final void log(String msg, char p1, float p2)
public final void log(String msg, byte p1, float p2)
public final void log(String msg, short p1, float p2)
public final void log(String msg, int p1, float p2)
public final void log(String msg, long p1, float p2)
public final void log(String msg, float p1, float p2)
public final void log(String msg, double p1, float p2)
public final void log(String msg, boolean p1, double p2)
public final void log(String msg, char p1, double p2)
public final void log(String msg, byte p1, double p2)
public final void log(String msg, short p1, double p2)
public final void log(String msg, int p1, double p2)
public final void log(String msg, long p1, double p2)
public final void log(String msg, float p1, double p2)
public final void log(String msg, double p1, double p2)

Logs a message with formatted arguments (see log for details).