Repository: logging-log4j2 Updated Branches: refs/heads/master 4ca89fa71 -> 05957e6de
Sort members. Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/05957e6d Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/05957e6d Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/05957e6d Branch: refs/heads/master Commit: 05957e6decef7f84c6024354aa2c08ff2cb17241 Parents: 4ca89fa Author: ggregory <[email protected]> Authored: Sun Aug 9 18:43:47 2015 -0700 Committer: ggregory <[email protected]> Committed: Sun Aug 9 18:43:47 2015 -0700 ---------------------------------------------------------------------- .../java/org/apache/logging/log4j/Logger.java | 1366 +++++++++--------- 1 file changed, 683 insertions(+), 683 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/05957e6d/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java ---------------------------------------------------------------------- diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java index 5d6ada9..e366bbb 100644 --- a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java +++ b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java @@ -106,6 +106,27 @@ public interface Logger { void debug(Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with + * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the + * {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void debug(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The + * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void debug(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#DEBUG DEBUG} level. * * @param marker the marker data specific to this log statement @@ -142,6 +163,16 @@ public interface Logger { void debug(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG + * DEBUG} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void debug(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -152,6 +183,27 @@ public interface Logger { void debug(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with + * the specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void debug(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void debug(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#DEBUG DEBUG} level. * * @param msg the message string to be logged @@ -167,6 +219,24 @@ public interface Logger { void debug(Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level. The + * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void debug(MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may + * not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack trace. + */ + void debug(MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#DEBUG DEBUG} level. * * @param message the message object to log. @@ -199,6 +269,15 @@ public interface Logger { void debug(String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG + * DEBUG} level. + * + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void debug(String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#DEBUG DEBUG} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -208,6 +287,24 @@ public interface Logger { void debug(String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void debug(Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack trace. + */ + void debug(Supplier<?> msgSupplier, Throwable t); + + /** * Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be * logged. */ @@ -250,6 +347,27 @@ public interface Logger { void error(Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void error(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void error(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#ERROR ERROR} level. * * @param marker the marker data specific to this log statement. @@ -291,6 +409,16 @@ public interface Logger { void error(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR + * ERROR} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void error(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -301,6 +429,27 @@ public interface Logger { void error(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with + * the specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void error(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void error(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#ERROR ERROR} level. * * @param msg the message string to be logged @@ -316,6 +465,24 @@ public interface Logger { void error(Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void error(MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack trace. + */ + void error(MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#ERROR ERROR} level. * * @param message the message object to log. @@ -353,6 +520,15 @@ public interface Logger { void error(String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR + * ERROR} level. + * + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void error(String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#ERROR ERROR} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -362,6 +538,24 @@ public interface Logger { void error(String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void error(Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack trace. + */ + void error(Supplier<?> msgSupplier, Throwable t); + + /** * Logs exit from a method. Used for methods that do not return anything. */ void exit(); @@ -396,6 +590,27 @@ public interface Logger { void fatal(Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void fatal(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void fatal(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#FATAL FATAL} level. * * @param marker The marker data specific to this log statement. @@ -437,6 +652,16 @@ public interface Logger { void fatal(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL + * FATAL} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void fatal(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -447,6 +672,27 @@ public interface Logger { void fatal(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with + * the specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void fatal(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void fatal(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#FATAL FATAL} level. * * @param msg the message string to be logged @@ -462,16 +708,34 @@ public interface Logger { void fatal(Message msg, Throwable t); /** - * Logs a message object with the {@link Level#FATAL FATAL} level. + * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. * - * @param message the message object to log. + * @param msgSupplier A function, which when called, produces the desired log message. */ - void fatal(Object message); + void fatal(MessageSupplier msgSupplier); /** - * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable} - * <code>t</code> passed as parameter. - * + * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack trace. + */ + void fatal(MessageSupplier msgSupplier, Throwable t); + + /** + * Logs a message object with the {@link Level#FATAL FATAL} level. + * + * @param message the message object to log. + */ + void fatal(Object message); + + /** + * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable} + * <code>t</code> passed as parameter. + * * @param message the message object to log. * @param t the exception to log, including its stack trace. */ @@ -499,6 +763,15 @@ public interface Logger { void fatal(String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL + * FATAL} level. + * + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void fatal(String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#FATAL FATAL} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -508,6 +781,24 @@ public interface Logger { void fatal(String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void fatal(Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack trace. + */ + void fatal(Supplier<?> msgSupplier, Throwable t); + + /** * Gets the Level associated with the Logger. * * @return the Level associate with the Logger. @@ -546,6 +837,27 @@ public interface Logger { void info(Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void info(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void info(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#INFO INFO} level. * * @param marker the marker data specific to this log statement @@ -586,6 +898,16 @@ public interface Logger { void info(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO + * INFO} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void info(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -596,6 +918,27 @@ public interface Logger { void info(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with the + * specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void info(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void info(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#INFO INFO} level. * * @param msg the message string to be logged @@ -611,6 +954,24 @@ public interface Logger { void info(Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void info(MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack trace. + */ + void info(MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#INFO INFO} level. * * @param message the message object to log. @@ -647,6 +1008,15 @@ public interface Logger { void info(String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO + * INFO} level. + * + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void info(String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#INFO INFO} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -656,6 +1026,24 @@ public interface Logger { void info(String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void info(Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack trace. + */ + void info(Supplier<?> msgSupplier, Throwable t); + + /** * Checks whether this Logger is enabled for the {@link Level#DEBUG DEBUG} Level. * * @return boolean - {@code true} if this Logger is enabled for level DEBUG, {@code false} otherwise. @@ -792,6 +1180,29 @@ public interface Logger { void log(Level level, Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the specified level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param level the logging level + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void log(Level level, Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the specified level) with the + * specified Marker and including the stack log of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param level the logging level + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void log(Level level, Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the given level. * * @param level the logging level @@ -811,6 +1222,7 @@ public interface Logger { */ void log(Level level, Marker marker, Object message, Throwable t); + /** * Logs a message object with the given level. * @@ -832,6 +1244,16 @@ public interface Logger { void log(Level level, Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the specified level. + * + * @param level the logging level + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void log(Level level, Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as * parameter. * @@ -843,6 +1265,28 @@ public interface Logger { void log(Level level, Marker marker, String message, Throwable t); /** + * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker. + * + * @param level the logging level + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void log(Level level, Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and + * including the stack log of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param level the logging level + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void log(Level level, Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the given level. * * @param level the logging level @@ -860,6 +1304,26 @@ public interface Logger { void log(Level level, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the specified level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param level the logging level + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void log(Level level, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the specified level) including the + * stack log of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param level the logging level + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack log. + */ + void log(Level level, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the given level. * * @param level the logging level @@ -896,6 +1360,15 @@ public interface Logger { void log(Level level, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the specified level. + * + * @param level the logging level + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void log(Level level, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the given level including the stack trace of the {@link Throwable} <code>t</code> passed as * parameter. * @@ -906,6 +1379,26 @@ public interface Logger { void log(Level level, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the specified level. + * + * @param level the logging level + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void log(Level level, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the specified level) including the stack log of + * the {@link Throwable} <code>t</code> passed as parameter. + * + * @param level the logging level + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack log. + */ + void log(Level level, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a formatted message using the specified format string and arguments. * * @param level The logging Level. @@ -967,12 +1460,33 @@ public interface Logger { void trace(Marker marker, Message msg, Throwable t); /** - * Logs a message object with the {@link Level#TRACE TRACE} level. + * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. * * @param marker the marker data specific to this log statement - * @param message the message object to log. + * @param msgSupplier A function, which when called, produces the desired log message. */ - void trace(Marker marker, Object message); + void trace(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void trace(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** + * Logs a message object with the {@link Level#TRACE TRACE} level. + * + * @param marker the marker data specific to this log statement + * @param message the message object to log. + */ + void trace(Marker marker, Object message); /** * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable} @@ -1004,6 +1518,16 @@ public interface Logger { void trace(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE + * TRACE} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void trace(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -1015,6 +1539,27 @@ public interface Logger { void trace(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with + * the specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void trace(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the + * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void trace(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#TRACE TRACE} level. * * @param msg the message string to be logged @@ -1030,6 +1575,24 @@ public interface Logger { void trace(Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void trace(MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack trace. + */ + void trace(MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#TRACE TRACE} level. * * @param message the message object to log. @@ -1063,6 +1626,15 @@ public interface Logger { void trace(String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE + * TRACE} level. + * + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void trace(String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#TRACE TRACE} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -1073,6 +1645,24 @@ public interface Logger { void trace(String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void trace(Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the + * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t the exception to log, including its stack trace. + */ + void trace(Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#WARN WARN} level. * * @param marker the marker data specific to this log statement @@ -1090,6 +1680,27 @@ public interface Logger { void warn(Marker marker, Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with + * the specified Marker. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void warn(Marker marker, MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the + * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t A Throwable or null. + */ + void warn(Marker marker, MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#WARN WARN} level. * * @param marker the marker data specific to this log statement @@ -1131,6 +1742,16 @@ public interface Logger { void warn(Marker marker, String message, Object... params); /** + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN + * WARN} level. + * + * @param marker the marker data specific to this log statement + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. + */ + void warn(Marker marker, String message, Supplier<?>... paramSuppliers); + + /** * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable} * <code>t</code> passed as parameter. * @@ -1141,6 +1762,27 @@ public interface Logger { void warn(Marker marker, String message, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with the + * specified Marker. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + */ + void warn(Marker marker, Supplier<?> msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the + * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter. + * + * @param marker the marker data specific to this log statement + * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the + * message factory. + * @param t A Throwable or null. + */ + void warn(Marker marker, Supplier<?> msgSupplier, Throwable t); + + /** * Logs a message with the specific Marker at the {@link Level#WARN WARN} level. * * @param msg the message string to be logged @@ -1156,6 +1798,24 @@ public interface Logger { void warn(Message msg, Throwable t); /** + * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + */ + void warn(MessageSupplier msgSupplier); + + /** + * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the + * stack warn of the {@link Throwable} <code>t</code> passed as parameter. + * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. + * + * @param msgSupplier A function, which when called, produces the desired log message. + * @param t the exception to log, including its stack warn. + */ + void warn(MessageSupplier msgSupplier, Throwable t); + + /** * Logs a message object with the {@link Level#WARN WARN} level. * * @param message the message object to log. @@ -1193,699 +1853,39 @@ public interface Logger { void warn(String message, Object... params); /** - * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable} - * <code>t</code> passed as parameter. - * - * @param message the message object to log. - * @param t the exception to log, including its stack trace. - */ - void warn(String message, Throwable t); - - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level. + * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN + * WARN} level. * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. + * @param message the message to log; the format depends on the message factory. + * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. */ - void debug(Supplier<?> msgSupplier); + void warn(String message, Supplier<?>... paramSuppliers); /** - * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * Logs a message at the {@link Level#WARN WARN} level including the stack trace of the {@link Throwable} + * <code>t</code> passed as parameter. * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. + * @param message the message object to log. * @param t the exception to log, including its stack trace. */ - void debug(Supplier<?> msgSupplier, Throwable t); + void warn(String message, Throwable t); /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with - * the specified Marker. + * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level. * - * @param marker the marker data specific to this log statement * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the * message factory. */ - void debug(Marker marker, Supplier<?> msgSupplier); + void warn(Supplier<?> msgSupplier); /** - * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. + * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the + * stack warn of the {@link Throwable} <code>t</code> passed as parameter. * - * @param marker the marker data specific to this log statement * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the * message factory. - * @param t A Throwable or null. - */ - void debug(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level with - * the specified Marker. The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the - * {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void debug(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. The - * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void debug(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level. The - * {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void debug(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#DEBUG DEBUG} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. The {@code MessageSupplier} may or may - * not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack trace. - */ - void debug(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG - * DEBUG} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void debug(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#DEBUG - * DEBUG} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void debug(String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void error(Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack trace. - */ - void error(Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with - * the specified Marker. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void error(Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void error(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR - * ERROR} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void error(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void error(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void error(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#ERROR ERROR} level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void error(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#ERROR ERROR} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack trace. - */ - void error(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#ERROR - * ERROR} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void error(String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void fatal(Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack trace. - */ - void fatal(Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with - * the specified Marker. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void fatal(Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void fatal(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL - * FATAL} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void fatal(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void fatal(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void fatal(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#FATAL FATAL} level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void fatal(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#FATAL FATAL} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack trace. - */ - void fatal(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#FATAL - * FATAL} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void fatal(String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void info(Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack trace. - */ - void info(Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with the - * specified Marker. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void info(Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void info(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO - * INFO} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void info(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void info(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void info(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#INFO INFO} level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void info(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#INFO INFO} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack trace. - */ - void info(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#INFO - * INFO} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void info(String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the specified level. - * - * @param level the logging level - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void log(Level level, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the specified level) including the stack log of - * the {@link Throwable} <code>t</code> passed as parameter. - * - * @param level the logging level - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack log. - */ - void log(Level level, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker. - * - * @param level the logging level - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void log(Level level, Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and - * including the stack log of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param level the logging level - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void log(Level level, Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the specified level. - * - * @param level the logging level - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void log(Level level, Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the specified level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param level the logging level - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void log(Level level, Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the specified level) with the - * specified Marker and including the stack log of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param level the logging level - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void log(Level level, Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the specified level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param level the logging level - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void log(Level level, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the specified level) including the - * stack log of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param level the logging level - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack log. - */ - void log(Level level, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the specified level. - * - * @param level the logging level - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void log(Level level, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void trace(Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack trace. - */ - void trace(Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with - * the specified Marker. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void trace(Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void trace(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE - * TRACE} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void trace(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void trace(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) with the - * specified Marker and including the stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void trace(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#TRACE TRACE} level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void trace(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#TRACE TRACE} level) including the - * stack trace of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack trace. - */ - void trace(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#TRACE - * TRACE} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void trace(String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void warn(Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the - * stack warn of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t the exception to log, including its stack warn. + * @param t the exception to log, including its stack warn. */ void warn(Supplier<?> msgSupplier, Throwable t); - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with the - * specified Marker. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - */ - void warn(Marker marker, Supplier<?> msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the - * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message; the format depends on the - * message factory. - * @param t A Throwable or null. - */ - void warn(Marker marker, Supplier<?> msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN - * WARN} level. - * - * @param marker the marker data specific to this log statement - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void warn(Marker marker, String message, Supplier<?>... paramSuppliers); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level with - * the specified Marker. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void warn(Marker marker, MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) with the - * specified Marker and including the stack warn of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param marker the marker data specific to this log statement - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t A Throwable or null. - */ - void warn(Marker marker, MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message which is only to be constructed if the logging level is the {@link Level#WARN WARN} level. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - */ - void warn(MessageSupplier msgSupplier); - - /** - * Logs a message (only to be constructed if the logging level is the {@link Level#WARN WARN} level) including the - * stack warn of the {@link Throwable} <code>t</code> passed as parameter. - * The {@code MessageSupplier} may or may not use the {@link MessageFactory} to construct the {@code Message}. - * - * @param msgSupplier A function, which when called, produces the desired log message. - * @param t the exception to log, including its stack warn. - */ - void warn(MessageSupplier msgSupplier, Throwable t); - - /** - * Logs a message with parameters which are only to be constructed if the logging level is the {@link Level#WARN - * WARN} level. - * - * @param message the message to log; the format depends on the message factory. - * @param paramSuppliers An array of functions, which when called, produce the desired log message parameters. - */ - void warn(String message, Supplier<?>... paramSuppliers); - }
