Class MutableLogEvent
- All Implemented Interfaces:
Serializable
,LogEvent
,Message
,ParameterVisitable
,ReusableMessage
,StringBuilderFormattable
LogEvent
interface.- Since:
- 2.6
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Clears all references this event has to other objects.Creates and returns a new immutable copy of thisMutableLogEvent
.<S> void
forEachParameter
(ParameterConsumer<S> action, S state) void
formatTo
(StringBuilder buffer) Returns theReadOnlyStringMap
object holding context data key-value pairs.Gets the context map (also know as Mapped Diagnostic Context or MDC).Gets the context stack (also known as Nested Diagnostic Context or NDC).Returns the Instant when the message was logged.getLevel()
Gets the level.Returns the fully qualified class name of the caller of the logging API.Gets the logger name.Gets the Marker associated with the event.Gets the message associated with the event.long
Returns the value of the running Java Virtual Machine's high-resolution time source when this event was created, or a dummy value if it is known that this value will not be used downstream.short
Object[]
Returns the StackTraceElement for the caller.long
Gets the thread ID.Gets the thread name.int
Gets the thread priority.Gets throwable associated with logging request.Returns the ThrowableProxy associated with the event, or null.long
Gets event time in milliseconds since midnight, January 1, 1970 UTC.void
Initialize the fields of thisMutableLogEvent
from another event.void
initializeBuilder
(Log4jLogEvent.Builder builder) Initializes the specifiedLog4jLogEvent.Builder
from thisMutableLogEvent
.boolean
Returnstrue
if this event is the last one in a batch,false
otherwise.boolean
Returns whether the source of the logging request is required downstream.memento()
void
setContextData
(StringMap mutableContextData) void
setContextStack
(ThreadContext.ContextStack contextStack) void
setEndOfBatch
(boolean endOfBatch) Sets whether this event is the last one in a batch.void
setIncludeLocation
(boolean includeLocation) Sets whether the source of the logging request is required downstream.void
void
setLoggerFqcn
(String loggerFqcn) void
setLoggerName
(String loggerName) void
void
setMessage
(Message msg) void
setNanoTime
(long nanoTime) void
setSource
(StackTraceElement source) void
setThreadId
(long threadId) void
setThreadName
(String threadName) void
setThreadPriority
(int threadPriority) void
void
setTimeMillis
(long timeMillis) Object[]
swapParameters
(Object[] emptyReplacement) Replaces this ReusableMessage's parameter array with the specified value and return the original arrayReturns an immutable version of this log event, which MAY BE a copy of this event.protected Object
Creates a LogEventProxy that can be serialized.
-
Constructor Details
-
MutableLogEvent
public MutableLogEvent() -
MutableLogEvent
-
-
Method Details
-
toImmutable
Description copied from interface:LogEvent
Returns an immutable version of this log event, which MAY BE a copy of this event.- Specified by:
toImmutable
in interfaceLogEvent
- Returns:
- an immutable version of this log event
-
initFrom
Initialize the fields of thisMutableLogEvent
from another event. Similar in purpose and usage asLog4jLogEvent.LogEventProxy
, but a mutable version.This method is used on async logger ringbuffer slots holding MutableLogEvent objects in each slot.
- Parameters:
event
- the event to copy data from
-
clear
public void clear()Clears all references this event has to other objects. -
getLoggerFqcn
Description copied from interface:LogEvent
Returns the fully qualified class name of the caller of the logging API.- Specified by:
getLoggerFqcn
in interfaceLogEvent
- Returns:
- The fully qualified class name of the caller.
-
setLoggerFqcn
-
getMarker
Description copied from interface:LogEvent
Gets the Marker associated with the event. -
setMarker
-
getLevel
Description copied from interface:LogEvent
Gets the level. -
setLevel
-
getLoggerName
Description copied from interface:LogEvent
Gets the logger name.- Specified by:
getLoggerName
in interfaceLogEvent
- Returns:
- logger name, may be
null
.
-
setLoggerName
-
getMessage
Description copied from interface:LogEvent
Gets the message associated with the event.- Specified by:
getMessage
in interfaceLogEvent
- Returns:
- message.
-
setMessage
-
getFormattedMessage
- Specified by:
getFormattedMessage
in interfaceMessage
- See Also:
-
getFormat
-
getParameters
- Specified by:
getParameters
in interfaceMessage
- See Also:
-
forEachParameter
- Specified by:
forEachParameter
in interfaceParameterVisitable
-
getThrowable
- Specified by:
getThrowable
in interfaceMessage
- See Also:
-
formatTo
- Specified by:
formatTo
in interfaceStringBuilderFormattable
- See Also:
-
swapParameters
Replaces this ReusableMessage's parameter array with the specified value and return the original array- Specified by:
swapParameters
in interfaceReusableMessage
- Parameters:
emptyReplacement
- the parameter array that can be used for subsequent uses of this reusable message- Returns:
- the original parameter array
- See Also:
-
getParameterCount
public short getParameterCount()- Specified by:
getParameterCount
in interfaceReusableMessage
-
memento
- Specified by:
memento
in interfaceReusableMessage
-
getThrown
Description copied from interface:LogEvent
Gets throwable associated with logging request.Convenience method for
ThrowableProxy.getThrowable();
-
setThrown
-
getTimeMillis
public long getTimeMillis()Description copied from interface:LogEvent
Gets event time in milliseconds since midnight, January 1, 1970 UTC. UseLogEvent.getInstant()
to get higher precision timestamp information if available on this platform.- Specified by:
getTimeMillis
in interfaceLogEvent
- Returns:
- the milliseconds component of this log event's timestamp
- See Also:
-
setTimeMillis
public void setTimeMillis(long timeMillis) -
getInstant
Description copied from interface:LogEvent
Returns the Instant when the message was logged.Caution: if this
LogEvent
implementation is mutable and reused for multiple consecutive log messages, then theInstant
object returned by this method is also mutable and reused. Client code should not keep a reference to the returned object but make a copy instead.- Specified by:
getInstant
in interfaceLogEvent
- Returns:
- the
Instant
holding Instant details for this log event
-
getThrownProxy
Returns the ThrowableProxy associated with the event, or null.- Specified by:
getThrownProxy
in interfaceLogEvent
- Returns:
- The ThrowableProxy associated with the event.
-
setSource
-
getSource
Returns the StackTraceElement for the caller. This will be the entry that occurs right before the first occurrence of FQCN as a class name. -
getContextData
Description copied from interface:LogEvent
Returns theReadOnlyStringMap
object holding context data key-value pairs.Context data (also known as Mapped Diagnostic Context or MDC) is data that is set by the application to be included in all subsequent log events. The default source for context data is the
ThreadContext
(and properties configured on the Logger that logged the event), but users can configure a customContextDataInjector
to inject key-value pairs from any arbitrary source.- Specified by:
getContextData
in interfaceLogEvent
- Returns:
- the
ReadOnlyStringMap
object holding context data key-value pairs - See Also:
-
getContextMap
Description copied from interface:LogEvent
Gets the context map (also know as Mapped Diagnostic Context or MDC).- Specified by:
getContextMap
in interfaceLogEvent
- Returns:
- The context map, never
null
.
-
setContextData
-
getContextStack
Description copied from interface:LogEvent
Gets the context stack (also known as Nested Diagnostic Context or NDC).- Specified by:
getContextStack
in interfaceLogEvent
- Returns:
- The context stack, never
null
.
-
setContextStack
-
getThreadId
public long getThreadId()Description copied from interface:LogEvent
Gets the thread ID.- Specified by:
getThreadId
in interfaceLogEvent
- Returns:
- thread ID.
-
setThreadId
public void setThreadId(long threadId) -
getThreadName
Description copied from interface:LogEvent
Gets the thread name.- Specified by:
getThreadName
in interfaceLogEvent
- Returns:
- thread name, may be null. TODO guess this could go into a thread context object too. (RG) Why?
-
setThreadName
-
getThreadPriority
public int getThreadPriority()Description copied from interface:LogEvent
Gets the thread priority.- Specified by:
getThreadPriority
in interfaceLogEvent
- Returns:
- thread priority.
-
setThreadPriority
public void setThreadPriority(int threadPriority) -
isIncludeLocation
public boolean isIncludeLocation()Description copied from interface:LogEvent
Returns whether the source of the logging request is required downstream. Asynchronous Loggers and Appenders use this flag to determine whether to take aStackTrace
snapshot or not before handing off this event to another thread.- Specified by:
isIncludeLocation
in interfaceLogEvent
- Returns:
true
if the source of the logging request is required downstream,false
otherwise.- See Also:
-
setIncludeLocation
public void setIncludeLocation(boolean includeLocation) Description copied from interface:LogEvent
Sets whether the source of the logging request is required downstream. Asynchronous Loggers and Appenders use this flag to determine whether to take aStackTrace
snapshot or not before handing off this event to another thread.- Specified by:
setIncludeLocation
in interfaceLogEvent
- Parameters:
includeLocation
-true
if the source of the logging request is required downstream,false
otherwise.- See Also:
-
isEndOfBatch
public boolean isEndOfBatch()Description copied from interface:LogEvent
Returnstrue
if this event is the last one in a batch,false
otherwise. Used by asynchronous Loggers and Appenders to signal to buffered downstream components when to flush to disk, as a more efficient alternative to theimmediateFlush=true
configuration.- Specified by:
isEndOfBatch
in interfaceLogEvent
- Returns:
- whether this event is the last one in a batch.
-
setEndOfBatch
public void setEndOfBatch(boolean endOfBatch) Description copied from interface:LogEvent
Sets whether this event is the last one in a batch. Used by asynchronous Loggers and Appenders to signal to buffered downstream components when to flush to disk, as a more efficient alternative to theimmediateFlush=true
configuration.- Specified by:
setEndOfBatch
in interfaceLogEvent
- Parameters:
endOfBatch
-true
if this event is the last one in a batch,false
otherwise.
-
getNanoTime
public long getNanoTime()Description copied from interface:LogEvent
Returns the value of the running Java Virtual Machine's high-resolution time source when this event was created, or a dummy value if it is known that this value will not be used downstream.- Specified by:
getNanoTime
in interfaceLogEvent
- Returns:
- The value of the running Java Virtual Machine's high-resolution time source when this event was created.
-
setNanoTime
public void setNanoTime(long nanoTime) -
writeReplace
Creates a LogEventProxy that can be serialized.- Returns:
- a LogEventProxy.
-
createMemento
Creates and returns a new immutable copy of thisMutableLogEvent
. IfisIncludeLocation()
is true, this will obtain caller location information.- Returns:
- a new immutable copy of the data in this
MutableLogEvent
-
initializeBuilder
Initializes the specifiedLog4jLogEvent.Builder
from thisMutableLogEvent
.- Parameters:
builder
- the builder whose fields to populate
-