org.apache.logging.log4j.core.impl

Class Log4jLogEvent

java.lang.Object

org.apache.logging.log4j.core.impl.Log4jLogEvent

All Implemented Interfaces:

java.io.Serializable, LogEvent

public class Log4jLogEvent
extends java.lang.Object
implements LogEvent

Implementation of a LogEvent.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Log4jLogEvent.Builder LogEvent Builder helper class.
(package private) static class	Log4jLogEvent.LogEventProxy Proxy pattern used to serialize the LogEvent.

Field Summary

Fields

Modifier and Type	Field and Description
private static Clock	CLOCK
private static ContextDataInjector	CONTEXT_DATA_INJECTOR
private StringMap	contextData
private ThreadContext.ContextStack	contextStack
private boolean	endOfBatch
private boolean	includeLocation
private Level	level
private java.lang.String	loggerFqcn
private java.lang.String	loggerName
private Marker	marker
private Message	message
private static NanoClock	nanoClock
private long	nanoTime
private static long	serialVersionUID
private java.lang.StackTraceElement	source
private long	threadId
private java.lang.String	threadName
private int	threadPriority
private java.lang.Throwable	thrown
private ThrowableProxy	thrownProxy
private long	timeMillis

Constructor Summary

Constructors

Modifier	Constructor and Description
	Log4jLogEvent()
	Log4jLogEvent(long timestamp) Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.
	Log4jLogEvent(java.lang.String loggerName, Marker marker, java.lang.String loggerFQCN, Level level, Message message, java.util.List<Property> properties, java.lang.Throwable t) Constructor.
	Log4jLogEvent(java.lang.String loggerName, Marker marker, java.lang.String loggerFQCN, Level level, Message message, java.lang.Throwable t) Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.
	Log4jLogEvent(java.lang.String loggerName, Marker marker, java.lang.String loggerFQCN, Level level, Message message, java.lang.Throwable t, java.util.Map<java.lang.String,java.lang.String> mdc, ThreadContext.ContextStack ndc, java.lang.String threadName, java.lang.StackTraceElement location, long timestampMillis) Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.
private	Log4jLogEvent(java.lang.String loggerName, Marker marker, java.lang.String loggerFQCN, Level level, Message message, java.lang.Throwable thrown, ThrowableProxy thrownProxy, StringMap contextData, ThreadContext.ContextStack contextStack, long threadId, java.lang.String threadName, int threadPriority, java.lang.StackTraceElement source, long timestampMillis, long nanoTime) Constructor.

Method Summary

