Package org.apache.logging.log4j
Interface LogBuilder
-
public interface LogBuilder
Interface for constructing log events before logging them. Instances of LogBuilders should only be created by calling one of the Logger methods that return a LogBuilder.
-
-
Field Summary
Fields Modifier and Type Field Description static LogBuilder
NOOP
NOOP Logbuilder
-
Method Summary
All Methods Instance Methods Default Methods Modifier and Type Method Description default void
log()
Causes all the data collected to be logged.default void
log(java.lang.CharSequence message)
Causes all the data collected to be logged along with the message.default void
log(java.lang.Object message)
Causes all the data collected to be logged along with the message.default void
log(java.lang.String message)
Causes all the data collected to be logged along with the message.default void
log(java.lang.String message, java.lang.Object p0)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object... params)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7, java.lang.Object p8)
Logs a message with parameters.default void
log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7, java.lang.Object p8, java.lang.Object p9)
Logs a message with parameters.default void
log(java.lang.String message, org.apache.logging.log4j.util.Supplier<?>... params)
Causes all the data collected to be logged along with the message and parameters.default void
log(Message message)
Causes all the data collected to be logged along with the message.default void
log(org.apache.logging.log4j.util.Supplier<Message> messageSupplier)
Causes all the data collected to be logged along with the message.default Message
logAndGet(org.apache.logging.log4j.util.Supplier<Message> messageSupplier)
Causes all the data collected to be logged along with the message.default LogBuilder
withLocation()
An implementation will calculate the caller's stack frame and include it in the log event.default LogBuilder
withLocation(java.lang.StackTraceElement location)
Adds the specified stack trace element to the log event.default LogBuilder
withMarker(Marker marker)
Includes a Marker in the log event.default LogBuilder
withThrowable(java.lang.Throwable throwable)
Includes a Throwable in the log event.
-
-
-
Field Detail
-
NOOP
static final LogBuilder NOOP
NOOP Logbuilder
-
-
Method Detail
-
withMarker
default LogBuilder withMarker(Marker marker)
Includes a Marker in the log event. Interface default method does nothing.- Parameters:
marker
- The Marker to log.- Returns:
- The LogBuilder.
-
withThrowable
default LogBuilder withThrowable(java.lang.Throwable throwable)
Includes a Throwable in the log event. Interface default method does nothing.- Parameters:
throwable
- The Throwable to log.- Returns:
- the LogBuilder.
-
withLocation
default LogBuilder withLocation()
An implementation will calculate the caller's stack frame and include it in the log event. Interface default method does nothing.- Returns:
- The LogBuilder.
-
withLocation
default LogBuilder withLocation(java.lang.StackTraceElement location)
Adds the specified stack trace element to the log event. Interface default method does nothing.- Parameters:
location
- The stack trace element to include in the log event.- Returns:
- The LogBuilder.
-
log
default void log(java.lang.CharSequence message)
Causes all the data collected to be logged along with the message. Interface default method does nothing.- Parameters:
message
- The message to log.
-
log
default void log(java.lang.String message)
Causes all the data collected to be logged along with the message. Interface default method does nothing.- Parameters:
message
- The message to log.
-
log
default void log(java.lang.String message, java.lang.Object... params)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.params
- parameters to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, org.apache.logging.log4j.util.Supplier<?>... params)
Causes all the data collected to be logged along with the message and parameters. Interface default method does nothing.- Parameters:
message
- The message.params
- Parameters to the message.
-
log
default void log(Message message)
Causes all the data collected to be logged along with the message. Interface default method does nothing.- Parameters:
message
- The message to log.
-
log
default void log(org.apache.logging.log4j.util.Supplier<Message> messageSupplier)
Causes all the data collected to be logged along with the message. Interface default method does nothing.- Parameters:
messageSupplier
- The supplier of the message to log.
-
logAndGet
default Message logAndGet(org.apache.logging.log4j.util.Supplier<Message> messageSupplier)
Causes all the data collected to be logged along with the message.- Parameters:
messageSupplier
- The supplier of the message to log.- Returns:
- the message logger or null if no logging occurred.
- Since:
- 2.20
-
log
default void log(java.lang.Object message)
Causes all the data collected to be logged along with the message. Interface default method does nothing.- Parameters:
message
- The message to log.
-
log
default void log(java.lang.String message, java.lang.Object p0)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.p5
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6)
Logs a message with parameters.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.p5
- parameter to the message.p6
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.p5
- parameter to the message.p6
- parameter to the message.p7
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7, java.lang.Object p8)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.p5
- parameter to the message.p6
- parameter to the message.p7
- parameter to the message.p8
- parameter to the message.- See Also:
Unbox
-
log
default void log(java.lang.String message, java.lang.Object p0, java.lang.Object p1, java.lang.Object p2, java.lang.Object p3, java.lang.Object p4, java.lang.Object p5, java.lang.Object p6, java.lang.Object p7, java.lang.Object p8, java.lang.Object p9)
Logs a message with parameters. Interface default method does nothing.- Parameters:
message
- the message to log; the format depends on the message factory.p0
- parameter to the message.p1
- parameter to the message.p2
- parameter to the message.p3
- parameter to the message.p4
- parameter to the message.p5
- parameter to the message.p6
- parameter to the message.p7
- parameter to the message.p8
- parameter to the message.p9
- parameter to the message.- See Also:
Unbox
-
log
default void log()
Causes all the data collected to be logged. Default implementatoin does nothing.
-
-