Package org.apache.logging.log4j.message

Class ReusableMessageFactory

java.lang.Object

org.apache.logging.log4j.message.ReusableMessageFactory

All Implemented Interfaces:

Serializable, MessageFactory, MessageFactory2

public final class ReusableMessageFactory
extends Object
implements MessageFactory2, Serializable

Implementation of the MessageFactory interface that avoids allocating temporary objects where possible. Message instances are cached in a ThreadLocal and reused when a new message is requested within the same thread.

Since:

2.6

See Also:

• ParameterizedMessageFactory
• ReusableSimpleMessage
• ReusableObjectMessage
• ReusableParameterizedMessage
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final ReusableMessageFactory	INSTANCE	Instance of ReusableMessageFactory.

Constructor Summary

Constructors

Constructor	Description
ReusableMessageFactory()	Constructs a message factory.

Method Summary

Modifier and Type	Method	Description
Message	newMessage(CharSequence charSequence)	Creates a new message for the specified CharSequence.
Message	newMessage(Object message)	Creates ReusableObjectMessage instances.
Message	newMessage(String message)	Creates ReusableSimpleMessage instances.
Message	newMessage(String message, Object p0)	Creates a new parameterized message.
Message	newMessage(String message, Object... params)	Creates ReusableParameterizedMessage instances.
Message	newMessage(String message, Object p0, Object p1)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)	Creates a new parameterized message.
Message	newMessage(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)	Creates a new parameterized message.
static void	release(Message message)	Invokes Clearable.clear() when possible.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

INSTANCE

public static final ReusableMessageFactory INSTANCE

Instance of ReusableMessageFactory.

Constructor Details

ReusableMessageFactory

public ReusableMessageFactory()

Constructs a message factory.

Method Details

release

public static void release(Message message)

Invokes Clearable.clear() when possible. This flag is used internally to verify that a reusable message is no longer in use and can be reused.

Parameters:

message - the message to make available again

Since:

2.7

newMessage

public Message newMessage(CharSequence charSequence)

Description copied from interface: MessageFactory2

Creates a new message for the specified CharSequence.

Specified by:

newMessage in interface MessageFactory2

Parameters:

charSequence - the (potentially mutable) CharSequence

Returns:

a new message for the specified CharSequence

newMessage

public Message newMessage(String message,
 Object... params)

Creates ReusableParameterizedMessage instances.

Specified by:

newMessage in interface MessageFactory

Parameters:

message - The message pattern.

params - The message parameters.

Returns:

The Message.

See Also:

• MessageFactory.newMessage(String, Object...)

newMessage

public Message newMessage(String message,
 Object p0)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4,
 Object p5)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

p5 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4,
 Object p5,
 Object p6)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

p5 - a message parameter

p6 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4,
 Object p5,
 Object p6,
 Object p7)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

p5 - a message parameter

p6 - a message parameter

p7 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4,
 Object p5,
 Object p6,
 Object p7,
 Object p8)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

p5 - a message parameter

p6 - a message parameter

p7 - a message parameter

p8 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message,
 Object p0,
 Object p1,
 Object p2,
 Object p3,
 Object p4,
 Object p5,
 Object p6,
 Object p7,
 Object p8,
 Object p9)

Description copied from interface: MessageFactory2

Creates a new parameterized message.

Specified by:

newMessage in interface MessageFactory2

Parameters:

message - a message template, the kind of message template depends on the implementation.

p0 - a message parameter

p1 - a message parameter

p2 - a message parameter

p3 - a message parameter

p4 - a message parameter

p5 - a message parameter

p6 - a message parameter

p7 - a message parameter

p8 - a message parameter

p9 - a message parameter

Returns:

a new message

See Also:

• ParameterizedMessageFactory

newMessage

public Message newMessage(String message)

Creates ReusableSimpleMessage instances.

Specified by:

newMessage in interface MessageFactory

Parameters:

message - The message String.

Returns:

The Message.

See Also:

• MessageFactory.newMessage(String)

newMessage

public Message newMessage(Object message)

Creates ReusableObjectMessage instances.

Specified by:

newMessage in interface MessageFactory

Parameters:

message - The message Object.

Returns:

The Message.

See Also:

• MessageFactory.newMessage(Object)