MutableLogEvent (Apache Log4j 2 2.7 API)

java.lang.Object
- org.apache.logging.log4j.core.impl.MutableLogEvent

All Implemented Interfaces:

Serializable, LogEvent, Message, ReusableMessage, StringBuilderFormattable
```
public class MutableLogEvent
extends Object
implements LogEvent, ReusableMessage
```
Mutable implementation of the LogEvent interface.

Since:

2.6

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

MutableLogEvent()

MutableLogEvent(StringBuilder msgText, Object[] replacementParameters)

Constructors
Constructor and Description
`MutableLogEvent()`
`MutableLogEvent(StringBuilder msgText, Object[] replacementParameters)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()` Clears all references this event has to other objects.
`Log4jLogEvent`	`createMemento()` Creates and returns a new immutable copy of this `MutableLogEvent`.
`void`	`formatTo(StringBuilder buffer)` Writes a text representation of this object into the specified `StringBuilder`, ideally without allocating temporary objects.
`ReadOnlyStringMap`	`getContextData()` Returns the `ReadOnlyStringMap` object holding context data key-value pairs.
`Map<String,String>`	`getContextMap()` Gets the context map (also know as Mapped Diagnostic Context or MDC).
`ThreadContext.ContextStack`	`getContextStack()` Gets the context stack (also known as Nested Diagnostic Context or NDC).
`String`	`getFormat()` Gets the format portion of the Message.
`String`	`getFormattedMessage()` Gets the Message formatted as a String.
`Level`	`getLevel()` Gets the level.
`String`	`getLoggerFqcn()` Returns the fully qualified class name of the caller of the logging API.
`String`	`getLoggerName()` Gets the logger name.
`Marker`	`getMarker()` Gets the Marker associated with the event.
`Message`	`getMessage()` Gets the message associated with the event.
`long`	`getNanoTime()` 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`	`getParameterCount()` Returns the number of parameters that was used to initialize this reusable message for the current content.
`Object[]`	`getParameters()` Gets parameter values, if any.
`StackTraceElement`	`getSource()` Returns the StackTraceElement for the caller.
`long`	`getThreadId()` Gets the thread ID.
`String`	`getThreadName()` Gets the thread name.
`int`	`getThreadPriority()` Gets the thread priority.
`Throwable`	`getThrowable()` Gets the throwable, if any.
`Throwable`	`getThrown()` Gets throwable associated with logging request.
`ThrowableProxy`	`getThrownProxy()` Returns the ThrowableProxy associated with the event, or null.
`long`	`getTimeMillis()` Gets event time in milliseconds since midnight, January 1, 1970 UTC.
`void`	`initFrom(LogEvent event)` Initialize the fields of this `MutableLogEvent` from another event.
`void`	`initializeBuilder(Log4jLogEvent.Builder builder)` Initializes the specified `Log4jLogEvent.Builder` from this `MutableLogEvent`.
`boolean`	`isEndOfBatch()` Returns `true` if this event is the last one in a batch, `false` otherwise.
`boolean`	`isIncludeLocation()` Returns whether the source of the logging request is required downstream.
`Message`	`memento()` Returns an immutable snapshot of the current internal state of this reusable message.
`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`	`setLevel(Level level)`
`void`	`setLoggerFqcn(String loggerFqcn)`
`void`	`setLoggerName(String loggerName)`
`void`	`setMarker(Marker marker)`
`void`	`setMessage(Message msg)`
`void`	`setNanoTime(long nanoTime)`
`void`	`setThreadId(long threadId)`
`void`	`setThreadName(String threadName)`
`void`	`setThreadPriority(int threadPriority)`
`void`	`setThrown(Throwable thrown)`
`void`	`setTimeMillis(long timeMillis)`
`Object[]`	`swapParameters(Object[] emptyReplacement)` Replaces this ReusableMessage's parameter array with the specified value and return the original array
`protected Object`	`writeReplace()` Creates a LogEventProxy that can be serialized.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MutableLogEvent
```
public MutableLogEvent()
```
  - MutableLogEvent
```
public MutableLogEvent(StringBuilder msgText,
                       Object[] replacementParameters)
