org.nuxeo.ecm.directory.ldap

Class LDAPDirectory

java.lang.Object

org.nuxeo.ecm.directory.AbstractDirectory

org.nuxeo.ecm.directory.ldap.LDAPDirectory

All Implemented Interfaces:

Directory

public class LDAPDirectory
extends AbstractDirectory

Implementation of the Directory interface for servers implementing the Lightweight Directory Access Protocol.

Author:

ogrisel, Robert Browning

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LDAPDirectory.TrustingSSLSocketFactory SSLSocketFactory implementation that verifies all certificates.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	baseFilter
protected Properties	contextProperties
static String	DN_SPECIAL_ATTRIBUTE_KEY
protected LDAPDirectoryFactory	factory
protected SearchControls	searchControls
protected ContextProvider	testServer

Fields inherited from class org.nuxeo.ecm.directory.AbstractDirectory

cache, descriptor, fieldMapper, referenceClass, references, registry, schemaFieldMap, sessionCount, sessionMaxCount, types

Constructor Summary

Constructors

Constructor and Description
LDAPDirectory(LDAPDirectoryDescriptor descriptor)

Method Summary

Modifier and Type	Method and Description
protected Properties	computeContextProperties()
protected SearchControls	computeSearchControls() Search controls that only fetch attributes defined by the schema
protected DirContext	createContext()
String	getBaseFilter()
Properties	getContextProperties()
LDAPDirectoryDescriptor	getDescriptor() Get descriptor
List<Reference>	getReferences(String referenceFieldName) Lookup the References by field name.
SearchControls	getSearchControls()
SearchControls	getSearchControls(boolean fetchAllAttributes)
LDAPServerDescriptor	getServer()
Session	getSession() Creates a session for accessing entries in this directory.
protected ContextProvider	getTestServer()
protected void	initLDAPConfig()
protected void	initLDAPConfigIfNeeded()
protected void	setSystemProperty(String key, String value) Sets a System property, except if it's already set, to allow for external configuration.
void	setTestServer(ContextProvider testServer)

Methods inherited from class org.nuxeo.ecm.directory.AbstractDirectory

addInverseReferences, addReference, addReferences, addReferences, addSession, doSanityChecks, fallbackOnDefaultCache, getCache, getDirectoryDeleteConstraints, getFieldMapper, getIdField, getName, getParentDirectory, getPasswordField, getReference, getReferences, getSchema, getSchemaFieldMap, getTypes, initSchemaFieldMap, invalidateCaches, invalidateDirectoryCache, isMultiTenant, isReadOnly, isReference, orderEntries, removeSession, setReadOnly, shutdown

Methods inherited from class java.lang.Object

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

Field Detail

DN_SPECIAL_ATTRIBUTE_KEY

public static final String DN_SPECIAL_ATTRIBUTE_KEY

See Also:

Constant Field Values

contextProperties

protected Properties contextProperties

searchControls

protected volatile SearchControls searchControls

factory

protected final LDAPDirectoryFactory factory

baseFilter

protected String baseFilter

testServer

protected ContextProvider testServer

Constructor Detail

LDAPDirectory

public LDAPDirectory(LDAPDirectoryDescriptor descriptor)

Method Detail

getDescriptor

public LDAPDirectoryDescriptor getDescriptor()

Description copied from interface: Directory

Get descriptor

getReferences

public List<Reference> getReferences(String referenceFieldName)

Description copied from interface: Directory

Lookup the References by field name.

Specified by:

getReferences in interface Directory

Overrides:

getReferences in class AbstractDirectory

Returns:

the matching references implementation or null

initLDAPConfigIfNeeded

protected void initLDAPConfigIfNeeded()

initLDAPConfig

protected void initLDAPConfig()

computeContextProperties

protected Properties computeContextProperties()
                                       throws DirectoryException

Returns:

connection parameters to use for all LDAP queries

Throws:

DirectoryException

setSystemProperty

protected void setSystemProperty(String key,
                                 String value)

Sets a System property, except if it's already set, to allow for external configuration.

getContextProperties

public Properties getContextProperties()

computeSearchControls

protected SearchControls computeSearchControls()
                                        throws DirectoryException

Search controls that only fetch attributes defined by the schema

Returns:

common search controls to use for all LDAP search queries

Throws:

DirectoryException

getSearchControls

public SearchControls getSearchControls()

getSearchControls

public SearchControls getSearchControls(boolean fetchAllAttributes)

createContext

protected DirContext createContext()
                            throws DirectoryException

Throws:

DirectoryException

getServer

public LDAPServerDescriptor getServer()

Returns:

ldap server descriptor bound to this directory

Since:

5.7

getSession

public Session getSession()
                   throws DirectoryException

Description copied from interface: Directory

Creates a session for accessing entries in this directory.

Returns:

a Session object

Throws:

DirectoryException - if a session cannot be created

getBaseFilter

public String getBaseFilter()

getTestServer

protected ContextProvider getTestServer()

setTestServer

public void setTestServer(ContextProvider testServer)