Package org.apache.log4j.spi

## Interface Decoder

- All Known Implementing Classes:
    `UtilLoggingXMLDecoder`, `XMLDecoder`

      public interface Decoder

  Allow LoggingEvents to be reconstructed from a different format (usually XML).
  Author:
    Scott Deboy (sdeboy@apache.org)

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `org.apache.log4j.spi.LoggingEvent` | `decode​(String event)` | Decode event from string.
    `Vector<org.apache.log4j.spi.LoggingEvent>` | `decode​(URL url)` | Decode event from document retreived from URL.
    `Vector<org.apache.log4j.spi.LoggingEvent>` | `decodeEvents​(String document)` | Decode events from document.
    `void` | `setAdditionalProperties​(Map additionalProperties)` | Sets additional properties.

- - ### Method Detail

    - #### decodeEvents

          Vector<org.apache.log4j.spi.LoggingEvent> decodeEvents​(String document)

      Decode events from document.
      Parameters:
        `document` - document to decode.
      Returns:
        list of LoggingEvent instances.

    - #### decode

          org.apache.log4j.spi.LoggingEvent decode​(String event)

      Decode event from string.
      Parameters:
        `event` - string representation of event
      Returns:
        event

    - #### decode

          Vector<org.apache.log4j.spi.LoggingEvent> decode​(URL url)
                                                    throws IOException

      Decode event from document retreived from URL.
      Parameters:
        `url` - url of document
      Returns:
        list of LoggingEvent instances.
      Throws:
        `IOException` - if IO error resolving document.

    - #### setAdditionalProperties

          void setAdditionalProperties​(Map additionalProperties)

      Sets additional properties.
      Parameters:
        `additionalProperties` - map of additional properties.