org.springframework.ldap.core.support
Class SingleContextSource

java.lang.Object
  org.springframework.ldap.core.support.SingleContextSource

All Implemented Interfaces:

org.springframework.beans.factory.DisposableBean, ContextSource

public class SingleContextSource
extends java.lang.Object
implements ContextSource, org.springframework.beans.factory.DisposableBean

A ContextSource to be used as a decorator around a target ContextSource to make sure the target is never actually closed. Useful when working with e.g. paged results, as these require the same target to be used.

Author:

Mattias Hellborg Arthursson

Nested Class Summary

static class

SingleContextSource.NonClosingDirContextInvocationHandler A proxy for DirContext forwarding all operation to the target DirContext, but making sure that no close operations will be performed.

Constructor Summary

SingleContextSource(javax.naming.directory.DirContext ctx)
Constructor.

Method Summary

void	destroy() Destroy method that allows the target DirContext to be cleaned up when the SingleContextSource is not going to be used any more.
javax.naming.directory.DirContext	getContext(java.lang.String principal, java.lang.String credentials) Gets a DirContext instance authenticated using the supplied principal and credentials.
javax.naming.directory.DirContext	getReadOnlyContext() Gets a read-only DirContext.
javax.naming.directory.DirContext	getReadWriteContext() Gets a read-write DirContext instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SingleContextSource

public SingleContextSource(javax.naming.directory.DirContext ctx)

Constructor.

Parameters:

ctx - the target DirContext.

Method Detail

getReadOnlyContext

public javax.naming.directory.DirContext getReadOnlyContext()
                                                     throws NamingException

Description copied from interface: ContextSource

Gets a read-only DirContext. The returned DirContext must be possible to perform read-only operations on.

Specified by:

getReadOnlyContext in interface ContextSource

Returns:

A DirContext instance, never null.

Throws:

NamingException - if some error occurs creating an DirContext.

getReadWriteContext

public javax.naming.directory.DirContext getReadWriteContext()
                                                      throws NamingException

Description copied from interface: ContextSource

Gets a read-write DirContext instance.

Specified by:

getReadWriteContext in interface ContextSource

Returns:

A DirContext instance, never null.

Throws:

NamingException - if some error occurs creating an DirContext.

getContext

public javax.naming.directory.DirContext getContext(java.lang.String principal,
                                                    java.lang.String credentials)
                                             throws NamingException

Description copied from interface: ContextSource

Gets a DirContext instance authenticated using the supplied principal and credentials.

Specified by:

getContext in interface ContextSource

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

destroy

public void destroy()

Destroy method that allows the target DirContext to be cleaned up when the SingleContextSource is not going to be used any more.

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean