org.nuxeo.ecm.directory
Interface Directory

All Known Implementing Classes:

AbstractDirectory, LDAPDirectory, LDAPDirectoryProxy, MemoryDirectory, MultiDirectory, SQLDirectory, SQLDirectoryProxy

public interface Directory

The directory interface.

This interface is implemented in order to create an NXDirectory. One should implement this interface in order to create either a new Directory implementation or a new Directory Source.

Author:

glefter@nuxeo.com

Method Summary

DirectoryCache	getCache() Gets the cache instance of the directory
String	getIdField() Gets the id field of the schema for this directory.
String	getName() Gets the unique name of the directory, used for registering.
String	getParentDirectory() Gets the name of the parent directory.
String	getPasswordField() Gets the password field of the schema for this directory.
Reference	getReference(String referenceFieldName) Lookup a Reference by field name.
Collection<Reference>	getReferences() Lookup all References defined on the directory.
String	getSchema() Gets the schema name used by this directory.
Session	getSession() Creates a session for accessing entries in this directory.
void	invalidateDirectoryCache() Invalidates the cache instance of the directory
void	shutdown() Shuts down the directory.

Method Detail

getName

String getName()
               throws DirectoryException

Gets the unique name of the directory, used for registering.

Returns:

the unique directory name

Throws:

DirectoryException

getSchema

String getSchema()
                 throws DirectoryException

Gets the schema name used by this directory.

Returns:

the schema name

Throws:

DirectoryException

getParentDirectory

String getParentDirectory()
                          throws DirectoryException

Gets the name of the parent directory. This is used for hierarchical vocabularies.

Returns:

the name of the parent directory, or null.

Throws:

DirectoryException

getIdField

String getIdField()
                  throws DirectoryException

Gets the id field of the schema for this directory.

Returns:

the id field.

Throws:

DirectoryException

getPasswordField

String getPasswordField()
                        throws DirectoryException

Gets the password field of the schema for this directory.

Returns:

the password field.

Throws:

DirectoryException

shutdown

void shutdown()
              throws DirectoryException

Shuts down the directory.

Throws:

DirectoryException

getSession

Session getSession()
                   throws DirectoryException

Creates a session for accessing entries in this directory.

Returns:

a Session object

Throws:

DirectoryException - if a session cannot be created

getReference

Reference getReference(String referenceFieldName)
                       throws DirectoryException

Lookup a Reference by field name.

Returns:

the matching reference implementation or null

Throws:

DirectoryException

getReferences

Collection<Reference> getReferences()
                                    throws DirectoryException

Lookup all References defined on the directory.

Returns:

all registered references

Throws:

DirectoryException

getCache

DirectoryCache getCache()
                        throws DirectoryException

Gets the cache instance of the directory

Returns:

the cache of the directory

Throws:

DirectoryException

invalidateDirectoryCache

void invalidateDirectoryCache()
                              throws DirectoryException

Invalidates the cache instance of the directory

Throws:

DirectoryException