Spring LDAP Framework

org.springframework.ldap.core
Interface ContextSource

All Known Subinterfaces:
BaseLdapPathContextSource
All Known Implementing Classes:
AbstractContextSource, DirContextSource, LdapContextSource, MutablePoolingContextSource, PoolingContextSource, SingleContextSource, TransactionAwareContextSourceProxy

public interface ContextSource

A ContextSource is responsible for configuring and creating DirContext instances. It is typically used from LdapTemplate to acquiring contexts for LDAP operations, but may be used standalone to perform LDAP authentication.

Author:
Adam Skogman, Mattias Hellborg Arthursson
See Also:
LdapTemplate

Method Summary
 DirContext getContext(String principal, String credentials)
          Gets a DirContext instance authenticated using the supplied principal and credentials.
 DirContext getReadOnlyContext()
          Gets a read-only DirContext.
 DirContext getReadWriteContext()
          Gets a read-write DirContext instance.
 

Method Detail

getReadOnlyContext

DirContext getReadOnlyContext()
                              throws NamingException
Gets a read-only DirContext. The returned DirContext must be possible to perform read-only operations on.

Returns:
A DirContext instance, never null.
Throws:
NamingException - if some error occurs creating an DirContext.

getReadWriteContext

DirContext getReadWriteContext()
                               throws NamingException
Gets a read-write DirContext instance.

Returns:
A DirContext instance, never null.
Throws:
NamingException - if some error occurs creating an DirContext.

getContext

DirContext getContext(String principal,
                      String credentials)
                      throws NamingException
Gets a DirContext instance authenticated using the supplied principal and credentials.

Parameters:
principal - The principal (typically a distinguished name of a user in the LDAP tree) to use for authentication.
credentials - The credentials to use for authentication.
Returns:
an authenticated DirContext instance, never null.
Throws:
NamingException
Since:
1.3

Spring LDAP Framework

Copyright © 2005-2010 The Spring LDAP Framework. All Rights Reserved.