Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Exception Classes
• Fields
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
org.springframework.ldap.filter.CompareFilter.encodeValue(String)	please provide the encoded value in the constructor
org.springframework.ldap.filter.CompareFilter.getCompareString()	please specify the operator in the constructor
org.springframework.ldap.filter.EqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.GreaterThanOrEqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.LessThanOrEqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.LikeFilter.encodeValue(String)	please extend CompareFilter instead

Deprecated Interfaces

Interface	Description
org.springframework.ldap.core.DnParser	DistinguishedName and associated classes are deprecated as of 2.0.
org.springframework.ldap.core.DnParserImplConstants	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.support.BaseLdapPathAware	DistinguishedName and associated classes and methods are deprecated as of 2.0. Use BaseLdapNameAware instead.
org.springframework.ldap.odm.core.OdmManager	This functionality is automatically available in LdapTemplate as of version 2.0
org.springframework.ldap.odm.typeconversion.ConverterManager	please use ConversionService directly
org.springframework.ldap.odm.typeconversion.impl.Converter	please use Converter and ConversionService directly

Deprecated Classes

Class	Description
org.springframework.ldap.control.AbstractFallbackRequestAndResponseControlDirContextProcessor	please use ControlExchangeDirContextProcessor
org.springframework.ldap.control.PagedResult
org.springframework.ldap.control.PagedResultsCookie	please use the response holder in PagedResultsControlExchangeDirContextProcessor
org.springframework.ldap.control.PagedResultsDirContextProcessor	in favor of PagedResultsControlExchangeDirContextProcessor
org.springframework.ldap.control.PagedResultsRequestControl	Use PagedResultsDirContextProcessor instead.
org.springframework.ldap.control.SortControlDirContextProcessor	please use ControlExchangeDirContextProcessor and SortControlExchange instead
org.springframework.ldap.control.VirtualListViewControlAggregateDirContextProcessor	given that this draft was never finalized, please use ControlExchangeDirContextProcessor, providing your own implementation of ControlExchange with the control objects you choose to use
org.springframework.ldap.control.VirtualListViewControlDirContextProcessor	given that this draft was never finalized, please use ControlExchangeDirContextProcessor, providing your own implementation of ControlExchange with the control objects you choose to use
org.springframework.ldap.control.VirtualListViewResultsCookie	no longer used by any non-deprecated class
org.springframework.ldap.core.DefaultDnParserFactory	DistinguishedName and associated classes are deprecated as of 2.0.
org.springframework.ldap.core.DistinguishedName	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.DistinguishedNameEditor	DistinguishedName and associated classes are deprecated as of 2.0.
org.springframework.ldap.core.DnParserImpl	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.DnParserImplTokenManager	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.LdapRdn	DistinguishedName and associated classes are deprecated as of 2.0.
org.springframework.ldap.core.LdapRdnComponent	DistinguishedName and associated classes are deprecated as of 2.0.
org.springframework.ldap.core.SimpleCharStream	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.Token	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.odm.core.impl.OdmManagerImpl	This functionality is automatically available in LdapTemplate as of version 2.0
org.springframework.ldap.odm.core.impl.OdmManagerImplFactoryBean	This functionality is automatically available in LdapTemplate as of version 2.0
org.springframework.ldap.odm.typeconversion.impl.ConversionServiceConverterManager	Please use ConversionService directly and with ConverterUtils to add Spring LDAP converters
org.springframework.ldap.odm.typeconversion.impl.ConverterManagerFactoryBean	please use ConversionService directly
org.springframework.ldap.odm.typeconversion.impl.ConverterManagerImpl	please use ConversionService directly
org.springframework.ldap.odm.typeconversion.impl.converters.FromStringConverter	please use Converter directly
org.springframework.ldap.odm.typeconversion.impl.converters.ToStringConverter	please use Converter and ConversionService directly
org.springframework.ldap.odm.typeconversion.impl.StringConverter	empty class

Deprecated Exception Classes

Exception Class	Description
org.springframework.ldap.control.CreateControlFailedException	this is no longer used in any non-deprecated Spring LDAP classes
org.springframework.ldap.core.ParseException	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.core.TokenMgrError	As of 2.0 it is recommended to use LdapName along with utility methods in LdapUtils instead.
org.springframework.ldap.odm.typeconversion.ConverterException	please use ConversionException

Deprecated Fields

Field	Description
org.springframework.ldap.core.support.AbstractContextSource.password	use AbstractContextSource.getPassword() and AbstractContextSource.setPassword(String) instead
org.springframework.ldap.core.support.AbstractContextSource.userDn	use AbstractContextSource.getUserDn() and AbstractContextSource.setUserDn(String) instead
org.springframework.ldap.core.support.DefaultDirObjectFactory.JNDI_ENV_BASE_PATH_KEY	Use BaseLdapNameAware and BaseLdapPathBeanPostProcessor instead.

Deprecated Methods

Method	Description
org.springframework.ldap.authentication.DefaultValuesAuthenticationSourceDecorator.setDefaultPassword(String)	please provide the default password in the constructor
org.springframework.ldap.authentication.DefaultValuesAuthenticationSourceDecorator.setDefaultUser(String)	please provide the default user in the constructor
org.springframework.ldap.authentication.DefaultValuesAuthenticationSourceDecorator.setTarget(AuthenticationSource)	please provide the AuthenticationSource in the constructor
org.springframework.ldap.core.LdapAttributes.getDN()	and associated classes and methods are deprecated as of 2.0. use LdapAttributes.getName() instead.
org.springframework.ldap.core.LdapAttributes.setDN(DistinguishedName)	and associated classes and methods are deprecated as of 2.0. use LdapAttributes.setName(javax.naming.Name) instead.
org.springframework.ldap.core.LdapClient.builder()	Please provide a ContextSource using LdapClient.withContextSource(ContextSource)
org.springframework.ldap.core.LdapEntryIdentification.getAbsoluteDn()	DistinguishedName and associated classes and methods are deprecated as of 2.0. use LdapEntryIdentification.getAbsoluteName() instead.
org.springframework.ldap.core.LdapEntryIdentification.getRelativeDn()	DistinguishedName and associated classes and methods are deprecated as of 2.0. use LdapEntryIdentification.getRelativeName() instead.
org.springframework.ldap.core.LdapOperations.authenticate(String, String, String)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(String, String, String, AuthenticatedLdapEntryContextCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(String, String, String, AuthenticatedLdapEntryContextCallback, AuthenticationErrorCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(String, String, String, AuthenticationErrorCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(Name, String, String)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(Name, String, String, AuthenticatedLdapEntryContextCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(Name, String, String, AuthenticatedLdapEntryContextCallback, AuthenticationErrorCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapOperations.authenticate(Name, String, String, AuthenticationErrorCallback)	use LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String) or LdapOperations.authenticate(org.springframework.ldap.query.LdapQuery, String, AuthenticatedLdapEntryContextMapper)
org.springframework.ldap.core.LdapRdnComponent.setKey(String)	Using this method changes the internal state of surrounding DistinguishedName instance. This should be avoided.
org.springframework.ldap.core.LdapRdnComponent.setValue(String)	Using this method changes the internal state of surrounding DistinguishedName instance. This should be avoided.
org.springframework.ldap.core.SimpleCharStream.getColumn()
org.springframework.ldap.core.SimpleCharStream.getLine()
org.springframework.ldap.core.support.AbstractContextSource.getBaseLdapPath()	DistinguishedName and associated classes and methods are deprecated as of 2.0.
org.springframework.ldap.core.support.BaseLdapPathBeanPostProcessor.setBasePath(DistinguishedName)	DistinguishedName and associated classes and methods are deprecated as of 2.0.
org.springframework.ldap.core.support.BaseLdapPathSource.getBaseLdapPath()	DistinguishedName and associated classes and methods are deprecated as of 2.0. Use BaseLdapPathSource.getBaseLdapName() instead.
org.springframework.ldap.core.support.ObservationContextSource.getBaseLdapPath()
org.springframework.ldap.filter.CompareFilter.encodeValue(String)	please provide the encoded value in the constructor
org.springframework.ldap.filter.CompareFilter.getCompareString()	please specify the operator in the constructor
org.springframework.ldap.filter.EqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.GreaterThanOrEqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.LessThanOrEqualsFilter.getCompareString()	please extend CompareFilter instead
org.springframework.ldap.filter.LikeFilter.encodeValue(String)	please extend CompareFilter instead
org.springframework.ldap.odm.core.impl.DefaultObjectDirectoryMapper.setConverterManager(ConverterManager)	please use DefaultObjectDirectoryMapper.setConversionService(ConversionService) instead
org.springframework.ldap.pool.factory.PoolingContextSource.setContextSource(ContextSource)	Please provide the ContextSource in the constructor
org.springframework.ldap.pool2.factory.PooledContextSource.setContextSource(ContextSource)	Please provide the underlying ContextSource in the constructor
org.springframework.ldap.test.LdapTestUtils.destroyApacheDirectoryServer(String, String)	use LdapTestUtils.shutdownEmbeddedServer() instead.
org.springframework.ldap.test.LdapTestUtils.startApacheDirectoryServer(int, String, String, String, String)	use LdapTestUtils.startEmbeddedServer(int, String, String) instead.
org.springframework.ldap.test.LdapTestUtils.startApacheDirectoryServer(int, String, String, String, String, Set)	use LdapTestUtils.startEmbeddedServer(int, String, String) instead.
org.springframework.ldap.test.unboundid.EmbeddedLdapServer.newEmbeddedServer(String, String, int)	Use the builder pattern exposed via EmbeddedLdapServer.withPartitionSuffix(String) instead.
org.springframework.ldap.test.unboundid.EmbeddedLdapServer.shutdown()	Use EmbeddedLdapServer.close() instead.
org.springframework.ldap.transaction.compensating.manager.ContextSourceTransactionManager.setContextSource(ContextSource)	please provide the ContextSource in the constructor
org.springframework.ldap.transaction.compensating.manager.ContextSourceTransactionManagerDelegate.setContextSource(ContextSource)	please provide the ContextSource in the constructor

Deprecated Constructors

Constructor	Description
org.springframework.ldap.authentication.DefaultValuesAuthenticationSourceDecorator()	please provide needed values in the constructor
org.springframework.ldap.core.LdapEntryIdentification(DistinguishedName, DistinguishedName)	DistinguishedName and associated classes and methods are deprecated as of 2.0. use LdapEntryIdentification(javax.naming.ldap.LdapName, javax.naming.ldap.LdapName) instead.
org.springframework.ldap.filter.CompareFilter(String, int)	please use the protected constructor instead
org.springframework.ldap.filter.CompareFilter(String, String)	please use the protected constructor instead
org.springframework.ldap.pool.factory.PoolingContextSource()	Please provide the ContextSource in the constructor
org.springframework.ldap.pool2.factory.MutablePooledContextSource(PoolConfig)	Please supply the underlying ContextSource in the constructor
org.springframework.ldap.pool2.factory.PooledContextSource(PoolConfig)	Please provide the ContextSource in the constructor
org.springframework.ldap.transaction.compensating.manager.ContextSourceTransactionManager()	Please provide the ContextSource in the constructor
org.springframework.ldap.transaction.compensating.manager.ContextSourceTransactionManagerDelegate()	please provide the ContextSource in the constructor