com.jalios.ldap

Class LDAPMapper

java.lang.Object

com.jalios.ldap.LDAPMapper

public class LDAPMapper
extends java.lang.Object

This class allows simpler access to LDAP using following ldap properties. It is not thread safe, use one LDAPMapper instance per thread.

Since:

jcms-4.1.1-SP4 / jcms-5.5.0

Author:

Olivier Jaquemet

Field Summary

Fields

Modifier and Type	Field and Description
protected LDAPConfiguration	conf
static java.lang.String	END_OF_RANGE The character indicating that the end of the range has been reached.
protected boolean	isConnected
protected netscape.ldap.LDAPException	lastException
protected netscape.ldap.LDAPConnection	ldc
static java.lang.String	RANGE_FORMAT The format used to calculate attribute IDs for subsequent searches.
static java.util.regex.Pattern	RANGE_PATTERN The pattern matching the range attribute ID.
static java.lang.String	RANGE_PATTERN_STRING The expression matching the range attribute ID ";range=-".
static java.lang.String	REVISION
protected boolean	supportsVLV
protected boolean	supportsVLVinitialized

Constructor Summary

Constructors

Constructor and Description
LDAPMapper(LDAPConfiguration conf) Creates a new mapper and establish the connection using given LDAPConfiguration.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	authenticate(java.lang.String dn, java.lang.String password) Try to establish a new connection and to authenticate to the ldap server specified in the LDAPConfiguration of this mapper, using the given dn connect and password.
void	disconnect() Disconnect the underlying LDAPConnection of this mapper.
netscape.ldap.LDAPEntry	getGroupLDAPEntryFromDN(java.lang.String fullDN, java.lang.String[] attrs) Retrieve a Group entry from its exact DN.
java.util.ArrayList<netscape.ldap.LDAPEntry>	getGroupsLDAPEntries(java.lang.String dn, java.lang.String[] attrs) Return the groups LDAP Entry for the given dn (dn of a user or a sub-group).
netscape.ldap.LDAPException	getLastException()
LDAPConfiguration	getLDAPConfiguration() Retrieve the LDAPConfiguration object associated to this Mapper.
netscape.ldap.LDAPConnection	getLDAPConnection() Returns the LDAPConnection instance initialized during the construction of this LDAPMapper.
java.util.ArrayList<netscape.ldap.LDAPEntry>	getMatchingLDAPEntries(java.lang.String baseDN, java.lang.String searchFilter, java.lang.String[] attrs) Return the matching LDAP Entries.
java.util.List<netscape.ldap.LDAPEntry>	getMatchingLDAPEntriesVLV(java.lang.String baseDN, java.lang.String searchFilter, java.lang.String ldapSortKey, java.lang.String[] attrs) Return the matching LDAP Entries, using Virtual List View control if possible.
java.util.List<java.lang.String>	getRangedAttributeStringValues(netscape.ldap.LDAPEntry entry, java.lang.String attributeName) Retrieve all values of the specified attribute, even if attribute is a ranged attribute of ActiveDirectory.
netscape.ldap.LDAPEntry	getUserLDAPEntry(java.lang.String login, java.lang.String[] attrs) Return the first matching LDAP Entry for the given login.
netscape.ldap.LDAPEntry	getUserLDAPEntryFromDN(java.lang.String fullDN, java.lang.String[] attrs) Retrieve a User entry from its exact DN.
boolean	isConnected()

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final java.lang.String REVISION

See Also:

Constant Field Values

conf

protected final LDAPConfiguration conf

ldc

protected final netscape.ldap.LDAPConnection ldc

isConnected

protected boolean isConnected

lastException

protected netscape.ldap.LDAPException lastException

supportsVLVinitialized

protected boolean supportsVLVinitialized

supportsVLV

protected boolean supportsVLV

END_OF_RANGE

public static final java.lang.String END_OF_RANGE

The character indicating that the end of the range has been reached.

See Also:

Constant Field Values

RANGE_FORMAT

public static final java.lang.String RANGE_FORMAT

The format used to calculate attribute IDs for subsequent searches.

See Also:

Constant Field Values

RANGE_PATTERN_STRING

public static final java.lang.String RANGE_PATTERN_STRING

The expression matching the range attribute ID ";range=-".

See Also:

Constant Field Values

RANGE_PATTERN

public static final java.util.regex.Pattern RANGE_PATTERN

The pattern matching the range attribute ID.

Constructor Detail

LDAPMapper

public LDAPMapper(LDAPConfiguration conf)

Creates a new mapper and establish the connection using given LDAPConfiguration.
IMPORTANT: Don't forget to call disconnect() when finished with this mapper.
If an error occurs during connection, the LDAPException describing the error is accessible using getLastException()

Parameters:

conf - the LDAPConfiguration to use for this mapper

Method Detail

getUserLDAPEntry

public netscape.ldap.LDAPEntry getUserLDAPEntry(java.lang.String login,
                                       java.lang.String[] attrs)

Return the first matching LDAP Entry for the given login.
Uses : - LDAPConfiguration.getSuffix() (search baseDN) - LDAPConfiguration.getUserFilter() (search filter)

Parameters:

login - the login of the member of which to retrieve LDAPEntry.

attrs - attributes you want returned in the result.

Returns:

