Interface MoveSubtreeListener

  • All Known Implementing Classes:
    MoveSubtree

    @Extensible
    @ThreadSafety(level=INTERFACE_NOT_THREADSAFE)
    public interface MoveSubtreeListener
    This interface defines an API that may be implemented by classes which wish to be notified of processing performed in the course of moving a subtree between servers.
    NOTE: This class, and other classes within the com.unboundid.ldap.sdk.unboundidds package structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.
    • Method Detail

      • doPreAddProcessing

        @Nullable
        ReadOnlyEntry doPreAddProcessing​(@NotNull
                                         ReadOnlyEntry entry)
        Performs any processing which may be needed before the provided entry is added to the target server.
        Parameters:
        entry - A read-only representation of the entry to be added to the target server.
        Returns:
        The original entry if the add should proceed without changes, a new entry (which must have the same DN as the provided entry) if the entry should be added with changes, or null if the entry should not be added to the target server (but will still be removed from the source server).
      • doPostAddProcessing

        void doPostAddProcessing​(@NotNull
                                 ReadOnlyEntry entry)
        Performs any processing which may be needed after the provided entry has been added to the target server.
        Parameters:
        entry - A read-only representation of the entry that was added to the target server. Note that depending on the algorithm used to perform the move, the entry may not yet be accessible in the target server. Also note that the add may potentially be reverted if move processing encounters an error later in its processing.
      • doPreDeleteProcessing

        void doPreDeleteProcessing​(@NotNull
                                   DN entryDN)
        Performs any processing which may be needed before the specified entry is deleted from the source server.
        Parameters:
        entryDN - The DN of the entry that is to be removed from the source server. Note that depending on the algorithm used to perform the move, the entry may already be inaccessible in the source server.
      • doPostDeleteProcessing

        void doPostDeleteProcessing​(@NotNull
                                    DN entryDN)
        Performs any processing which may be needed after the specified entry has been deleted from the source server.
        Parameters:
        entryDN - The DN of the entry that has been removed from the source server. Note that the delete may potentially be reverted if move processing encounters an error later in its processing.