# Package org.apache.commons.configuration2.convert

This package contains interfaces and classes related to data type conversions.

An `AbstractConfiguration` object is associated with an object responsible for data type conversions. Each conversion is done by this object. By replacing the default conversion handler by a custom version, client applications can adapt and extend the type conversions available.

Related to data type conversion is also the topic of list delimiter parsing and splitting; before a string value can be converted to a target data type, it must be clear whether it is to be interpreted as a single value or as a list containing multiple values. In this package there are classes implementing different strategies for list delimiter handling. Client code can choose the one which is most suitable for the current use case.

- Interface Summary
  Interface | Description
  --- | ---
  ConversionHandler | An interface defining the possible data type conversions supported by the configuration framework.
  ListDelimiterHandler | Definition of an interface that controls the handling of list delimiters in configuration properties.
  ValueTransformer | Definition of an interface used by `ListDelimiterHandler` to perform additional transformations on behalf of a configuration when a property value is escaped.

- Class Summary
  Class | Description
  --- | ---
  AbstractListDelimiterHandler | An abstract base class for concrete `ListDelimiterHandler` implementations.
  DefaultConversionHandler | A default implementation of the `ConversionHandler` interface.
  DefaultListDelimiterHandler | The default implementation of the `ListDelimiterHandler` interface.
  DisabledListDelimiterHandler | A specialized implementation of the `ListDelimiterHandler` interface which disables list splitting.
  LegacyListDelimiterHandler | A specialized implementation of `ListDelimiterHandler` which simulates the list delimiter handling as it was used by `PropertiesConfiguration` in Commons Configuration 1.x.
  PropertyConverter | A utility class to convert the configuration properties into any type.