Modifier and Type	Method and Description
Log4jLogEvent.Builder	asBuilder() Returns a new fully initialized Log4jLogEvent.Builder containing a copy of all fields of this event.
static java.lang.StackTraceElement	calcLocation(java.lang.String fqcnOfLogger)
static boolean	canDeserialize(java.io.Serializable event)
private static StringMap	createContextData(java.util.List<Property> properties)
private static StringMap	createContextData(java.util.Map<java.lang.String,java.lang.String> contextMap)
static Log4jLogEvent	createEvent(java.lang.String loggerName, Marker marker, java.lang.String loggerFQCN, Level level, Message message, java.lang.Throwable thrown, ThrowableProxy thrownProxy, java.util.Map<java.lang.String,java.lang.String> mdc, ThreadContext.ContextStack ndc, java.lang.String threadName, java.lang.StackTraceElement location, long timestamp) Deprecated. use Log4jLogEvent.Builder instead. This method will be removed in an upcoming release.
LogEvent	createMemento()
static LogEvent	createMemento(LogEvent logEvent)
static Log4jLogEvent	createMemento(LogEvent event, boolean includeLocation) Creates and returns a new immutable copy of this Log4jLogEvent.
static Log4jLogEvent	deserialize(java.io.Serializable event)
boolean	equals(java.lang.Object o)
ReadOnlyStringMap	getContextData() Returns the ReadOnlyStringMap containing context data key-value pairs.
java.util.Map<java.lang.String,java.lang.String>	getContextMap() Returns the immutable copy of the ThreadContext Map.
ThreadContext.ContextStack	getContextStack() Returns an immutable copy of the ThreadContext stack.
Level	getLevel() Returns the logging Level.
java.lang.String	getLoggerFqcn() The fully qualified class name of the class that was called by the caller.
java.lang.String	getLoggerName() Returns the name of the Logger used to generate the event.
Marker	getMarker() Returns the Marker associated with the event, or null.
Message	getMessage() Returns the Message associated with the event.
static NanoClock	getNanoClock() Returns the NanoClock to use for creating the nanoTime timestamp of log events.
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.
java.lang.StackTraceElement	getSource() Returns the StackTraceElement for the caller.
long	getThreadId() Gets the thread ID.
java.lang.String	getThreadName() Returns the name of the Thread on which the event was generated.
int	getThreadPriority() Gets the thread priority.
java.lang.Throwable	getThrown() Returns the Throwable associated with the event, or null.
ThrowableProxy	getThrownProxy() Returns the ThrowableProxy associated with the event, or null.
long	getTimeMillis() Returns the time in milliseconds from the epoch when the event occurred.
int	hashCode()
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.
void	makeMessageImmutable()
static Log4jLogEvent.Builder	newBuilder() Returns a new empty Log4jLogEvent.Builder with all fields empty.
private void	readObject(java.io.ObjectInputStream stream)
static java.io.Serializable	serialize(Log4jLogEvent event, boolean includeLocation) Take a snapshot of the specified Log4jLogEvent.
static java.io.Serializable	serialize(LogEvent event, boolean includeLocation) Take a snapshot of the specified LogEvent.
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.
static void	setNanoClock(NanoClock nanoClock) Sets the NanoClock to use for creating the nanoTime timestamp of log events.
Log4jLogEvent	toImmutable() Returns an immutable version of this log event, which MAY BE a copy of this event.
java.lang.String	toString()
protected java.lang.Object	writeReplace() Creates a LogEventProxy that can be serialized.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

CLOCK

private static final Clock CLOCK

nanoClock

private static volatile NanoClock nanoClock

CONTEXT_DATA_INJECTOR

private static final ContextDataInjector CONTEXT_DATA_INJECTOR

loggerFqcn

private final java.lang.String loggerFqcn

marker

private final Marker marker

level

private final Level level

loggerName

private final java.lang.String loggerName

message

private Message message

timeMillis

private final long timeMillis

thrown

private final transient java.lang.Throwable thrown

thrownProxy

private ThrowableProxy thrownProxy

contextData

private final StringMap contextData

contextStack

private final ThreadContext.ContextStack contextStack

threadId

private long threadId

threadName

private java.lang.String threadName

threadPriority

private int threadPriority

source

private java.lang.StackTraceElement source

includeLocation

private boolean includeLocation

endOfBatch

private boolean endOfBatch

nanoTime

private final transient long nanoTime

Since:

Log4J 2.4

Constructor Detail

Log4jLogEvent

public Log4jLogEvent()

Log4jLogEvent

@Deprecated
public Log4jLogEvent(long timestamp)

Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.

Log4jLogEvent

@Deprecated
public Log4jLogEvent(java.lang.String loggerName,
                                 Marker marker,
                                 java.lang.String loggerFQCN,
                                 Level level,
                                 Message message,
                                 java.lang.Throwable t)

Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.

Constructor.

Parameters:

loggerName - The name of the Logger.

marker - The Marker or null.

loggerFQCN - The fully qualified class name of the caller.

level - The logging Level.

message - The Message.

t - A Throwable or null.

Log4jLogEvent

public Log4jLogEvent(java.lang.String loggerName,
                     Marker marker,
                     java.lang.String loggerFQCN,
                     Level level,
                     Message message,
                     java.util.List<Property> properties,
                     java.lang.Throwable t)

Constructor.

Parameters:

loggerName - The name of the Logger.

marker - The Marker or null.

loggerFQCN - The fully qualified class name of the caller.

level - The logging Level.

message - The Message.

properties - the properties to be merged with ThreadContext key-value pairs into the event's ReadOnlyStringMap.

t - A Throwable or null.

Log4jLogEvent

@Deprecated
public Log4jLogEvent(java.lang.String loggerName,
                                 Marker marker,
                                 java.lang.String loggerFQCN,
                                 Level level,
                                 Message message,
                                 java.lang.Throwable t,
                                 java.util.Map<java.lang.String,java.lang.String> mdc,
                                 ThreadContext.ContextStack ndc,
                                 java.lang.String threadName,
                                 java.lang.StackTraceElement location,
                                 long timestampMillis)

Deprecated. use Log4jLogEvent.Builder instead. This constructor will be removed in an upcoming release.

Constructor.

Parameters:

loggerName - The name of the Logger.

marker - The Marker or null.

loggerFQCN - The fully qualified class name of the caller.

level - The logging Level.

message - The Message.

t - A Throwable or null.

mdc - The mapped diagnostic context.

ndc - the nested diagnostic context.

threadName - The name of the thread.

location - The locations of the caller.

timestampMillis - The timestamp of the event.

Log4jLogEvent

private Log4jLogEvent(java.lang.String loggerName,
                      Marker marker,
                      java.lang.String loggerFQCN,
                      Level level,
                      Message message,
                      java.lang.Throwable thrown,
                      ThrowableProxy thrownProxy,
                      StringMap contextData,
                      ThreadContext.ContextStack contextStack,
                      long threadId,
                      java.lang.String threadName,
                      int threadPriority,
                      java.lang.StackTraceElement source,
                      long timestampMillis,
                      long nanoTime)

Constructor.

Parameters:

loggerName - The name of the Logger.

marker - The Marker or null.

loggerFQCN - The fully qualified class name of the caller.

level - The logging Level.

message - The Message.

thrown - A Throwable or null.

thrownProxy - A ThrowableProxy or null.

contextData - The key-value pairs from the context.

contextStack - the nested diagnostic context.

threadId - the thread ID

threadName - The name of the thread.

threadPriority - the thread priority

source - The locations of the caller.

timestampMillis - The timestamp of the event.

nanoTime - The value of the running Java Virtual Machine's high-resolution time source when the event was created.

Method Detail

newBuilder

public static Log4jLogEvent.Builder newBuilder()

Returns a new empty Log4jLogEvent.Builder with all fields empty.

Returns:

a new empty builder.

createEvent

@Deprecated
public static Log4jLogEvent createEvent(java.lang.String loggerName,
                                                    Marker marker,
                                                    java.lang.String loggerFQCN,
                                                    Level level,
                                                    Message message,
                                                    java.lang.Throwable thrown,
                                                    ThrowableProxy thrownProxy,
                                                    java.util.Map<java.lang.String,java.lang.String> mdc,
                                                    ThreadContext.ContextStack ndc,
                                                    java.lang.String threadName,
                                                    java.lang.StackTraceElement location,
                                                    long timestamp)

Deprecated. use Log4jLogEvent.Builder instead. This method will be removed in an upcoming release.

Create a new LogEvent.

Parameters:

loggerName - The name of the Logger.

marker - The Marker or null.

loggerFQCN - The fully qualified class name of the caller.

level - The logging Level.

message - The Message.

thrown - A Throwable or null.

thrownProxy - A ThrowableProxy or null.

mdc - The mapped diagnostic context.

ndc - the nested diagnostic context.

threadName - The name of the thread.

location - The locations of the caller.

timestamp - The timestamp of the event.

Returns:

a new LogEvent

createContextData

private static StringMap createContextData(java.util.Map<java.lang.String,java.lang.String> contextMap)

createContextData

private static StringMap createContextData(java.util.List<Property> properties)

getNanoClock

public static NanoClock getNanoClock()

Returns the NanoClock to use for creating the nanoTime timestamp of log events.

Returns:

the NanoClock to use for creating the nanoTime timestamp of log events

setNanoClock

public static void setNanoClock(NanoClock nanoClock)

Sets the NanoClock to use for creating the nanoTime timestamp of log events.

FOR INTERNAL USE. This method may be called with a different NanoClock implementation when the configuration changes.

Parameters:

nanoClock - the NanoClock to use for creating the nanoTime timestamp of log events

asBuilder

public Log4jLogEvent.Builder asBuilder()

Returns a new fully initialized Log4jLogEvent.Builder containing a copy of all fields of this event.

Returns:

a new fully initialized builder.

toImmutable

public Log4jLogEvent 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 interface LogEvent

Returns:

an immutable version of this log event

getLevel

public Level getLevel()

Returns the logging Level.

Specified by:

getLevel in interface LogEvent

Returns:

the Level associated with this event.

