org.apache.logging.log4j.core.lookup

Class Interpolator

java.lang.Object

org.apache.logging.log4j.core.lookup.AbstractLookup

org.apache.logging.log4j.core.lookup.AbstractConfigurationAwareLookup

org.apache.logging.log4j.core.lookup.Interpolator

All Implemented Interfaces:

ConfigurationAware, StrLookup

public class Interpolator
extends AbstractConfigurationAwareLookup

Proxies all the other StrLookups.

Field Summary

Fields

Modifier and Type	Field and Description
static char	PREFIX_SEPARATOR Constant for the prefix separator.

Fields inherited from class org.apache.logging.log4j.core.lookup.AbstractConfigurationAwareLookup

configuration

Fields inherited from interface org.apache.logging.log4j.core.lookup.StrLookup

CATEGORY

Constructor Summary

Constructors

Constructor and Description
Interpolator() Create the default Interpolator using only Lookups that work without an event.
Interpolator(Map<String,String> properties) Creates the Interpolator using only Lookups that work without an event and initial properties.
Interpolator(StrLookup defaultLookup)
Interpolator(StrLookup defaultLookup, List<String> pluginPackages) Constructs an Interpolator using a given StrLookup and a list of packages to find Lookup plugins in.

Method Summary

Modifier and Type	Method and Description
Map<String,StrLookup>	getStrLookupMap()
String	lookup(LogEvent event, String var) Resolves the specified variable.
String	toString()

Methods inherited from class org.apache.logging.log4j.core.lookup.AbstractConfigurationAwareLookup

setConfiguration

Methods inherited from class org.apache.logging.log4j.core.lookup.AbstractLookup

lookup

Methods inherited from class java.lang.Object

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

Field Detail

PREFIX_SEPARATOR

public static final char PREFIX_SEPARATOR

Constant for the prefix separator.

See Also:

Constant Field Values

Constructor Detail

Interpolator

public Interpolator(StrLookup defaultLookup)

Interpolator

public Interpolator(StrLookup defaultLookup,
                    List<String> pluginPackages)

Constructs an Interpolator using a given StrLookup and a list of packages to find Lookup plugins in.

Parameters:

defaultLookup - the default StrLookup to use as a fallback

pluginPackages - a list of packages to scan for Lookup plugins

Since:

2.1

Interpolator

public Interpolator()

Create the default Interpolator using only Lookups that work without an event.

Interpolator

public Interpolator(Map<String,String> properties)

Creates the Interpolator using only Lookups that work without an event and initial properties.

Method Detail

getStrLookupMap

public Map<String,StrLookup> getStrLookupMap()

lookup

public String lookup(LogEvent event,
                     String var)

Resolves the specified variable. This implementation will try to extract a variable prefix from the given variable name (the first colon (':') is used as prefix separator). It then passes the name of the variable with the prefix stripped to the lookup object registered for this prefix. If no prefix can be found or if the associated lookup object cannot resolve this variable, the default lookup object will be used.

Parameters:

event - The current LogEvent or null.

var - the name of the variable whose value is to be looked up

Returns:

the value of this variable or null if it cannot be resolved

toString

public String toString()

Overrides:

toString in class Object