mirror of https://github.com/OpenIdentityPlatform/OpenDJ.git
opendj-sdk/opends/src/server/org/opends/server/backends/BackupBackend.java
@@ -25,13 +25,16 @@ * Portions Copyright 2006-2007 Sun Microsystems, Inc. */ package org.opends.server.backends; import org.opends.messages.Message; import java.io.File; import java.util.*; import org.opends.messages.Message; import org.opends.server.admin.Configuration; import org.opends.server.admin.server.ConfigurationChangeListener; import org.opends.server.admin.std.server.BackupBackendCfg; import org.opends.server.api.Backend; import org.opends.server.config.ConfigException; import org.opends.server.core.AddOperation; @@ -40,22 +43,40 @@ import org.opends.server.core.ModifyOperation; import org.opends.server.core.ModifyDNOperation; import org.opends.server.core.SearchOperation; import org.opends.server.loggers.debug.DebugTracer; import org.opends.server.protocols.asn1.ASN1OctetString; import org.opends.server.types.Attribute; import org.opends.server.types.AttributeType; import org.opends.server.types.AttributeValue; import org.opends.server.types.BackupConfig; import org.opends.server.types.BackupDirectory; import org.opends.server.types.BackupInfo; import org.opends.server.types.ConditionResult; import org.opends.server.types.ConfigChangeResult; import org.opends.server.types.DebugLogLevel; import org.opends.server.types.DirectoryException; import org.opends.server.types.DN; import org.opends.server.types.Entry; import org.opends.server.types.IndexType; import org.opends.server.types.InitializationException; import org.opends.server.types.LDIFExportConfig; import org.opends.server.types.LDIFImportConfig; import org.opends.server.types.LDIFImportResult; import org.opends.server.types.ObjectClass; import org.opends.server.types.RDN; import org.opends.server.types.RestoreConfig; import org.opends.server.types.ResultCode; import org.opends.server.types.SearchFilter; import org.opends.server.types.SearchScope; import org.opends.server.schema.BooleanSyntax; import org.opends.server.schema.GeneralizedTimeSyntax; import org.opends.server.util.Validator; import static org.opends.messages.BackendMessages.*; import static org.opends.server.config.ConfigConstants.*; import static org.opends.server.loggers.debug.DebugLogger.*; import org.opends.server.loggers.debug.DebugTracer; import org.opends.server.types.*; import static org.opends.messages.BackendMessages.*; import static org.opends.server.util.ServerConstants.*; import static org.opends.server.util.StaticUtils.*; import org.opends.server.util.Validator; import org.opends.server.admin.server.ConfigurationChangeListener; import org.opends.server.admin.std.server.BackupBackendCfg; import org.opends.server.admin.Configuration; /** @@ -75,6 +96,8 @@ */ private static final DebugTracer TRACER = getTracer(); // The current configuration state. private BackupBackendCfg currentConfig; @@ -111,9 +134,11 @@ } /** * {@inheritDoc} */ @Override() public void configureBackend(Configuration config) throws ConfigException { // Make sure that a configuration entry was provided. If not, then we will @@ -130,9 +155,12 @@ currentConfig = (BackupBackendCfg)config; } /** * {@inheritDoc} */ @Override() public void initializeBackend() throws ConfigException, InitializationException { @@ -231,16 +259,9 @@ /** * Performs any necessary work to finalize this backend, including closing any * underlying databases or connections and deregistering any suffixes that it * manages with the Directory Server. This may be called during the * Directory Server shutdown process or if a backend is disabled with the * server online. It must not return until the backend is closed. * <BR><BR> * This method may not throw any exceptions. If any problems are encountered, * then they may be logged but the closure should progress as completely as * possible. * {@inheritDoc} */ @Override() public void finalizeBackend() { currentConfig.removeBackupChangeListener(this); @@ -261,10 +282,9 @@ /** * Retrieves the set of base-level DNs that may be used within this backend. * * @return The set of base-level DNs that may be used within this backend. * {@inheritDoc} */ @Override() public DN[] getBaseDNs() { return baseDNs; @@ -275,6 +295,7 @@ /** * {@inheritDoc} */ @Override() public long getEntryCount() { int numEntries = 1; @@ -307,23 +328,33 @@ /** * Indicates whether the data associated with this backend may be considered * local (i.e., in a repository managed by the Directory Server) rather than * remote (i.e., in an external repository accessed by the Directory Server * but managed through some other means). * * @return <CODE>true</CODE> if the data associated with this backend may be * considered local, or <CODE>false</CODE> if it is remote. * {@inheritDoc} */ @Override() public boolean isLocal() { // For the purposes of this method, this is a local backend. return true; } /** * {@inheritDoc} */ @Override() public boolean isIndexed(AttributeType attributeType, IndexType indexType) { // All searches in this backend will always be considered indexed. return true; } /** * {@inheritDoc} */ @Override() public ConditionResult hasSubordinates(DN entryDN) throws DirectoryException { long ret = numSubordinates(entryDN); @@ -341,9 +372,12 @@ } } /** * {@inheritDoc} */ @Override() public long numSubordinates(DN entryDN) throws DirectoryException { // If the requested entry was null, then return undefined. @@ -417,17 +451,12 @@ } } /** * Retrieves the requested entry from this backend. * * @param entryDN The distinguished name of the entry to retrieve. * * @return The requested entry, or <CODE>null</CODE> if the entry does not * exist. * * @throws DirectoryException If a problem occurs while trying to retrieve * the entry. * {@inheritDoc} */ @Override() public Entry getEntry(DN entryDN) throws DirectoryException { @@ -797,18 +826,9 @@ /** * Adds the provided entry to this backend. This method must ensure that the * entry is appropriate for the backend and that no entry already exists with * the same DN. * * @param entry The entry to add to this backend. * @param addOperation The add operation with which the new entry is * associated. This may be <CODE>null</CODE> for adds * performed internally. * * @throws DirectoryException If a problem occurs while trying to add the * entry. * {@inheritDoc} */ @Override() public void addEntry(Entry entry, AddOperation addOperation) throws DirectoryException { @@ -819,19 +839,9 @@ /** * Removes the specified entry from this backend. This method must ensure * that the entry exists and that it does not have any subordinate entries * (unless the backend supports a subtree delete operation and the client * included the appropriate information in the request). * * @param entryDN The DN of the entry to remove from this backend. * @param deleteOperation The delete operation with which this action is * associated. This may be <CODE>null</CODE> for * deletes performed internally. * * @throws DirectoryException If a problem occurs while trying to remove the * entry. * {@inheritDoc} */ @Override() public void deleteEntry(DN entryDN, DeleteOperation deleteOperation) throws DirectoryException { @@ -842,19 +852,9 @@ /** * Replaces the specified entry with the provided entry in this backend. The * backend must ensure that an entry already exists with the same DN as the * provided entry. * * @param entry The new entry to use in place of the existing * entry with the same DN. * @param modifyOperation The modify operation with which this action is * associated. This may be <CODE>null</CODE> for * modifications performed internally. * * @throws DirectoryException If a problem occurs while trying to replace * the entry. * {@inheritDoc} */ @Override() public void replaceEntry(Entry entry, ModifyOperation modifyOperation) throws DirectoryException { @@ -865,20 +865,9 @@ /** * Moves and/or renames the provided entry in this backend, altering any * subordinate entries as necessary. This must ensure that an entry already * exists with the provided current DN, and that no entry exists with the * target DN of the provided entry. * * @param currentDN The current DN of the entry to be replaced. * @param entry The new content to use for the entry. * @param modifyDNOperation The modify DN operation with which this action * is associated. This may be <CODE>null</CODE> * for modify DN operations performed internally. * * @throws DirectoryException If a problem occurs while trying to perform * the rename. * {@inheritDoc} */ @Override() public void renameEntry(DN currentDN, Entry entry, ModifyDNOperation modifyDNOperation) throws DirectoryException @@ -890,15 +879,9 @@ /** * Processes the specified search in this backend. Matching entries should be * provided back to the core server using the * <CODE>SearchOperation.returnEntry</CODE> method. * * @param searchOperation The search operation to be processed. * * @throws DirectoryException If a problem occurs while processing the * search. * {@inheritDoc} */ @Override() public void search(SearchOperation searchOperation) throws DirectoryException { @@ -1092,10 +1075,9 @@ /** * Retrieves the OIDs of the controls that may be supported by this backend. * * @return The OIDs of the controls that may be supported by this backend. * {@inheritDoc} */ @Override() public HashSet<String> getSupportedControls() { return supportedControls; @@ -1104,10 +1086,9 @@ /** * Retrieves the OIDs of the features that may be supported by this backend. * * @return The OIDs of the features that may be supported by this backend. * {@inheritDoc} */ @Override() public HashSet<String> getSupportedFeatures() { return supportedFeatures; @@ -1116,12 +1097,9 @@ /** * Indicates whether this backend provides a mechanism to export the data it * contains to an LDIF file. * * @return <CODE>true</CODE> if this backend provides an LDIF export * mechanism, or <CODE>false</CODE> if not. * {@inheritDoc} */ @Override() public boolean supportsLDIFExport() { // We do not support LDIF exports. @@ -1133,6 +1111,7 @@ /** * {@inheritDoc} */ @Override() public void exportLDIF(LDIFExportConfig exportConfig) throws DirectoryException { @@ -1143,12 +1122,9 @@ /** * Indicates whether this backend provides a mechanism to import its data from * an LDIF file. * * @return <CODE>true</CODE> if this backend provides an LDIF import * mechanism, or <CODE>false</CODE> if not. * {@inheritDoc} */ @Override() public boolean supportsLDIFImport() { // This backend does not support LDIF imports. @@ -1160,6 +1136,7 @@ /** * {@inheritDoc} */ @Override() public LDIFImportResult importLDIF(LDIFImportConfig importConfig) throws DirectoryException { @@ -1171,16 +1148,9 @@ /** * Indicates whether this backend provides a backup mechanism of any kind. * This method is used by the backup process when backing up all backends to * determine whether this backend is one that should be skipped. It should * only return <CODE>true</CODE> for backends that it is not possible to * archive directly (e.g., those that don't store their data locally, but * rather pass through requests to some other repository). * * @return <CODE>true</CODE> if this backend provides any kind of backup * mechanism, or <CODE>false</CODE> if it does not. * {@inheritDoc} */ @Override() public boolean supportsBackup() { // This backend does not provide a backup/restore mechanism. @@ -1190,20 +1160,9 @@ /** * Indicates whether this backend provides a mechanism to perform a backup of * its contents in a form that can be restored later, based on the provided * configuration. * * @param backupConfig The configuration of the backup for which to * make the determination. * @param unsupportedReason A buffer to which a message can be appended * explaining why the requested backup is not * supported. * * @return <CODE>true</CODE> if this backend provides a mechanism for * performing backups with the provided configuration, or * <CODE>false</CODE> if not. * {@inheritDoc} */ @Override() public boolean supportsBackup(BackupConfig backupConfig, StringBuilder unsupportedReason) { @@ -1216,6 +1175,7 @@ /** * {@inheritDoc} */ @Override() public void createBackup(BackupConfig backupConfig) throws DirectoryException { @@ -1227,17 +1187,9 @@ /** * Removes the specified backup if it is possible to do so. * * @param backupDirectory The backup directory structure with which the * specified backup is associated. * @param backupID The backup ID for the backup to be removed. * * @throws 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). * {@inheritDoc} */ @Override() public void removeBackup(BackupDirectory backupDirectory, String backupID) throws DirectoryException @@ -1250,11 +1202,9 @@ /** * Indicates whether this backend provides a mechanism to restore a backup. * * @return <CODE>true</CODE> if this backend provides a mechanism for * restoring backups, or <CODE>false</CODE> if not. * {@inheritDoc} */ @Override() public boolean supportsRestore() { // This backend does not provide a backup/restore mechanism. @@ -1266,6 +1216,7 @@ /** * {@inheritDoc} */ @Override() public void restoreBackup(RestoreConfig restoreConfig) throws DirectoryException { @@ -1289,6 +1240,7 @@ } /** * {@inheritDoc} */ @@ -1310,6 +1262,8 @@ return new ConfigChangeResult(resultCode, adminActionRequired, messages); } /** * Create a new child DN from a given parent DN. The child RDN is formed * from a given attribute type and string value. @@ -1325,7 +1279,5 @@ new AttributeValue(rdnAttrType, rdnStringValue); return parentDN.concat(RDN.create(rdnAttrType, attrValue)); } }
