org.opends.server.extensions

Class UserDefinedVirtualAttributeProvider

java.lang.Object

org.opends.server.api.VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>

org.opends.server.extensions.UserDefinedVirtualAttributeProvider

All Implemented Interfaces:

ConfigurationChangeListener<UserDefinedVirtualAttributeCfg>

public class UserDefinedVirtualAttributeProvider
extends VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>
implements ConfigurationChangeListener<UserDefinedVirtualAttributeCfg>

This class implements a virtual attribute provider that allows administrators to define their own values that will be inserted into any entry that matches the criteria defined in the virtual attribute rule. This can be used to provide functionality like Class of Service (CoS) in the Sun Java System Directory Server.

Note: We will not allow searches based only on user-defined virtual attributes.

Constructor Summary

Constructors

Constructor and Description
UserDefinedVirtualAttributeProvider()

Method Summary

Modifier and Type	Method and Description
ConfigChangeResult	applyConfigurationChange(UserDefinedVirtualAttributeCfg configuration) Applies the configuration changes to this change listener.
void	finalizeVirtualAttributeProvider() Performs any finalization that may be necessary whenever this virtual attribute provider is taken out of service.
Attribute	getAttribute(Entry entry, AttributeDescription attrDesc) Generates an unmodifiable attribute with the values for the provided entry.
void	initializeVirtualAttributeProvider(UserDefinedVirtualAttributeCfg configuration) Initializes this virtual attribute based on the information in the provided configuration entry.
boolean	isConfigurationChangeAcceptable(UserDefinedVirtualAttributeCfg configuration, List<LocalizableMessage> unacceptableReasons) Indicates whether the proposed change to the configuration is acceptable to this change listener.
boolean	isMultiValued() Indicates whether this virtual attribute provider may generate multiple values.

Methods inherited from class org.opends.server.api.VirtualAttributeProvider

isConfigurationAcceptable, isSearchable, processSearch

Methods inherited from class java.lang.Object

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

Constructor Detail

UserDefinedVirtualAttributeProvider

public UserDefinedVirtualAttributeProvider()

Method Detail

initializeVirtualAttributeProvider

public void initializeVirtualAttributeProvider(UserDefinedVirtualAttributeCfg configuration)
                                        throws ConfigException,
                                               InitializationException

Description copied from class: VirtualAttributeProvider

Initializes this virtual attribute based on the information in the provided configuration entry.

Overrides:

initializeVirtualAttributeProvider in class VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>

Parameters:

configuration - The configuration to use to initialize this virtual attribute provider.

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.

finalizeVirtualAttributeProvider

public void finalizeVirtualAttributeProvider()

Description copied from class: VirtualAttributeProvider

Performs any finalization that may be necessary whenever this virtual attribute provider is taken out of service.

Overrides:

finalizeVirtualAttributeProvider in class VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>

isMultiValued

public boolean isMultiValued()

Description copied from class: VirtualAttributeProvider

Indicates whether this virtual attribute provider may generate multiple values.

Specified by:

isMultiValued in class VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>

Returns:

true if this virtual attribute provider may generate multiple values, or false if not.

getAttribute

public Attribute getAttribute(Entry entry,
                              AttributeDescription attrDesc)

Description copied from class: VirtualAttributeProvider

Generates an unmodifiable attribute with the values for the provided entry.

Specified by:

getAttribute in class VirtualAttributeProvider<UserDefinedVirtualAttributeCfg>

Parameters:

entry - The entry for which the values are to be generated.

attrDesc - the attribute description corresponding to this virtual attribute

Returns:

The unmodifiable attribute with the values generated for the provided entry. It may be empty, but it must not be null.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(UserDefinedVirtualAttributeCfg configuration,
                                               List<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<UserDefinedVirtualAttributeCfg>

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(UserDefinedVirtualAttributeCfg configuration)

Description copied from interface: ConfigurationChangeListener

Applies the configuration changes to this change listener.

Specified by:

applyConfigurationChange in interface ConfigurationChangeListener<UserDefinedVirtualAttributeCfg>

Parameters:

configuration - The new configuration containing the changes.

Returns:

Returns information about the result of changing the configuration.