getLoggerName

public java.lang.String getLoggerName()

Returns the name of the Logger used to generate the event.

Specified by:

getLoggerName in interface LogEvent

Returns:

The Logger name.

getMessage

public Message getMessage()

Returns the Message associated with the event.

Specified by:

getMessage in interface LogEvent

Returns:

The Message.

makeMessageImmutable

public void makeMessageImmutable()

getThreadId

public long getThreadId()

Description copied from interface: LogEvent

Gets the thread ID.

Specified by:

getThreadId in interface LogEvent

Returns:

thread ID.

getThreadName

public java.lang.String getThreadName()

Returns the name of the Thread on which the event was generated.

Specified by:

getThreadName in interface LogEvent

Returns:

The name of the Thread.

getThreadPriority

public int getThreadPriority()

Description copied from interface: LogEvent

Gets the thread priority.

Specified by:

getThreadPriority in interface LogEvent

Returns:

thread priority.

getTimeMillis

public long getTimeMillis()

Returns the time in milliseconds from the epoch when the event occurred.

Specified by:

getTimeMillis in interface LogEvent

Returns:

The time the event occurred.

See Also:

System.currentTimeMillis()

getThrown

public java.lang.Throwable getThrown()

Returns the Throwable associated with the event, or null.

Specified by:

getThrown in interface LogEvent

Returns:

The Throwable associated with the event.

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.

getMarker

public Marker getMarker()

Returns the Marker associated with the event, or null.

Specified by:

getMarker in interface LogEvent

Returns:

the Marker associated with the event.

getLoggerFqcn

public java.lang.String getLoggerFqcn()

The fully qualified class name of the class that was called by the caller.

Specified by:

getLoggerFqcn in interface LogEvent

Returns:

the fully qualified class name of the class that is performing logging.

getContextData

public ReadOnlyStringMap getContextData()

Returns the ReadOnlyStringMap containing context data key-value pairs.

Specified by:

getContextData in interface LogEvent

Returns:

the ReadOnlyStringMap containing context data key-value pairs

Since:

2.7

See Also:

ContextDataInjector, ThreadContext

getContextMap

public java.util.Map<java.lang.String,java.lang.String> getContextMap()

Returns the immutable copy of the ThreadContext Map.

Specified by:

getContextMap in interface LogEvent

Returns:

The context Map.

getContextStack

public ThreadContext.ContextStack getContextStack()

Returns an immutable copy of the ThreadContext stack.

Specified by:

getContextStack in interface LogEvent

Returns:

The context Stack.

getSource

public java.lang.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.

calcLocation

public static java.lang.StackTraceElement calcLocation(java.lang.String fqcnOfLogger)

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.

writeReplace

protected java.lang.Object writeReplace()

Creates a LogEventProxy that can be serialized.

Returns:

a LogEventProxy.

serialize

public static java.io.Serializable serialize(LogEvent event,
                                             boolean includeLocation)

Take a snapshot of the specified LogEvent.

Parameters:

event - the event to take a snapshot of

includeLocation - if true, this method will obtain caller location information

Returns:

snapshot of the event as a Serializable object

See Also:

deserialize(Serializable), serialize(Log4jLogEvent, boolean)

serialize

public static java.io.Serializable serialize(Log4jLogEvent event,
                                             boolean includeLocation)

Take a snapshot of the specified Log4jLogEvent.

Parameters:

event - the event to take a snapshot of

includeLocation - if true, this method will obtain caller location information

Returns:

snapshot of the event as a Serializable object

See Also:

deserialize(Serializable), serialize(LogEvent, boolean)

canDeserialize

public static boolean canDeserialize(java.io.Serializable event)

deserialize

public static Log4jLogEvent deserialize(java.io.Serializable event)

readObject

private void readObject(java.io.ObjectInputStream stream)
                 throws java.io.InvalidObjectException

Throws:

java.io.InvalidObjectException

createMemento

public LogEvent createMemento()

createMemento

public static LogEvent createMemento(LogEvent logEvent)

createMemento

public static Log4jLogEvent createMemento(LogEvent event,
                                          boolean includeLocation)

Creates and returns a new immutable copy of this Log4jLogEvent.

Returns:

a new immutable copy of the data in this Log4jLogEvent

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object