org.opends.server.plugins
Class LastModPlugin

java.lang.Object
  extended by org.opends.server.api.plugin.DirectoryServerPlugin<LastModPluginCfg>
      extended by org.opends.server.plugins.LastModPlugin
All Implemented Interfaces:
ConfigurationChangeListener<LastModPluginCfg>

public final class LastModPlugin
extends DirectoryServerPlugin<LastModPluginCfg>
implements ConfigurationChangeListener<LastModPluginCfg>

This class implements a Directory Server plugin that will add the creatorsName and createTimestamp attributes to an entry whenever it is added to the server, and will add the modifiersName and modifyTimestamp attributes whenever the entry is modified or renamed.


Constructor Summary
LastModPlugin()
          Creates a new instance of this Directory Server plugin.
 
Method Summary
 ConfigChangeResult applyConfigurationChange(LastModPluginCfg configuration)
          Applies the configuration changes to this change listener.
 PluginResult.PreOperation doPreOperation(PreOperationAddOperation addOperation)
          Performs any necessary processing that should be done just before the Directory Server performs the core processing for an add operation.
 PluginResult.PreOperation doPreOperation(PreOperationModifyDNOperation modifyDNOperation)
          Performs any necessary processing that should be done just before the Directory Server performs the core processing for a modify DN operation.
 PluginResult.PreOperation doPreOperation(PreOperationModifyOperation modifyOperation)
          Performs any necessary processing that should be done just before the Directory Server performs the core processing for a modify operation.
 void finalizePlugin()
          Performs any necessary finalization for this plugin.
 void initializePlugin(java.util.Set<PluginType> pluginTypes, LastModPluginCfg configuration)
          Performs any initialization necessary for this plugin.
 boolean isConfigurationAcceptable(PluginCfg configuration, java.util.List<Message> unacceptableReasons)
          Indicates whether the provided configuration is acceptable for this plugin.
 boolean isConfigurationChangeAcceptable(LastModPluginCfg configuration, java.util.List<Message> unacceptableReasons)
          Indicates whether the proposed change to the configuration is acceptable to this change listener.
 
Methods inherited from class org.opends.server.api.plugin.DirectoryServerPlugin
doLDIFExport, doLDIFImport, doPostConnect, doPostDisconnect, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostOperation, doPostResponse, doPostResponse, doPostResponse, doPostResponse, doPostResponse, doPostResponse, doPostResponse, doPostResponse, doPostSynchronization, doPostSynchronization, doPostSynchronization, doPostSynchronization, doPreOperation, doPreOperation, doPreOperation, doPreOperation, doPreOperation, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doPreParse, doShutdown, doStartup, getPluginEntryDN, getPluginTypes, initializeInternal, invokeForInternalOperations, processIntermediateResponse, processSearchEntry, processSearchReference, processSubordinateModifyDN, setInvokeForInternalOperations
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LastModPlugin

public LastModPlugin()
Creates a new instance of this Directory Server plugin. Every plugin must implement a default constructor (it is the only one that will be used to create plugins defined in the configuration), and every plugin constructor must call super() as its first element.

Method Detail

initializePlugin

public final void initializePlugin(java.util.Set<PluginType> pluginTypes,
                                   LastModPluginCfg configuration)
                            throws ConfigException
Performs any initialization necessary for this plugin. This will be called as soon as the plugin has been loaded and before it is registered with the server.

Specified by:
initializePlugin in class DirectoryServerPlugin<LastModPluginCfg>
Parameters:
pluginTypes - The set of plugin types that indicate the ways in which this plugin will be invoked.
configuration - The configuration for this plugin.
Throws:
ConfigException - If the provided entry does not contain a valid configuration for this plugin.

finalizePlugin

public final void finalizePlugin()
Performs any necessary finalization for this plugin. This will be called just after the plugin has been deregistered with the server but before it has been unloaded.

Overrides:
finalizePlugin in class DirectoryServerPlugin<LastModPluginCfg>

doPreOperation

public final PluginResult.PreOperation doPreOperation(PreOperationAddOperation addOperation)
Performs any necessary processing that should be done just before the Directory Server performs the core processing for an add operation. This method is not called when processing synchronization operations.

Overrides:
doPreOperation in class DirectoryServerPlugin<LastModPluginCfg>
Parameters:
addOperation - The add operation to be processed.
Returns:
Information about the result of the plugin processing.

doPreOperation

public final PluginResult.PreOperation doPreOperation(PreOperationModifyOperation modifyOperation)
Performs any necessary processing that should be done just before the Directory Server performs the core processing for a modify operation. This method is not called when processing synchronization operations.

Overrides:
doPreOperation in class DirectoryServerPlugin<LastModPluginCfg>
Parameters:
modifyOperation - The modify operation to be processed.
Returns:
Information about the result of the plugin processing.

doPreOperation

public final PluginResult.PreOperation doPreOperation(PreOperationModifyDNOperation modifyDNOperation)
Performs any necessary processing that should be done just before the Directory Server performs the core processing for a modify DN operation. This method is not called when processing synchronization operations.

Overrides:
doPreOperation in class DirectoryServerPlugin<LastModPluginCfg>
Parameters:
modifyDNOperation - The modify DN operation to be processed.
Returns:
Information about the result of the plugin processing.

isConfigurationAcceptable

public boolean isConfigurationAcceptable(PluginCfg configuration,
                                         java.util.List<Message> unacceptableReasons)
Indicates whether the provided configuration is acceptable for this plugin. It should be possible to call this method on an uninitialized plugin instance in order to determine whether the plugin would be able to use the provided configuration.

Overrides:
isConfigurationAcceptable in class DirectoryServerPlugin<LastModPluginCfg>
Parameters:
configuration - The plugin 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 plugin, or false if not.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(LastModPluginCfg configuration,
                                               java.util.List<Message> unacceptableReasons)
Indicates whether the proposed change to the configuration is acceptable to this change listener.

Specified by:
isConfigurationChangeAcceptable in interface ConfigurationChangeListener<LastModPluginCfg>
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(LastModPluginCfg configuration)
Applies the configuration changes to this change listener.

Specified by:
applyConfigurationChange in interface ConfigurationChangeListener<LastModPluginCfg>
Parameters:
configuration - The new configuration containing the changes.
Returns:
Returns information about the result of changing the configuration.