```
- Method Detail
  - initFrom
```
public void initFrom(LogEvent event)
```
    Initialize the fields of this MutableLogEvent from another event. Similar in purpose and usage as Log4jLogEvent.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
```
public String getLoggerFqcn()
```
    Description copied from interface: LogEvent
    
    Returns the fully qualified class name of the caller of the logging API.
    
    Specified by:
    
    getLoggerFqcn in interface LogEvent
    
    Returns:
    
    The fully qualified class name of the caller.
  - setLoggerFqcn
```
public void setLoggerFqcn(String loggerFqcn)
```
  - getMarker
```
public Marker getMarker()
```
    Description copied from interface: LogEvent
    
    Gets the Marker associated with the event.
    
    Specified by:
    
    getMarker in interface LogEvent
    
    Returns:
    
    Marker or null if no Marker was defined on this LogEvent
  - setMarker
```
public void setMarker(Marker marker)
```
  - getLevel
```
public Level getLevel()
```
    Description copied from interface: LogEvent
    
    Gets the level.
    
    Specified by:
    
    getLevel in interface LogEvent
    
    Returns:
    
    level.
  - setLevel
```
public void setLevel(Level level)
```
  - getLoggerName
```
public String getLoggerName()
```
    Description copied from interface: LogEvent
    
    Gets the logger name.
    
    Specified by:
    
    getLoggerName in interface LogEvent
    
    Returns:
    
    logger name, may be null.
  - setLoggerName
```
public void setLoggerName(String loggerName)
```
  - getMessage
```
public Message getMessage()
```
    Description copied from interface: LogEvent
    
    Gets the message associated with the event.
    
    Specified by:
    
    getMessage in interface LogEvent
    
    Returns:
    
    message.
  - setMessage
```
public void setMessage(Message msg)
```
  - getFormattedMessage
```
public String getFormattedMessage()
```
    Description copied from interface: Message
    
    Gets the Message formatted as a String. Each Message implementation determines the appropriate way to format the data encapsulated in the Message. Messages that provide more than one way of formatting the Message will implement MultiformatMessage.
    This method will not be called for Messages that implement the StringBuilderFormattable interface: instead, the formatTo(StringBuilder) method will be called so the Message can format its contents without creating intermediate String objects.
    
    Specified by:
    
    getFormattedMessage in interface Message
    
    Returns:
    
    The message String.
    
    See Also:
    
    Message.getFormattedMessage()
  - getFormat
```
public String getFormat()
```
    Description copied from interface: Message
    
    Gets the format portion of the Message.
    
    Specified by:
    
    getFormat in interface Message
    
    Returns:
    
    The message format. Some implementations, such as ParameterizedMessage, will use this as the message "pattern". Other Messages may simply return an empty String. TODO Do all messages have a format? What syntax? Using a Formatter object could be cleaner. (RG) In SimpleMessage the format is identical to the formatted message. In ParameterizedMessage and StructuredDataMessage it is not. It is up to the Message implementer to determine what this method will return. A Formatter is inappropriate as this is very specific to the Message implementation so it isn't clear to me how having a Formatter separate from the Message would be cleaner.
    
    See Also:
    
    Message.getFormat()
  - getParameters
```
public Object[] getParameters()
```
    Description copied from interface: Message
    
    Gets parameter values, if any.
    
    Specified by:
    
    getParameters in interface Message
    
    Returns:
    
    An array of parameter values or null.
    
    See Also:
    
    Message.getParameters()
  - getThrowable
```
public Throwable getThrowable()
```
    Description copied from interface: Message
    
    Gets the throwable, if any.
    
    Specified by:
    
    getThrowable in interface Message
    
    Returns:
    
    the throwable or null.
    
    See Also:
    
    Message.getThrowable()
  - formatTo
```
public void formatTo(StringBuilder buffer)
```
    Description copied from interface: StringBuilderFormattable
    
    Writes a text representation of this object into the specified StringBuilder, ideally without allocating temporary objects.
    
    Specified by:
    
    formatTo in interface StringBuilderFormattable
    
    Parameters:
    
    buffer - the StringBuilder to write into
    
    See Also:
    
    StringBuilderFormattable.formatTo(StringBuilder)
  - swapParameters
```
public Object[] swapParameters(Object[] emptyReplacement)
```
    Replaces this ReusableMessage's parameter array with the specified value and return the original array
    
    Specified by:
    
    swapParameters in interface ReusableMessage
    
    Parameters:
    
    emptyReplacement - the parameter array that can be used for subsequent uses of this reusable message
    
    Returns:
    
    the original parameter array
    
    See Also:
    
    ReusableMessage.swapParameters(Object[])
  - getParameterCount
```
public short getParameterCount()
```
    Description copied from interface: ReusableMessage
    
    Returns the number of parameters that was used to initialize this reusable message for the current content.
    The parameter array returned by ReusableMessage.swapParameters(Object[]) may be larger than the actual number of parameters. Callers should use this method to determine how many elements the array contains.
    
    Specified by:
    
    getParameterCount in interface ReusableMessage
    
    Returns:
    
    the current number of parameters
  - memento
```
public Message memento()
```
    Description copied from interface: ReusableMessage
    
    Returns an immutable snapshot of the current internal state of this reusable message. The returned snapshot will not be affected by subsequent modifications of this reusable message.
    
    Specified by:
    
    memento in interface ReusableMessage
    
    Returns:
    
    an immutable snapshot of this message
  - getThrown
```
public Throwable getThrown()
```
    Description copied from interface: LogEvent
    
    Gets throwable associated with logging request.
    Convenience method for ThrowableProxy.getThrowable();
    
    Specified by:
    
    getThrown in interface LogEvent
    
    Returns:
    
    throwable, may be null.
  - setThrown
```
public void setThrown(Throwable thrown)
```
  - getTimeMillis
```
public long getTimeMillis()
```
    Description copied from interface: LogEvent
    
    Gets event time in milliseconds since midnight, January 1, 1970 UTC.
    
    Specified by:
    
    getTimeMillis in interface LogEvent
    
    Returns:
    
    milliseconds since midnight, January 1, 1970 UTC.
    
    See Also:
    
    System.currentTimeMillis()
  - setTimeMillis
```
public void setTimeMillis(long timeMillis)
```
  - getThrownProxy
```
public ThrowableProxy getThrownProxy()
```
    Returns the ThrowableProxy associated with the event, or null.
    
    Specified by:
    
    getThrownProxy in interface LogEvent
    
    Returns:
    
    The ThrowableProxy associated with the event.
  - getSource
```
public StackTraceElement 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.
    
    Specified by:
    
    getSource in interface LogEvent
    
    Returns:
    
    the StackTraceElement for the caller.
  - getContextData
