org.picketlink.idm.ldap.internal

Class LDAPOperationManager

java.lang.Object

org.picketlink.idm.ldap.internal.LDAPOperationManager

public class LDAPOperationManager
extends Object

This class provides a set of operations to manage LDAP trees.

A different LdapContext is used to perform authentication. The reason is that while managing the ldap tree information bindings are not allowed. Also, instead of creating a new LdapContext each time we reuse it.

TODO: See how to handle context pools and a better fail-over support.

Author:

Anil Saldhana, Pedro Silva

Constructor Summary

Constructors

Constructor and Description
LDAPOperationManager(LDAPIdentityStoreConfiguration config)

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttribute(String dn, Attribute attribute) Adds the given Attribute instance using the given DN.
boolean	authenticate(String dn, String password) Performs a simple authentication using the ginve DN and password to bind to the authentication context.
boolean	checkAttributePresence(String attributeName) Ask the ldap server for the schema for the attribute.
void	createSubContext(String name, Attributes attributes)
String	decodeEntryUUID(Object entryUUID)
void	destroySubcontext(String dn) Destroys a subcontext with the given DN from the LDAP tree.
Attributes	getAttributes(String entryUUID, String baseDN, LDAPMappingConfiguration mappingConfiguration)
String	getFilterById(String baseDN, String id)
boolean	isManagedAttribute(String attributeName) Checks if the attribute with the given name is a managed attributes.
<T> T	lookup(String dn) Looks up a entry on the LDAP tree with the given DN.
NamingEnumeration<SearchResult>	lookupById(String baseDN, String id, LDAPMappingConfiguration mappingConfiguration)
void	modifyAttribute(String dn, Attribute attribute) Modifies the given Attribute instance using the given DN.
void	removeAttribute(String dn, Attribute attribute) Removes the given Attribute instance using the given DN.
<T> List<T>	removeEntryById(String baseDN, String id) Searches the LDAP tree.
NamingEnumeration<SearchResult>	search(String baseDN, String filter, LDAPMappingConfiguration mappingConfiguration)

Methods inherited from class java.lang.Object

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

Constructor Detail

LDAPOperationManager

public LDAPOperationManager(LDAPIdentityStoreConfiguration config)
                     throws NamingException

Throws:

NamingException

Method Detail

modifyAttribute

public void modifyAttribute(String dn,
                   Attribute attribute)

Modifies the given Attribute instance using the given DN. This method performs a REPLACE_ATTRIBUTE operation.

Parameters:

dn -

attribute -

removeAttribute

public void removeAttribute(String dn,
                   Attribute attribute)

Removes the given Attribute instance using the given DN. This method performs a REMOVE_ATTRIBUTE operation.

Parameters:

dn -

attribute -

addAttribute

public void addAttribute(String dn,
                Attribute attribute)

Adds the given Attribute instance using the given DN. This method performs a ADD_ATTRIBUTE operation.

Parameters:

dn -

attribute -

lookup

public <T> T lookup(String dn)

Looks up a entry on the LDAP tree with the given DN.

Parameters:

dn -

Returns:

Throws:

NamingException

removeEntryById

public <T> List<T> removeEntryById(String baseDN,
                          String id)

Searches the LDAP tree.

Parameters:

baseDN -

attributesToSearch -

Returns:

search

public NamingEnumeration<SearchResult> search(String baseDN,
                                     String filter,
                                     LDAPMappingConfiguration mappingConfiguration)
                                       throws NamingException

Throws:

NamingException

getFilterById

public String getFilterById(String baseDN,
                   String id)

lookupById

public NamingEnumeration<SearchResult> lookupById(String baseDN,
                                         String id,
                                         LDAPMappingConfiguration mappingConfiguration)

destroySubcontext

public void destroySubcontext(String dn)

Destroys a subcontext with the given DN from the LDAP tree.

Parameters:

dn -

isManagedAttribute

public boolean isManagedAttribute(String attributeName)

Checks if the attribute with the given name is a managed attributes. Managed attributes are the ones defined in the underlying schema or those defined in the managed attribute list.

Parameters:

attributeName -

Returns:

checkAttributePresence

public boolean checkAttributePresence(String attributeName)

Ask the ldap server for the schema for the attribute.

Parameters:

attributeName -

Returns:

authenticate

public boolean authenticate(String dn,
                   String password)

Performs a simple authentication using the ginve DN and password to bind to the authentication context.

Parameters:

dn -

password -

Returns:

createSubContext

public void createSubContext(String name,
                    Attributes attributes)

getAttributes

public Attributes getAttributes(String entryUUID,
                       String baseDN,
                       LDAPMappingConfiguration mappingConfiguration)

decodeEntryUUID

public String decodeEntryUUID(Object entryUUID)