org.nuxeo.ecm.directory

Class DirectoryServiceImpl

java.lang.Object

org.nuxeo.runtime.model.DefaultComponent

org.nuxeo.ecm.directory.DirectoryServiceImpl

All Implemented Interfaces:

DirectoryService, Adaptable, Component, Extensible, TimestampedService

public class DirectoryServiceImpl
extends DefaultComponent
implements DirectoryService

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DELIMITER_BETWEEN_DIRECTORY_NAME_AND_SUFFIX
protected DirectoryFactoryRegistry	factories
protected DirectoryFactoryMapperRegistry	factoriesByDirectoryName

Fields inherited from class org.nuxeo.runtime.model.DefaultComponent

lastModified

Fields inherited from interface org.nuxeo.ecm.directory.api.DirectoryService

NAME

Constructor Summary

Constructors

Constructor and Description
DirectoryServiceImpl()

Method Summary

Modifier and Type	Method and Description
void	activate(ComponentContext context) Activates the component.
void	applicationStarted(ComponentContext context) Notify the component that Nuxeo Framework finished starting all Nuxeo bundles.
void	deactivate(ComponentContext context) Deactivates the component.
List<Directory>	getDirectories() Return all the directories registered into the service.
Directory	getDirectory(String directoryName) Return the directory with the name directoryName.
Directory	getDirectory(String name, DocumentModel documentContext) Return the directory for the specified context.
protected DirectoryConfiguration	getDirectoryConfiguration(DocumentModel documentContext)
String	getDirectoryIdField(String directoryName)
List<String>	getDirectoryNames()
String	getDirectoryPasswordField(String directoryName)
String	getDirectorySchema(String directoryName)
String	getParentDirectoryName(String directoryName) Returns the name of the parent directory of specified directory, if applicable.
protected String	getWaitingLocalDirectoryName(String directoryName, DirectoryConfiguration configuration) This will return the local directory name according the local configuration.
Session	open(String directoryName) Opens a session on specified directory.
Session	open(String directoryName, DocumentModel documentContext) Opens a session on the directory for the specified context.
void	registerDirectory(String directoryName, DirectoryFactory factory)
void	registerExtension(Extension extension) Registers the given extension.
void	unregisterDirectory(String directoryName, DirectoryFactory factory)
void	unregisterExtension(Extension extension) Unregisters the given extension.

Methods inherited from class org.nuxeo.runtime.model.DefaultComponent

getAdapter, getApplicationStartedOrder, getLastModified, registerContribution, setLastModified, setModifiedNow, unregisterContribution

Methods inherited from class java.lang.Object

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

Field Detail

DELIMITER_BETWEEN_DIRECTORY_NAME_AND_SUFFIX

protected static final String DELIMITER_BETWEEN_DIRECTORY_NAME_AND_SUFFIX

See Also:

Constant Field Values

factories

protected DirectoryFactoryRegistry factories

factoriesByDirectoryName

protected DirectoryFactoryMapperRegistry factoriesByDirectoryName

Constructor Detail

DirectoryServiceImpl

public DirectoryServiceImpl()

Method Detail

applicationStarted

public void applicationStarted(ComponentContext context)

Description copied from interface: Component

Notify the component that Nuxeo Framework finished starting all Nuxeo bundles.

Specified by:

applicationStarted in interface Component

Overrides:

applicationStarted in class DefaultComponent

getDirectoryConfiguration

protected DirectoryConfiguration getDirectoryConfiguration(DocumentModel documentContext)

getWaitingLocalDirectoryName

protected String getWaitingLocalDirectoryName(String directoryName,
                                              DirectoryConfiguration configuration)

This will return the local directory name according the local configuration. If the local configuration is null or the suffix value is null or the suffix value trimmed is an empty string the returned value is the directoryName given in parameter. If not this is directoryName + DELIMITER_BETWEEN_DIRECTORY_NAME_AND_SUFFIX + suffix. if directoryName is null, return null.

getDirectory

public Directory getDirectory(String directoryName)
                       throws DirectoryException

Description copied from interface: DirectoryService

Return the directory with the name directoryName.

If the directoryName is null, return null.

Specified by:

getDirectory in interface DirectoryService

Returns:

the directory, if the factory of the directory or the directory itself is not found return null

Throws:

DirectoryException

getDirectory

public Directory getDirectory(String name,
                              DocumentModel documentContext)
                       throws DirectoryException

Description copied from interface: DirectoryService

Return the directory for the specified context. The context is given by the document. The document service will try to find the directory local configuration of the document that will specify the suffix. The directory service will fetch the directoryName + suffix found. If no local configuration is found the service will return the directoryName directory.

If the directoryName is null, return null.

Specified by:

getDirectory in interface DirectoryService

Returns:

the directory, if the factory of the directory or the directory itself is not found return null

Throws:

DirectoryException

getDirectories

public List<Directory> getDirectories()
                               throws DirectoryException

Description copied from interface: DirectoryService

Return all the directories registered into the service.

Specified by:

getDirectories in interface DirectoryService

Throws:

DirectoryException

activate

public void activate(ComponentContext context)

Description copied from interface: Component

Activates the component.

This method is called by the runtime when a component is activated.

Specified by:

activate in interface Component

Overrides:

activate in class DefaultComponent

Parameters:

context - the runtime context

deactivate

public void deactivate(ComponentContext context)

Description copied from interface: Component

Deactivates the component.

This method is called by the runtime when a component is deactivated.

Specified by:

deactivate in interface Component

Overrides:

deactivate in class DefaultComponent

Parameters:

context - the runtime context

registerExtension

public void registerExtension(Extension extension)

Description copied from interface: Extensible

Registers the given extension.

Specified by:

registerExtension in interface Extensible

Overrides:

registerExtension in class DefaultComponent

Parameters:

extension - the extension to register

unregisterExtension

public void unregisterExtension(Extension extension)

Description copied from interface: Extensible

Unregisters the given extension.

Specified by:

unregisterExtension in interface Extensible

Overrides:

unregisterExtension in class DefaultComponent

Parameters:

extension - the extension to unregister

registerDirectory

public void registerDirectory(String directoryName,
                              DirectoryFactory factory)

Specified by:

registerDirectory in interface DirectoryService

unregisterDirectory

public void unregisterDirectory(String directoryName,
                                DirectoryFactory factory)

Specified by:

unregisterDirectory in interface DirectoryService

getDirectoryNames

public List<String> getDirectoryNames()
                               throws DirectoryException

Specified by:

getDirectoryNames in interface DirectoryService

Throws:

DirectoryException

getDirectorySchema

public String getDirectorySchema(String directoryName)
                          throws DirectoryException

Specified by:

getDirectorySchema in interface DirectoryService

Throws:

DirectoryException

getDirectoryIdField

public String getDirectoryIdField(String directoryName)
                           throws DirectoryException

Specified by:

getDirectoryIdField in interface DirectoryService

Throws:

DirectoryException

getDirectoryPasswordField

public String getDirectoryPasswordField(String directoryName)
                                 throws DirectoryException

Specified by:

getDirectoryPasswordField in interface DirectoryService

Throws:

DirectoryException

open

public Session open(String directoryName)
             throws DirectoryException

Description copied from interface: DirectoryService

Opens a session on specified directory.

This method prefers to throw rather than returning null.

Specified by:

open in interface DirectoryService

Returns:

the session

Throws:

DirectoryException - in case the session cannot be created

open

public Session open(String directoryName,
                    DocumentModel documentContext)
             throws DirectoryException

Description copied from interface: DirectoryService

Opens a session on the directory for the specified context. The context is given by the document. The document service will try to find the directory local configuration of the document that will specify the suffix. the directory will fetch the directoryName + suffix found. If no local configuration is found the service will return the directoryName directory.

This method prefers to throw rather than returning null.

Specified by:

open in interface DirectoryService

Returns:

the session

Throws:

DirectoryException - in case the session cannot be created

getParentDirectoryName

public String getParentDirectoryName(String directoryName)
                              throws DirectoryException

Description copied from interface: DirectoryService

Returns the name of the parent directory of specified directory, if applicable.

Specified by:

getParentDirectoryName in interface DirectoryService

Returns:

the name, or null

Throws:

DirectoryException