the first LDAPEntry retrieved from LDAP, or null if member is not found or if an error occured (in which case getLastException(). A warning message is logged if more than one entries have been found (in which case you should refine your user search filter).

Since:

jcms-5.7.0

getUserLDAPEntryFromDN

public netscape.ldap.LDAPEntry getUserLDAPEntryFromDN(java.lang.String fullDN,
                                             java.lang.String[] attrs)

Retrieve a User entry from its exact DN.

This method differs from the LDAPConnection.read(String, String[]) because it will apply the user filter configured in JCMS (LDAPConfiguration.getUserFilter()

Parameters:

fullDN - the DN of the User entry to retrieve

attrs - attributes you want returned in the result entry.

Returns:

the LDAPEntry retrieved from LDAP, null if LDAP entry could not be found. Also returns null if several entries were found, this prevents invalid behavior if bad DN is specified (a warning is issued in the logs)

Since:

jcms-7.0

getGroupsLDAPEntries

public java.util.ArrayList<netscape.ldap.LDAPEntry> getGroupsLDAPEntries(java.lang.String dn,
                                                                java.lang.String[] attrs)

Return the groups LDAP Entry for the given dn (dn of a user or a sub-group).
Uses : - LDAPConfiguration.getGroupSuffix() (search baseDN) - LDAPConfiguration.getGroupFilter() (search filter)

Parameters:

dn - the dn of the user of which to retrieve groups' LDAPEntry.

attrs - attributes you want returned in the result.

Returns:

a list of LDAPEntry retrieved from LDAP, or null if no group is found or if an error occured (in which case getLastException().

Since:

jcms-5.7.0

getGroupLDAPEntryFromDN

public netscape.ldap.LDAPEntry getGroupLDAPEntryFromDN(java.lang.String fullDN,
                                              java.lang.String[] attrs)

Retrieve a Group entry from its exact DN.

This method differs from the LDAPConnection.read(String, String[]) because it will apply the group filter configured in JCMS (LDAPConfiguration.getGroupFilter()

Parameters:

fullDN - the DN of the Group entry to retrieve

attrs - attributes you want returned in the result entry.

Returns:

the LDAPEntry retrieved from LDAP, null if LDAP entry could not be found. Also returns null if several entries were found, this prevents invalid behavior if bad DN is specified (a warning is issued in the logs)

Since:

jcms-7.0

getMatchingLDAPEntries

public java.util.ArrayList<netscape.ldap.LDAPEntry> getMatchingLDAPEntries(java.lang.String baseDN,
                                                                  java.lang.String searchFilter,
                                                                  java.lang.String[] attrs)

Return the matching LDAP Entries. (uses the LDAPConfiguration suffix (search baseDN) and user filter (search filter)).
Does not return entries that may be available on referals servers.

Parameters:

baseDN - the base distinguished name from which to search

searchFilter - the searchFilter to use for with method LDAPConnection.search(String, int, String, String[], boolean).

attrs - attributes you want returned in the result.

Returns:

an ArrayList of LDAPEntry retrieved from LDAP, (never return null), LDAPException is available using getLastException() if error occured during search.

Since:

jcms-5.7.0

getMatchingLDAPEntriesVLV

public java.util.List<netscape.ldap.LDAPEntry> getMatchingLDAPEntriesVLV(java.lang.String baseDN,
                                                                java.lang.String searchFilter,
                                                                java.lang.String ldapSortKey,
                                                                java.lang.String[] attrs)

Return the matching LDAP Entries, using Virtual List View control if possible.

The Virtual List View allow retrieve of ALL LDAP entries without any limitation from the server.

This method does not return entries that may be available on referals servers.

Parameters:

baseDN - the base distinguished name from which to search

searchFilter - the searchFilter to use for with method LDAPConnection.search(String, int, String, String[], boolean).

ldapSortKey - the LDAP attribute to use for sorting of LDAP entry (required for use of VLV control), eg "cn"

attrs - attributes you want returned in the result.

Returns:

an ArrayList of LDAPEntry retrieved from LDAP, or null if VLV is not supported by remote server, LDAPException is available using getLastException() if error occured during search.

Since:

jcms-8.0.1

getRangedAttributeStringValues

public java.util.List<java.lang.String> getRangedAttributeStringValues(netscape.ldap.LDAPEntry entry,
                                                              java.lang.String attributeName)

Retrieve all values of the specified attribute, even if attribute is a ranged attribute of ActiveDirectory.

If the specified attribute is a ranged attribute of ActiveDirectory, perform the appropriate computation and new LDAP queries to ensure all attribute's values are retrieved.

See Range Retrieval of Attribute Values at Microsoft.com

Parameters:

entry - the entry in which LDAPAttribute was retrieved (must not be null)

attributeName - the name of the attribute to retrieve (must not be null, may be ranged or not)

Returns:

a List of all String values of the specified attribute, never return null

authenticate

public boolean authenticate(java.lang.String dn,
                   java.lang.String password)

Try to establish a new connection and to authenticate to the ldap server specified in the LDAPConfiguration of this mapper, using the given dn connect and password. Disconnect immediately.

Parameters:

dn - the dn to use to try au

password - the password to use for authentication.

Returns:

true if authentication succeeded, false otherwise, in which case the error is available using getLastException()

getLDAPConfiguration

public LDAPConfiguration getLDAPConfiguration()

Retrieve the LDAPConfiguration object associated to this Mapper.

Returns:

an instance of LDAPConfiguration, never return null.

getLastException

public netscape.ldap.LDAPException getLastException()

Returns:

Returns the last LDAPException thrown during an operation.

getLDAPConnection

public netscape.ldap.LDAPConnection getLDAPConnection()

Returns the LDAPConnection instance initialized during the construction of this LDAPMapper.
Before using this method, you can check that the connection has been properly established using isConnected().
You should not disconnect using the LDAPConnection.disconnect() method of the returned LDAPConnection object, instead, call the disconnect() method of this LDAPMapper.

Returns:

Returns the LDAPConnection instance used by this LDAPMapper.

isConnected

public boolean isConnected()

Returns:

true if this a successful LDAP Connection was establish in constructor of this mapper.

disconnect

public void disconnect()

Disconnect the underlying LDAPConnection of this mapper.