Class StructuredDataCollectionMessage

java.lang.Object
org.apache.logging.log4j.message.StructuredDataCollectionMessage
All Implemented Interfaces:
Serializable, Iterable<StructuredDataMessage>, Message, MessageCollectionMessage<StructuredDataMessage>, StringBuilderFormattable
public class StructuredDataCollectionMessage extends Object implements StringBuilderFormattable, MessageCollectionMessage<StructuredDataMessage>
A collection of StructuredDataMessages.
Since:
2.9.0
See Also:

  • Field Details

  • Constructor Details

  • Method Details

    • iterator

      public Iterator<StructuredDataMessage> iterator()
      Specified by:
      iterator in interface Iterable<StructuredDataMessage>

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

      When configured to log asynchronously, this method is called before the Message is queued, unless this message implements ReusableMessage or is annotated with AsynchronouslyFormattable. This gives the Message implementation class a chance to create a formatted message String with the current value of any mutable objects. The intention is that the Message implementation caches this formatted message and returns it on subsequent calls. (See LOG4J2-763.)

      When logging synchronously, 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.

    • getFormat

      public String getFormat()
      Description copied from interface: Message
      This method has unclear semantics and inconsistent implementations – its usage is strongly discouraged.
      Specified by:
      getFormat in interface Message

    • 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

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

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