org.ldaptive.beans.persistence

Class DefaultLdapEntryManager<T>

java.lang.Object

org.ldaptive.beans.persistence.DefaultLdapEntryManager<T>

Type Parameters:

T - type of object to manage

All Implemented Interfaces:

LdapEntryManager<T>

public class DefaultLdapEntryManager<T>
extends java.lang.Object
implements LdapEntryManager<T>

Default implementation of an ldap entry manager. Uses an LdapEntryMapper to convert objects to entries, then invokes LDAP operations with those objects. By default all attributes are requested using both the '*' and '+' syntaxes. For attributes that must be requested by name, use DefaultLdapEntryManager(LdapEntryMapper, ConnectionFactory, String[]).

Field Summary

Fields

Modifier and Type	Field and Description
private ConnectionFactory	connectionFactory Connection factory for LDAP communication.
private LdapEntryMapper<T>	ldapEntryMapper Mapper for converting ldap entry to object type.
protected org.slf4j.Logger	logger Logger for this class.
private java.lang.String[]	returnAttributes Additional attributes to include in searches.

Constructor Summary

Constructors

Constructor and Description
DefaultLdapEntryManager(LdapEntryMapper<T> mapper, ConnectionFactory factory) Creates a new default ldap entry manager.
DefaultLdapEntryManager(LdapEntryMapper<T> mapper, ConnectionFactory factory, java.lang.String[] attrs) Creates a new default ldap entry manager.

Method Summary

Modifier and Type	Method and Description
Response<java.lang.Void>	add(T object) Adds the supplied annotated object to an LDAP.
Response<java.lang.Void>	delete(T object) Deletes the supplied annotated object from an LDAP.
T	find(T object) Searches for the supplied annotated object in an LDAP and returns the object mapped with it's ldap attribute properties set.
ConnectionFactory	getConnectionFactory() Returns the connection factory.
LdapEntryMapper<T>	getLdapEntryMapper() Returns the ldap entry mapper.
java.lang.String[]	getReturnAttributes() Returns the return attributes.
Response<java.lang.Void>	merge(T object) Merges the supplied annotated object in an LDAP.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.slf4j.Logger logger

Logger for this class.

ldapEntryMapper

private final LdapEntryMapper<T> ldapEntryMapper

Mapper for converting ldap entry to object type.

connectionFactory

private final ConnectionFactory connectionFactory

Connection factory for LDAP communication.

returnAttributes

private final java.lang.String[] returnAttributes

Additional attributes to include in searches.

Constructor Detail

DefaultLdapEntryManager

public DefaultLdapEntryManager(LdapEntryMapper<T> mapper,
                               ConnectionFactory factory)

Creates a new default ldap entry manager.

Parameters:

mapper - for object conversion

factory - for LDAP communication

DefaultLdapEntryManager

public DefaultLdapEntryManager(LdapEntryMapper<T> mapper,
                               ConnectionFactory factory,
                               java.lang.String[] attrs)

Creates a new default ldap entry manager. Use of attrs is for cases where a directory does not support either the '*' or '+' syntaxes for returning all attributes of a given type.

Parameters:

mapper - for object conversion

factory - for LDAP communication

attrs - additional return attributes

Method Detail

getLdapEntryMapper

public LdapEntryMapper<T> getLdapEntryMapper()

Returns the ldap entry mapper.

Returns:

ldap entry mapper

getConnectionFactory

public ConnectionFactory getConnectionFactory()

Returns the connection factory.

Returns:

connection factory

getReturnAttributes

public java.lang.String[] getReturnAttributes()

Returns the return attributes.

Returns:

additional attributes to include in searches.

find

public T find(T object)
       throws LdapException

Description copied from interface: LdapEntryManager

Searches for the supplied annotated object in an LDAP and returns the object mapped with it's ldap attribute properties set.

Specified by:

find in interface LdapEntryManager<T>

Parameters:

object - to find

Returns:

mapped object

Throws:

LdapException - if the object cannot be found

add

public Response<java.lang.Void> add(T object)
                             throws LdapException

Description copied from interface: LdapEntryManager

Adds the supplied annotated object to an LDAP.

Specified by:

add in interface LdapEntryManager<T>

Parameters:

object - to add

Returns:

LDAP response from the add operation

Throws:

LdapException - if the add fails

merge

public Response<java.lang.Void> merge(T object)
                               throws LdapException

Description copied from interface: LdapEntryManager

Merges the supplied annotated object in an LDAP. See MergeOperation.

Specified by:

merge in interface LdapEntryManager<T>

Parameters:

object - to merge

Returns:

LDAP response from the merge operation

Throws:

LdapException - if the merge fails

delete

public Response<java.lang.Void> delete(T object)
                                throws LdapException

Description copied from interface: LdapEntryManager

Deletes the supplied annotated object from an LDAP.

Specified by:

delete in interface LdapEntryManager<T>

Parameters:

object - to delete

Returns:

LDAP response from the delete operation

Throws:

LdapException - if the delete fails