# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

- Deprecated Interfaces
  Interface and Description
  org.springframework.ldap.core.support.BaseLdapPathAware `DistinguishedName` and associated classes and methods are deprecated as of 2.0. Use `BaseLdapNameAware` instead.
  org.springframework.ldap.core.DnParser `DistinguishedName` and associated classes are deprecated as of 2.0.
  org.springframework.ldap.odm.core.OdmManager This functionality is automatically available in LdapTemplate as of version 2.0
  org.springframework.ldap.core.simple.ParameterizedContextMapper Core classes are parameterized as of 2.0.
  org.springframework.ldap.core.simple.ParameterizedContextMapperWithControls use `ContextMapperWithControls` instead.
  org.springframework.ldap.ldif.batch.RecordCallbackHandler Use the support provided in Spring Batch infrastructure
  org.springframework.ldap.ldif.batch.RecordMapper Use the support provided in Spring Batch infrastructure
  org.springframework.ldap.core.simple.SimpleLdapOperations Core classes are parameterized as of 2.0.

- Deprecated Classes
  Class and Description
  org.springframework.ldap.core.simple.AbstractParameterizedContextMapper Core classes are parameterized as of 2.0.
  org.springframework.ldap.core.simple.ContextMapperCallbackHandlerWithControls use `ContextMapperCallbackHandlerWithControls` instead.
  org.springframework.ldap.transaction.compensating.manager.ContextSourceAndDataSourceTransactionManager The idea of wrapping two transaction managers without actual XA support is probably not such a good idea after all. AbstractPlatformTransactionManager is not designed for this usage.
  org.springframework.ldap.transaction.compensating.manager.ContextSourceAndHibernateTransactionManager The idea of wrapping two transaction managers without actual XA support is probably not such a good idea after all. AbstractPlatformTransactionManager is not designed for this usage.
  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.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.ldif.batch.LdifAggregator Use the support provided in Spring Batch infrastructure Specifically see org.springframework.batch.item.file.transform.PassThroughLineAggregator
  org.springframework.ldap.ldif.batch.LdifReader Use the support provided in Spring Batch infrastructure
  org.springframework.ldap.ldif.batch.MappingLdifReader Use the support provided in Spring Batch infrastructure
  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.control.PagedResult
  org.springframework.ldap.control.PagedResultsRequestControl Use PagedResultsDirContextProcessor instead.
  org.springframework.ldap.core.simple.SimpleLdapTemplate Core classes are parameterized as of 2.0.

- Deprecated Fields
  Field and Description
  org.springframework.ldap.core.support.DefaultDirObjectFactory.JNDI_ENV_BASE_PATH_KEY Use `BaseLdapNameAware` and `BaseLdapPathBeanPostProcessor` instead.
  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

- Deprecated Methods
  Method and Description
  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.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.test.LdapTestUtils.destroyApacheDirectoryServer(String, String) use `LdapTestUtils.shutdownEmbeddedServer()` instead.
  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.support.BaseLdapPathSource.getBaseLdapPath() `DistinguishedName` and associated classes and methods are deprecated as of 2.0. Use `BaseLdapPathSource.getBaseLdapName()` instead.
  org.springframework.ldap.core.support.AbstractContextSource.getBaseLdapPath() `DistinguishedName` and associated classes and methods are deprecated as of 2.0.
  org.springframework.ldap.core.SimpleCharStream.getColumn()
  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.SimpleCharStream.getLine()
  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.support.BaseLdapPathBeanPostProcessor.setBasePath(DistinguishedName) `DistinguishedName` and associated classes and methods are deprecated as of 2.0.
  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.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.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.

- Deprecated Constructors
  Constructor and Description
  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.