public class RootDSEBackend extends Backend<RootDSEBackendCfg> implements ConfigurationChangeListener<RootDSEBackendCfg>
Backend.BackendOperation| Constructor and Description |
|---|
RootDSEBackend()
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.
|
ConfigChangeResult |
applyConfigurationChange(RootDSEBackendCfg cfg)
Applies the configuration changes to this change listener.
|
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(RootDSEBackendCfg config,
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.
|
boolean |
entryExists(DN entryDN)
Indicates whether an entry with the specified DN exists in the 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.
|
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.
|
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.
|
Entry |
getRootDSE()
Retrieves the root DSE entry for the Directory Server.
|
Map<DN,Backend<?>> |
getSubordinateBaseDNs()
Returns the subordinate base DNs of the root DSE.
|
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.
|
org.forgerock.opendj.ldap.ConditionResult |
hasSubordinates(DN entryDN)
Indicates whether the requested entry has any subordinates.
|
LDIFImportResult |
importLDIF(LDIFImportConfig importConfig,
ServerContext serverContext)
Imports information from an LDIF file into this backend.
|
boolean |
isConfigurationAcceptable(RootDSEBackendCfg config,
List<LocalizableMessage> unacceptableReasons,
ServerContext serverContext)
Indicates whether the provided configuration is acceptable for
this backend.
|
boolean |
isConfigurationChangeAcceptable(RootDSEBackendCfg cfg,
List<LocalizableMessage> unacceptableReasons)
Indicates whether the proposed change to the configuration is
acceptable to this change listener.
|
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, finalizeBackend, getBackendID, getBackendMonitor, getParentBackend, getPersistentSearches, getSubordinateBackends, getWritabilityMode, handlesEntry, handlesEntry, isIndexed, isPrivateBackend, rebuildBackend, registerPersistentSearch, removeSubordinateBackend, setBackendID, setBackendMonitor, setParentBackend, setPrivateBackend, setWritabilityMode, supportsControl, verifyBackendpublic RootDSEBackend()
super() to invoke this constructor.public void configureBackend(RootDSEBackendCfg config, ServerContext serverContext) throws ConfigException
BackendconfigureBackend in class Backend<RootDSEBackendCfg>config - 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
BackendopenBackend in class Backend<RootDSEBackendCfg>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()
Backend
It will be called as final step of finalizeBackend(),
so subclasses might override it.
closeBackend in class Backend<RootDSEBackendCfg>public DN[] getBaseDNs()
BackendgetBaseDNs in class Backend<RootDSEBackendCfg>public long getEntryCount()
BackendgetEntryCount in class Backend<RootDSEBackendCfg>public boolean isIndexed(AttributeType attributeType, IndexType indexType)
Backendtrue for the specified
attribute and index type.isIndexed in class Backend<RootDSEBackendCfg>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
BackendhasSubordinates in class Backend<RootDSEBackendCfg>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
BackendgetNumberOfEntriesInBaseDN in class Backend<RootDSEBackendCfg>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
BackendgetNumberOfChildren in class Backend<RootDSEBackendCfg>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
BackendgetEntry in class Backend<RootDSEBackendCfg>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 Entry getRootDSE()
public boolean entryExists(DN entryDN) throws DirectoryException
BackendgetEntry, but backend implementations may override this with a
more efficient version. The caller is not required to hold any locks on the specified DN.entryExists in class Backend<RootDSEBackendCfg>entryDN - The DN of the entry for which to determine existence.true if the specified entry exists in this backend, or false if it does
not.DirectoryException - If a problem occurs while trying to make the determination.public void addEntry(Entry entry, AddOperation addOperation) throws DirectoryException
BackendaddEntry in class Backend<RootDSEBackendCfg>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
BackenddeleteEntry in class Backend<RootDSEBackendCfg>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
BackendreplaceEntry in class Backend<RootDSEBackendCfg>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
BackendrenameEntry in class Backend<RootDSEBackendCfg>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
BackendSearchOperation.returnEntry method. The caller is not
required to have any locks when calling this operation.search in class Backend<RootDSEBackendCfg>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 Map<DN,Backend<?>> getSubordinateBaseDNs()
public Set<String> getSupportedControls()
BackendgetSupportedControls in class Backend<RootDSEBackendCfg>public Set<String> getSupportedFeatures()
BackendgetSupportedFeatures in class Backend<RootDSEBackendCfg>public boolean supports(Backend.BackendOperation backendOperation)
Backendsupports in class Backend<RootDSEBackendCfg>backendOperation - the backend operationtrue if this backend supports the provided backend operation, false
otherwise.public void exportLDIF(LDIFExportConfig exportConfig) throws DirectoryException
BackendBackend.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<RootDSEBackendCfg>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 serverContext) throws DirectoryException
BackendBackend.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<RootDSEBackendCfg>importConfig - The configuration to use when performing the import.serverContext - The server contextDirectoryException - If a problem occurs while performing the LDIF import.public void createBackup(BackupConfig backupConfig) throws DirectoryException
BackendBackend.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<RootDSEBackendCfg>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
BackendremoveBackup in class Backend<RootDSEBackendCfg>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
BackendBackend.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<RootDSEBackendCfg>restoreConfig - The configuration to use when performing the restore.DirectoryException - If a problem occurs while performing the restore.public boolean isConfigurationAcceptable(RootDSEBackendCfg config, List<LocalizableMessage> unacceptableReasons, ServerContext serverContext)
BackendisConfigurationAcceptable in class Backend<RootDSEBackendCfg>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(RootDSEBackendCfg cfg, List<LocalizableMessage> unacceptableReasons)
ConfigurationChangeListenerisConfigurationChangeAcceptable in interface ConfigurationChangeListener<RootDSEBackendCfg>cfg - 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(RootDSEBackendCfg cfg)
ConfigurationChangeListenerapplyConfigurationChange in interface ConfigurationChangeListener<RootDSEBackendCfg>cfg - The new configuration containing the changes.Copyright © 2010-2015 ForgeRock AS. All Rights Reserved.