```
public ReadOnlyStringMap getContextData()
```
    Description copied from interface: LogEvent
    
    Returns the ReadOnlyStringMap 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 custom ContextDataInjector to inject key-value pairs from any arbitrary source.
    
    Specified by:
    
    getContextData in interface LogEvent
    
    Returns:
    
    the ReadOnlyStringMap object holding context data key-value pairs
    
    See Also:
    
    ContextDataInjector, ThreadContext
  - getContextMap
```
public Map<String,String> getContextMap()
```
    Description copied from interface: LogEvent
    
    Gets the context map (also know as Mapped Diagnostic Context or MDC).
    
    Specified by:
    
    getContextMap in interface LogEvent
    
    Returns:
    
    The context map, never null.
  - setContextData
```
public void setContextData(StringMap mutableContextData)
```
  - getContextStack
```
public ThreadContext.ContextStack getContextStack()
```
    Description copied from interface: LogEvent
    
    Gets the context stack (also known as Nested Diagnostic Context or NDC).
    
    Specified by:
    
    getContextStack in interface LogEvent
    
    Returns:
    
    The context stack, never null.
  - setContextStack
```
public void setContextStack(ThreadContext.ContextStack contextStack)
```
  - getThreadId
```
public long getThreadId()
```
    Description copied from interface: LogEvent
    
    Gets the thread ID.
    
    Specified by:
    
    getThreadId in interface LogEvent
    
    Returns:
    
    thread ID.
  - setThreadId
