Package org.opends.server.extensions

Class ExactMatchIdentityMapper

java.lang.Object

org.opends.server.api.IdentityMapper<ExactMatchIdentityMapperCfg>

org.opends.server.extensions.ExactMatchIdentityMapper

All Implemented Interfaces:

ConfigurationChangeListener<ExactMatchIdentityMapperCfg>

public class ExactMatchIdentityMapper
extends IdentityMapper<ExactMatchIdentityMapperCfg>
implements ConfigurationChangeListener<ExactMatchIdentityMapperCfg>

This class provides an implementation of a Directory Server identity mapper that looks for the exact value provided as the ID string to appear in an attribute of a user's entry. This mapper may be configured to look in one or more attributes using zero or more search bases. In order for the mapping to be established properly, exactly one entry must have an attribute that exactly matches (according to the equality matching rule associated with that attribute) the ID value.

Constructor Summary

Constructors

Constructor	Description
ExactMatchIdentityMapper()	Creates a new instance of this exact match identity mapper.

Method Summary

Modifier and Type	Method	Description
ConfigChangeResult	applyConfigurationChange(ExactMatchIdentityMapperCfg configuration)	Applies the configuration changes to this change listener.
void	finalizeIdentityMapper()	Performs any finalization that may be necessary for this identity mapper.
Entry	getEntryForID(String id)	Retrieves the user entry that was mapped to the provided identification string.
void	initializeIdentityMapper(ExactMatchIdentityMapperCfg configuration)	Initializes this identity mapper based on the information in the provided configuration entry.
boolean	isConfigurationAcceptable(IdentityMapperCfg configuration, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)	Indicates whether the provided configuration is acceptable for this identity mapper.
boolean	isConfigurationChangeAcceptable(ExactMatchIdentityMapperCfg configuration, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)	Indicates whether the proposed change to the configuration is acceptable to this change listener.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExactMatchIdentityMapper

public ExactMatchIdentityMapper()

Creates a new instance of this exact match identity mapper. All initialization should be performed in the initializeIdentityMapper method.

Method Detail

initializeIdentityMapper

public void initializeIdentityMapper(ExactMatchIdentityMapperCfg configuration)
                              throws ConfigException,
                                     InitializationException

Description copied from class: IdentityMapper

Initializes this identity mapper based on the information in the provided configuration entry.

Specified by:

initializeIdentityMapper in class IdentityMapper<ExactMatchIdentityMapperCfg>

Parameters:

configuration - The configuration for the identity mapper.

Throws:

ConfigException - If an unrecoverable problem arises in the process of performing the initialization.

InitializationException - If a problem occurs during initialization that is not related to the server configuration.

finalizeIdentityMapper

public void finalizeIdentityMapper()

Description copied from class: IdentityMapper

Performs any finalization that may be necessary for this identity mapper. By default, no finalization is performed.

Overrides:

finalizeIdentityMapper in class IdentityMapper<ExactMatchIdentityMapperCfg>

getEntryForID

public Entry getEntryForID(String id)
                    throws DirectoryException

Retrieves the user entry that was mapped to the provided identification string.

Specified by:

getEntryForID in class IdentityMapper<ExactMatchIdentityMapperCfg>

Parameters:

id - The identification string that is to be mapped to a user.

Returns:

The user entry that was mapped to the provided identification, or null if no users were found that could be mapped to the provided ID.

Throws:

DirectoryException - If a problem occurs while attempting to map the given ID to a user entry, or if there are multiple user entries that could map to the provided ID.

isConfigurationAcceptable

public boolean isConfigurationAcceptable(IdentityMapperCfg configuration,
                                         List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)

Description copied from class: IdentityMapper

Indicates whether the provided configuration is acceptable for this identity mapper. It should be possible to call this method on an uninitialized identity mapper instance in order to determine whether the identity mapper would be able to use the provided configuration.

Note that implementations which use a subclass of the provided configuration class will likely need to cast the configuration to the appropriate subclass type.

Overrides:

isConfigurationAcceptable in class IdentityMapper<ExactMatchIdentityMapperCfg>

Parameters:

configuration - The identity mapper configuration for which to make the determination.

unacceptableReasons - A list that may be used to hold the reasons that the provided configuration is not acceptable.

Returns:

true if the provided configuration is acceptable for this identity mapper, or false if not.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(ExactMatchIdentityMapperCfg configuration,
                                               List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)

Description copied from interface: ConfigurationChangeListener

Indicates whether the proposed change to the configuration is acceptable to this change listener.

Specified by:

isConfigurationChangeAcceptable in interface ConfigurationChangeListener<ExactMatchIdentityMapperCfg>

Parameters:

configuration - The new configuration containing the changes.

unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.

Returns:

Returns true if the proposed change is acceptable, or false if it is not.

applyConfigurationChange

public ConfigChangeResult applyConfigurationChange(ExactMatchIdentityMapperCfg configuration)

Description copied from interface: ConfigurationChangeListener

Applies the configuration changes to this change listener.

Specified by:

applyConfigurationChange in interface ConfigurationChangeListener<ExactMatchIdentityMapperCfg>

Parameters:

configuration - The new configuration containing the changes.

Returns:

Returns information about the result of changing the configuration.