Package org.apache.logging.log4j.core.impl

Class ThreadContextDataInjector.ForGarbageFreeThreadContextMap

java.lang.Object
org.apache.logging.log4j.core.impl.ThreadContextDataInjector.ForGarbageFreeThreadContextMap
All Implemented Interfaces:
ContextDataInjector
Enclosing class:
ThreadContextDataInjector
public static class ThreadContextDataInjector.ForGarbageFreeThreadContextMap extends Object
The ContextDataInjector used when the ThreadContextMap implementation is a garbage-free StringMap-based data structure.

This injector always puts key-value pairs into the specified reusable StringMap.

  • Constructor Details

    • ForGarbageFreeThreadContextMap

      public ForGarbageFreeThreadContextMap()

  • Method Details

    • injectContextData

      public StringMap injectContextData(List<Property> props, StringMap reusable)
      Puts key-value pairs from both the specified list of properties as well as the thread context into the specified reusable StringMap.
      Parameters:
      props - list of configuration properties, may be null
      reusable - a StringMap instance that may be reused to avoid creating temporary objects
      Returns:
      a StringMap combining configuration properties with thread context data
      See Also:

    • rawContextData

      public ReadOnlyStringMap rawContextData()
      Description copied from interface: ContextDataInjector
      Returns a ReadOnlyStringMap object reflecting the current state of the context. Configuration properties are not included in the result.

      This method may be called multiple times for each log event by Filters and Lookups and implementors should take care to make this method as performant as possible while preserving at least the following thread-safety guarantee.

      Thread-safety note: The returned object can only be safely used in the current thread. Changes in the underlying context may or may not be reflected in the returned object, depending on the context data source and the implementation of this method. It is not safe to pass the returned object to another thread.

      Returns:
      a ReadOnlyStringMap object reflecting the current state of the context, may not return null

    • getValue

      public Object getValue(String key)
      Description copied from interface: ContextDataInjector
      Retrieves a single context data value.
      Specified by:
      getValue in interface ContextDataInjector
      Parameters:
      key - The context data key of the value to retrieve.
      Returns:
      A context data value.