```
public void setThreadId(long threadId)
```
  - getThreadName
```
public String getThreadName()
```
    Description copied from interface: LogEvent
    
    Gets the thread name.
    
    Specified by:
    
    getThreadName in interface LogEvent
    
    Returns:
    
    thread name, may be null. TODO guess this could go into a thread context object too. (RG) Why?
  - setThreadName
```
public void setThreadName(String threadName)
```
  - getThreadPriority
```
public int getThreadPriority()
```
    Description copied from interface: LogEvent
    
    Gets the thread priority.
    
    Specified by:
    
    getThreadPriority in interface LogEvent
    
    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 a StackTrace snapshot or not before handing off this event to another thread.
    
    Specified by:
    
    isIncludeLocation in interface LogEvent
    
    Returns:
    
    true if the source of the logging request is required downstream, false otherwise.
    
    See Also:
    
    LogEvent.getSource()
  - 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 a StackTrace snapshot or not before handing off this event to another thread.
    
    Specified by:
    
    setIncludeLocation in interface LogEvent
    
    Parameters:
    
    includeLocation - true if the source of the logging request is required downstream, false otherwise.
    
    See Also:
    
    LogEvent.getSource()
  - isEndOfBatch
```
public boolean isEndOfBatch()
```
    Description copied from interface: LogEvent
    
    Returns true 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 the immediateFlush=true configuration.
    
    Specified by:
    
    isEndOfBatch in interface LogEvent
    
    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 the immediateFlush=true configuration.
    
    Specified by:
    
    setEndOfBatch in interface LogEvent
    
    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 interface LogEvent
    
    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
```
protected Object writeReplace()
```
    Creates a LogEventProxy that can be serialized.
    
    Returns:
    
    a LogEventProxy.
  - createMemento
```
public Log4jLogEvent createMemento()
```
    Creates and returns a new immutable copy of this MutableLogEvent. If isIncludeLocation() is true, this will obtain caller location information.
    
    Returns:
    
    a new immutable copy of the data in this MutableLogEvent
  - initializeBuilder
```
public void initializeBuilder(Log4jLogEvent.Builder builder)
```
    Initializes the specified Log4jLogEvent.Builder from this MutableLogEvent.
    
    Parameters:
    
    builder - the builder whose fields to populate

Copyright © 1999-2017 Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.

Class MutableLogEvent

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MutableLogEvent

MutableLogEvent

Method Detail

initFrom

clear

getLoggerFqcn

setLoggerFqcn

getMarker

setMarker

getLevel

setLevel

getLoggerName

setLoggerName

getMessage

setMessage

getFormattedMessage

getFormat

getParameters

getThrowable

formatTo

swapParameters

getParameterCount

memento

getThrown

setThrown

getTimeMillis

setTimeMillis

getThrownProxy

getSource

getContextData

getContextMap

setContextData

getContextStack

setContextStack

getThreadId

setThreadId

getThreadName

setThreadName

getThreadPriority

setThreadPriority

isIncludeLocation

setIncludeLocation

isEndOfBatch

setEndOfBatch

getNanoTime

setNanoTime

writeReplace

createMemento

initializeBuilder