org.apache.logging.log4j.message
Interface Message

All Superinterfaces:

Serializable

All Known Subinterfaces:

MultiformatMessage

All Known Implementing Classes:

LocalizedMessage, MapMessage, ObjectMessage, ParameterizedMessage, SimpleMessage, StringFormattedMessage, StructuredDataMessage, ThreadDumpMessage

public interface Message
extends Serializable

An interface for various Message implementations that can be logged. Messages can act as wrappers around Objects so that user can have control over converting Objects to Strings when necessary without requiring complicated formatters and as a way to manipulate the message based on information available at runtime such as the locale of the system.

Note: Message objects should not be considered to be thread safe nor should they be assumed to be safely reusable even on the same thread. The logging system may provide information to the Message objects and the Messages might be queued for asynchronous delivery. Thus, any modifications to a Message object by an application should by avoided after the Message has been passed as a parameter on a Logger method.

Method Summary

String	getFormattedMessage() Returns the Message formatted as a String.
String	getMessageFormat() Returns the format portion of the Message.
Object[]	getParameters() Returns parameter values, if any.

Method Detail

getFormattedMessage

String getFormattedMessage()

Returns 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.

Returns:

The message String.

getMessageFormat

String getMessageFormat()

Returns the format portion of the 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.

getParameters

Object[] getParameters()

Returns parameter values, if any.

Returns:

An array of parameter values or null.