Package org.opends.server.api

Class Backend<C extends Configuration>

    • Constructor Detail

      • Backend

        public Backend()

    • Method Detail

      • configureBackend

        public abstract void configureBackend​(C cfg,
                                      ServerContext serverContext)
                               throws ConfigException
        Configure this backend based on the information in the provided configuration. When the method returns, the backend will have been configured (ready to be opened) but still unable to process operations.
        Parameters:
        cfg - The configuration of this backend.
        serverContext - The server context for this instance
        Throws:
        ConfigException - If there is an error in the configuration.

      • getServerContext

        protected ServerContext getServerContext()
        Returns the server context used by this backend.
        Returns:
        the server context used by this backend

      • finalizeBackend

        public abstract void finalizeBackend()
        Performs any necessary work to finalize this backend. The backend must be an opened backend, so do not use this method on backends where only configureBackend() has been called. 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.

        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.

      • getBackendID

        public final String getBackendID()
        Retrieves the unique identifier for this backend.
        Returns:
        The unique identifier for this backend.

      • getBaseDNs

        public abstract Set<Dn> getBaseDNs()
        Retrieves the set of base-level DNs that may be used within this backend.
        Returns:
        The set of base-level DNs that may be used within this backend.

      • getSupportedControls

        public Set<String> getSupportedControls()
        Retrieves the OIDs of the controls that may be supported by this backend.
        Returns:
        The OIDs of the controls that may be supported by this backend.

      • getSupportedFeatures

        public Set<String> getSupportedFeatures()
        Retrieves the OIDs of the features that may be supported by this backend.
        Returns:
        The OIDs of the features that may be supported by this backend.

      • isConfigurationAcceptable

        public boolean isConfigurationAcceptable​(C configuration,
                                         List<LocalizableMessage> unacceptableReasons,
                                         ServerContext serverContext)
        Indicates whether the provided configuration is acceptable for this backend. It should be possible to call this method on an uninitialized backend instance in order to determine whether the backend would be able to use the provided configuration.
        Parameters:
        configuration - 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 context
        Returns:
        true if the provided configuration is acceptable for this backend, or false if not.

      • isPublicBackend

        public abstract boolean isPublicBackend()
        Indicates whether the base DNs of this backend should be considered public or private.

        This method also controls the visibility of the associated naming contexts. i.e. if any base DN of this backend is a naming context, then it will be public or private, based on the value returned by this method.

        Reminder: Public naming contexts are returned when querying the root DSE entry.

        Returns:
        true if this backend's baseDNs could be exposed as a public naming context, false if they must remain private naming contexts.

      • setBackendID

        public final void setBackendID​(String backendID)
        Specifies the unique identifier for this backend.
        Parameters:
        backendID - The unique identifier for this backend.

      • registerBackendMonitor

        public void registerBackendMonitor()
        Registers a backend monitor for this backend.

      • deregisterBackendMonitor

        public void deregisterBackendMonitor()
        Deregisters the backend monitor of this backend.