Deprecated API

Contents

• Deprecated Classes
• Deprecated Methods

Deprecated Classes

Class	Description
org.apache.commons.configuration.ConfigurationFactory	Use DefaultConfigurationBuilder instead; this class provides the same features as ConfigurationFactory plus some more; it can also process the same configuration definition files.
org.apache.commons.configuration.ConfigurationKey	Use DefaultConfigurationKey instead. It is associated with a DefaultExpressionEngine and thus can produce correct keys even if key separators have been changed.
org.apache.commons.configuration.HierarchicalXMLConfiguration	This class is deprecated. Use XMLConfiguration instead, which supports all features this class had offered before.
org.apache.commons.configuration.INIConfiguration	This class has been replaced by HierarchicalINIConfiguration, which provides a superset of the functionality offered by this class.

Deprecated Methods

Method	Description
org.apache.commons.configuration.HierarchicalConfiguration.clearNode(HierarchicalConfiguration.Node)	Use the method HierarchicalConfiguration.clearNode(ConfigurationNode) instead
org.apache.commons.configuration.HierarchicalConfiguration.createAddPath(ConfigurationKey.KeyIterator, HierarchicalConfiguration.Node)	Adding new properties is now to a major part delegated to the ExpressionEngine associated with this configuration instance. This method will no longer be called. Developers who want to modify the process of adding new properties should consider implementing their own expression engine.
org.apache.commons.configuration.HierarchicalConfiguration.fetchAddNode(ConfigurationKey.KeyIterator, HierarchicalConfiguration.Node)	Adding new properties is now to a major part delegated to the ExpressionEngine associated with this configuration instance. This method will no longer be called. Developers who want to modify the process of adding new properties should consider implementing their own expression engine.
org.apache.commons.configuration.HierarchicalConfiguration.findLastPathNode(ConfigurationKey.KeyIterator, HierarchicalConfiguration.Node)	Adding new properties is now to a major part delegated to the ExpressionEngine associated with this configuration instance. This method will no longer be called. Developers who want to modify the process of adding new properties should consider implementing their own expression engine.
org.apache.commons.configuration.HierarchicalConfiguration.findPropertyNodes(ConfigurationKey.KeyIterator, HierarchicalConfiguration.Node, Collection<ConfigurationNode>)	Property keys are now evaluated by the expression engine associated with the configuration; this method will no longer be called. If you want to modify the way properties are looked up, consider implementing you own ExpressionEngine implementation.
org.apache.commons.configuration.plist.SimpleCharStream.getColumn()
org.apache.commons.configuration.DatabaseConfiguration.getConnection()	Use a custom data source to change the connection used by the class. To be removed in Commons Configuration 2.0
org.apache.commons.configuration.AbstractConfiguration.getDelimiter()	Use AbstractConfiguration.getDefaultListDelimiter() instead
org.apache.commons.configuration.PropertiesConfiguration.getIncludesAllowed()	Only exists to not break backwards compatibility. Use PropertiesConfiguration.isIncludesAllowed() instead.
org.apache.commons.configuration.plist.SimpleCharStream.getLine()
org.apache.commons.configuration.AbstractConfiguration.interpolateHelper(String, List<?>)	Interpolation is now handled by PropertyConverter; this method will no longer be called
org.apache.commons.configuration.HierarchicalConfiguration.nodeDefined(HierarchicalConfiguration.Node)	Use the method HierarchicalConfiguration.nodeDefined(ConfigurationNode) instead.
org.apache.commons.configuration.HierarchicalConfiguration.removeNode(HierarchicalConfiguration.Node)	Use the method HierarchicalConfiguration.removeNode(ConfigurationNode) instead.
org.apache.commons.configuration.XMLConfiguration.resolveEntity(String, String)	Use getEntityResolver().resolveEntity()
org.apache.commons.configuration.AbstractConfiguration.setDelimiter(char)	Use AbstractConfiguration.setDefaultListDelimiter(char) instead