Class InterpolatorSpecification

java.lang.Object
org.apache.commons.configuration2.interpol.InterpolatorSpecification

public final class InterpolatorSpecification extends Object

A simple value class defining a ConfigurationInterpolator.

Objects of this class can be used for creating new ConfigurationInterpolator instances; they contain all required properties. It is either possible to set a fully initialized ConfigurationInterpolator directly which can be used as is. Alternatively, some or all properties of an instance to be newly created can be set. These properties include

  • a map with Lookup objects associated with a specific prefix
  • a collection with default Lookup objects (without a prefix)
  • a parent ConfigurationInterpolator
  • a function used to convert interpolated values into strings

When setting up a configuration it is possible to define the ConfigurationInterpolator in terms of this class. The configuration will then either use the ConfigurationInterpolator instance explicitly defined in the InterpolatorSpecification instance or create a new one.

Instances are not created directly, but using the nested Builder class. They are then immutable.

Since:
2.0
  • Method Details

    • getDefaultLookups

      Gets a collection with the default lookups.
      Returns:
      the default lookups for a new ConfigurationInterpolator instance (never null)
    • getInterpolator

      Gets the ConfigurationInterpolator instance to be used directly.
      Returns:
      the ConfigurationInterpolator (can be null)
    • getParentInterpolator

      Gets the parent ConfigurationInterpolator object.
      Returns:
      the parent ConfigurationInterpolator (can be null)
    • getPrefixLookups

      Gets a map with prefix lookups. The keys of the map are the prefix strings, its values are the corresponding Lookup objects.
      Returns:
      the prefix lookups for a new ConfigurationInterpolator instance (never null)
    • getStringConverter

      Gets the function used to convert interpolated values to strings or null if the default conversion function is to be used.
      Returns:
      function used to convert interpolated values to strings or null if the default conversion function is to be used