public class TaskBackend extends Backend<TaskBackendCfg> implements ConfigurationChangeListener<TaskBackendCfg>, Backupable
Backend.BackendOperation| Constructor and Description |
|---|
TaskBackend()
Creates a new backend with the provided information.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addEntry(Entry entry,
AddOperation addOperation)
Adds the provided entry to this backend.
|
void |
afterRestore(Path restoreDirectory,
Path saveDirectory)
Called after the restore operation has finished successfully.
|
ConfigChangeResult |
applyConfigurationChange(TaskBackendCfg configEntry)
Applies the configuration changes to this change listener.
|
Path |
beforeRestore()
Called before the restore operation begins.
|
void |
closeBackend()
Performs any necessary work to finally close this backend, particularly
closing any underlying databases or connections and deregistering
any suffixes that it manages with the Directory Server.
|
void |
configureBackend(TaskBackendCfg cfg,
ServerContext serverContext)
Configure this backend based on the information in the provided configuration.
|
void |
createBackup(BackupConfig backupConfig)
Creates a backup of the contents of this backend in a form that may be restored at a later date
if necessary.
|
void |
deleteEntry(DN entryDN,
DeleteOperation deleteOperation)
Removes the specified entry from this backend.
|
void |
exportLDIF(LDIFExportConfig exportConfig)
Exports the contents of this backend to LDIF.
|
DN[] |
getBaseDNs()
Retrieves the set of base-level DNs that may be used within this
backend.
|
DN |
getConfigEntryDN()
Retrieves the DN of the configuration entry for this task backend.
|
File |
getDirectory()
Returns the directory which acts as the root of all files to backup and restore.
|
Entry |
getEntry(DN entryDN)
Retrieves the requested entry from this backend.
|
long |
getEntryCount()
Retrieves the total number of entries contained in this backend,
if that information is available.
|
ListIterator<Path> |
getFilesToBackup()
Returns the files to backup.
|
String |
getNotificationSenderAddress()
Retrieves the sender address that should be used for e-mail notifications
of task completion.
|
long |
getNumberOfChildren(DN parentDN)
Retrieves the number of subordinates immediately below the requested entry.
|
long |
getNumberOfEntriesInBaseDN(DN baseDN)
Retrieves the number of entries for the specified base DN including all entries from the requested entry to the
lowest level in the tree.
|
RecurringTask |
getRecurringTask(DN taskEntryDN)
Retrieves the recurring task for the entry with the provided DN.
|
DN |
getRecurringTasksParentDN()
Retrieves the DN of the entry that is the immediate parent for all
recurring task information in the Directory Server.
|
long |
getRetentionTime()
Retrieves the length of time in seconds that information for a task should
be retained after processing on it has completed.
|
Task |
getScheduledTask(DN taskEntryDN)
Retrieves the scheduled task for the entry with the provided DN.
|
DN |
getScheduledTasksParentDN()
Retrieves the DN of the entry that is the immediate parent for all
scheduled task information in the Directory Server.
|
Set<String> |
getSupportedControls()
Retrieves the OIDs of the controls that may be supported by this
backend.
|
Set<String> |
getSupportedFeatures()
Retrieves the OIDs of the features that may be supported by this
backend.
|
String |
getTaskBackingFile()
Retrieves the path to the backing file that will hold the scheduled and
recurring task definitions.
|
DN |
getTaskRootDN()
Retrieves the DN of the entry that is the root for all task information in
the Directory Server.
|
org.forgerock.opendj.ldap.ConditionResult |
hasSubordinates(DN entryDN)
Indicates whether the requested entry has any subordinates.
|
LDIFImportResult |
importLDIF(LDIFImportConfig importConfig,
ServerContext sContext)
Imports information from an LDIF file into this backend.
|
boolean |
isConfigurationAcceptable(TaskBackendCfg config,
List<LocalizableMessage> unacceptableReasons,
ServerContext serverContext)
Indicates whether the provided configuration is acceptable for
this backend.
|
boolean |
isConfigurationChangeAcceptable(TaskBackendCfg configEntry,
List<LocalizableMessage> unacceptableReasons)
Indicates whether the proposed change to the configuration is
acceptable to this change listener.
|
boolean |
isDirectRestore()
Indicates if restore is done directly in the restore directory.
|
boolean |
isIndexed(AttributeType attributeType,
IndexType indexType)
Indicates whether search operations which target the specified
attribute in the indicated manner would be considered indexed
in this backend.
|
void |
openBackend()
Opens this backend based on the information provided when the backend was configured.
|
void |
removeBackup(BackupDirectory backupDirectory,
String backupID)
Removes the specified backup if it is possible to do so.
|
void |
renameEntry(DN currentDN,
Entry entry,
ModifyDNOperation modifyDNOperation)
Moves and/or renames the provided entry in this backend, altering
any subordinate entries as necessary.
|
void |
replaceEntry(Entry oldEntry,
Entry newEntry,
ModifyOperation modifyOperation)
Replaces the specified entry with the provided entry in this
backend.
|
void |
restoreBackup(RestoreConfig restoreConfig)
Restores a backup of the contents of this backend.
|
void |
search(SearchOperation searchOperation)
Processes the specified search in this backend.
|
boolean |
supports(Backend.BackendOperation backendOperation)
Indicates whether this backend supports the provided backend operation.
|
addSubordinateBackend, entryExists, finalizeBackend, getBackendID, getBackendMonitor, getParentBackend, getPersistentSearches, getSubordinateBackends, getWritabilityMode, handlesEntry, handlesEntry, isIndexed, isPrivateBackend, rebuildBackend, registerPersistentSearch, removeSubordinateBackend, setBackendID, setBackendMonitor, setParentBackend, setPrivateBackend, setWritabilityMode, supportsControl, verifyBackendpublic TaskBackend()
super() to invoke this constructor.public void configureBackend(TaskBackendCfg cfg, ServerContext serverContext) throws ConfigException
configureBackend in class Backend<TaskBackendCfg>cfg - The configuration of this backend.serverContext - The server context for this instanceConfigException - If there is an error in the configuration.public void openBackend() throws ConfigException, InitializationException
openBackend in class Backend<TaskBackendCfg>ConfigException - If an unrecoverable problem arises while opening the backend.InitializationException - If a problem occurs during opening that is not
related to the server configuration.Backend.configureBackend(C, org.opends.server.core.ServerContext)public void closeBackend()
It will be called as final step of finalizeBackend(),
so subclasses might override it.
closeBackend in class Backend<TaskBackendCfg>public DN[] getBaseDNs()
getBaseDNs in class Backend<TaskBackendCfg>public long getEntryCount()
getEntryCount in class Backend<TaskBackendCfg>public boolean isIndexed(AttributeType attributeType, IndexType indexType)
true for the specified
attribute and index type.isIndexed in class Backend<TaskBackendCfg>attributeType - The attribute type for which to make the
determination.indexType - The index type for which to make the
determination.true if search operations targeting the
specified attribute in the indicated manner should be
considered indexed, or false if not.public org.forgerock.opendj.ldap.ConditionResult hasSubordinates(DN entryDN) throws DirectoryException
hasSubordinates in class Backend<TaskBackendCfg>entryDN - The distinguished name of the entry.ConditionResult.TRUE if the entry has one or more
subordinates or ConditionResult.FALSE otherwise
or ConditionResult.UNDEFINED if it can not be
determined.DirectoryException - If a problem occurs while trying to
retrieve the entry.public long getNumberOfEntriesInBaseDN(DN baseDN) throws DirectoryException
getNumberOfEntriesInBaseDN in class Backend<TaskBackendCfg>baseDN - The base distinguished name.DirectoryException - If baseDN isn't a base dn managed by this backend or if a problem occurs while trying to retrieve the
entry.public long getNumberOfChildren(DN parentDN) throws DirectoryException
getNumberOfChildren in class Backend<TaskBackendCfg>parentDN - The distinguished name of the parent.DirectoryException - If baseDN isn't a base dn managed by this backend or if a problem occurs while trying to retrieve the
entry.public Entry getEntry(DN entryDN) throws DirectoryException
getEntry in class Backend<TaskBackendCfg>entryDN - The distinguished name of the entry to retrieve.null if the entry does not exist.DirectoryException - If a problem occurs while trying to retrieve the entry.public void addEntry(Entry entry, AddOperation addOperation) throws DirectoryException
addEntry in class Backend<TaskBackendCfg>entry - The entry to add to this backend.addOperation - The add operation with which the new entry
is associated. This may be null
for adds performed internally.DirectoryException - If a problem occurs while trying to
add the entry.public void deleteEntry(DN entryDN, DeleteOperation deleteOperation) throws DirectoryException
deleteEntry in class Backend<TaskBackendCfg>entryDN - The DN of the entry to remove from this
backend.deleteOperation - The delete operation with which this
action is associated. This may be
null for deletes performed
internally.DirectoryException - If a problem occurs while trying to
remove the entry.public void replaceEntry(Entry oldEntry, Entry newEntry, ModifyOperation modifyOperation) throws DirectoryException
replaceEntry in class Backend<TaskBackendCfg>oldEntry - The original entry that is being replaced.newEntry - The new entry to use in place of the existing entry with
the same DN.modifyOperation - The modify operation with which this action is
associated. This may be null for modifications
performed internally.DirectoryException - If a problem occurs while trying to replace the entry.public void renameEntry(DN currentDN, Entry entry, ModifyDNOperation modifyDNOperation) throws DirectoryException
renameEntry in class Backend<TaskBackendCfg>currentDN - The current DN of the entry to be moved/renamed.entry - The new content to use for the entry.modifyDNOperation - The modify DN operation with which this action is
associated. This may be null for modify DN
operations performed internally.DirectoryException - If a problem occurs while trying to perform the rename.public void search(SearchOperation searchOperation) throws DirectoryException, CanceledOperationException
SearchOperation.returnEntry method. The caller is not
required to have any locks when calling this operation.search in class Backend<TaskBackendCfg>searchOperation - The search operation to be processed.DirectoryException - If a problem occurs while processing
the search.CanceledOperationException - If this backend noticed and
reacted to a request to
cancel or abandon the
search operation.public Set<String> getSupportedControls()
getSupportedControls in class Backend<TaskBackendCfg>public Set<String> getSupportedFeatures()
getSupportedFeatures in class Backend<TaskBackendCfg>public boolean supports(Backend.BackendOperation backendOperation)
supports in class Backend<TaskBackendCfg>backendOperation - the backend operationtrue if this backend supports the provided backend operation, false
otherwise.public void exportLDIF(LDIFExportConfig exportConfig) throws DirectoryException
Backend.supports(BackendOperation) with Backend.BackendOperation.LDIF_EXPORT returns
true.
Note that the server will not explicitly initialize this backend before calling this method.
exportLDIF in class Backend<TaskBackendCfg>exportConfig - The configuration to use when performing the export.DirectoryException - If a problem occurs while performing the LDIF export.public LDIFImportResult importLDIF(LDIFImportConfig importConfig, ServerContext sContext) throws DirectoryException
Backend.supports(BackendOperation) with Backend.BackendOperation.LDIF_IMPORT returns
true.
Note that the server will not explicitly initialize this backend before calling this method.
importLDIF in class Backend<TaskBackendCfg>importConfig - The configuration to use when performing the import.sContext - The server contextDirectoryException - If a problem occurs while performing the LDIF import.public void createBackup(BackupConfig backupConfig) throws DirectoryException
Backend.supports(BackendOperation) with
Backend.BackendOperation.BACKUP returns true.
Note that the server will not explicitly initialize this backend before calling this method.
createBackup in class Backend<TaskBackendCfg>backupConfig - The configuration to use when performing the backup.DirectoryException - If a problem occurs while performing the backup.public void removeBackup(BackupDirectory backupDirectory, String backupID) throws DirectoryException
removeBackup in class Backend<TaskBackendCfg>backupDirectory - The backup directory structure with
which the specified backup is
associated.backupID - The backup ID for the backup to be
removed.DirectoryException - If it is not possible to remove the
specified backup for some reason
(e.g., no such backup exists or
there are other backups that are
dependent upon it).public void restoreBackup(RestoreConfig restoreConfig) throws DirectoryException
Backend.supports(BackendOperation) with Backend.BackendOperation.RESTORE returns true.
Note that the server will not explicitly initialize this backend before calling this method.
restoreBackup in class Backend<TaskBackendCfg>restoreConfig - The configuration to use when performing the restore.DirectoryException - If a problem occurs while performing the restore.public boolean isConfigurationAcceptable(TaskBackendCfg config, List<LocalizableMessage> unacceptableReasons, ServerContext serverContext)
isConfigurationAcceptable in class Backend<TaskBackendCfg>config - The backend 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.serverContext - this Directory Server instance's server contexttrue if the provided configuration is acceptable
for this backend, or false if not.public boolean isConfigurationChangeAcceptable(TaskBackendCfg configEntry, List<LocalizableMessage> unacceptableReasons)
isConfigurationChangeAcceptable in interface ConfigurationChangeListener<TaskBackendCfg>configEntry - The new configuration containing the changes.unacceptableReasons - A list that can be used to hold messages about why the
provided configuration is not acceptable.true if the proposed change is
acceptable, or false if it is not.public ConfigChangeResult applyConfigurationChange(TaskBackendCfg configEntry)
applyConfigurationChange in interface ConfigurationChangeListener<TaskBackendCfg>configEntry - The new configuration containing the changes.public DN getConfigEntryDN()
public String getTaskBackingFile()
public String getNotificationSenderAddress()
public long getRetentionTime()
public DN getTaskRootDN()
public DN getRecurringTasksParentDN()
public DN getScheduledTasksParentDN()
public Task getScheduledTask(DN taskEntryDN)
taskEntryDN - The DN of the entry for the task to retrieve.null if there is no task with the
specified entry DN.public RecurringTask getRecurringTask(DN taskEntryDN)
taskEntryDN - The DN of the entry for the recurring task to
retrieve.null if there is no task
with the specified entry DN.public File getDirectory()
getDirectory in interface Backupablepublic ListIterator<Path> getFilesToBackup() throws DirectoryException
getFilesToBackup in interface BackupablenullDirectoryException - If an error occurs.public boolean isDirectRestore()
isDirectRestore in interface Backupabletrue if restore is done directly in the restore directory
provided by getDirectory() method, or false if restore
is done in a temporary directory.public Path beforeRestore() throws DirectoryException
In case of direct restore, the backupable entity should take any action to save a copy of existing data before restore operation. Saving includes removing the existing data and copying it in a save directory.
beforeRestore in interface Backupablenull
if not applicable.DirectoryException - If an error occurs.public void afterRestore(Path restoreDirectory, Path saveDirectory) throws DirectoryException
For direct restore, the backupable entity can safely discard the saved copy. For indirect restore, the backupable entity should switch the restored directory to the final restore directory.
afterRestore in interface BackupablerestoreDirectory - The directory in which files have actually been restored. It is never
null.saveDirectory - The directory in which current files have been saved. It may be
null if beforeRestore() returned null.DirectoryException - If an error occurs.Copyright © 2010-2015 ForgeRock AS. All Rights Reserved.