Package org.forgerock.opendj.ldap.requests

Interface ModifyDNRequest

All Superinterfaces:
ChangeRecord, Request
public interface ModifyDNRequest extends Request, ChangeRecord
The Modify DN operation allows a client to change the Relative Distinguished Name (RDN) of an entry in the Directory and/or to move a subtree of entries to a new location in the Directory.

  • Method Details

    • accept

      <R, P> R accept(ChangeRecordVisitor<R,P> v, P p)
      Description copied from interface: ChangeRecord
      Applies a ChangeRecordVisitor to this ChangeRecord.
      Specified by:
      accept in interface ChangeRecord
      Type Parameters:
      R - The return type of the visitor's methods.
      P - The type of the additional parameters to the visitor's methods.
      Parameters:
      v - The change record visitor.
      p - Optional additional visitor parameter.
      Returns:
      A result as specified by the visitor.

    • addControl

      ModifyDNRequest addControl(Control control)
      Description copied from interface: Request
      Adds the provided control to this request.
      Specified by:
      addControl in interface Request
      Parameters:
      control - The control to be added to this request.
      Returns:
      This request.

    • getControl

      <C extends Control> C getControl(ControlDecoder<C> decoder, DecodeOptions options) throws DecodeException
      Description copied from interface: Request
      Decodes and returns the first control in this request having an OID corresponding to the provided control decoder.
      Specified by:
      getControl in interface Request
      Type Parameters:
      C - The type of control to be decoded and returned.
      Parameters:
      decoder - The control decoder.
      options - The set of decode options which should be used when decoding the control.
      Returns:
      The decoded control, or null if the control is not included with this request.
      Throws:
      DecodeException - If the control could not be decoded because it was malformed in some way (e.g. the control value was missing, or its content could not be decoded).

    • getControls

      List<Control> getControls()
      Description copied from interface: Request
      Returns a List containing the controls included with this request. The returned List may be modified if permitted by this request.
      Specified by:
      getControls in interface Request
      Returns:
      A List containing the controls.

    • getName

      DN getName()
      Returns the distinguished name of the entry to be renamed. This entry may or may not have subordinate entries. The server shall not dereference any aliases in locating the entry to be renamed.
      Specified by:
      getName in interface ChangeRecord
      Returns:
      The distinguished name of the entry.

    • getNewRDN

      RDN getNewRDN()
      Returns the new RDN of the entry to be renamed. The value of the old RDN is supplied when moving the entry to a new superior without changing its RDN. Attribute values of the new RDN not matching any attribute value of the entry are added to the entry, and an appropriate error is returned if this fails.
      Returns:
      The new RDN of the entry.

    • getNewSuperior

      DN getNewSuperior()
      Returns the distinguished name of an existing entry that will become the immediate superior (parent) of the entry to be renamed. The server shall not dereference any aliases in locating the new superior entry. The default value is null, indicating that the entry is to remain under the same parent entry.
      Returns:
      The distinguished name of the new superior entry, or null if the entry is to remain under the same parent entry.

    • isDeleteOldRDN

      boolean isDeleteOldRDN()
      Indicates whether the old RDN attribute values are to be retained as attributes of the entry or deleted from the entry. The default value is false.
      Returns:
      true if the old RDN attribute values are to be deleted from the entry, or false if they are to be retained.

    • setDeleteOldRDN

      ModifyDNRequest setDeleteOldRDN(boolean deleteOldRDN)
      Specifies whether the old RDN attribute values are to be retained as attributes of the entry or deleted from the entry. The default value is false.
      Parameters:
      deleteOldRDN - true if the old RDN attribute values are to be deleted from the entry, or false if they are to be retained.
      Returns:
      This modify DN request.
      Throws:
      UnsupportedOperationException - If this modify DN request does not permit the delete old RDN parameter to be set.

    • setName

      ModifyDNRequest setName(DN dn)
      Sets the distinguished name of the entry to be renamed. This entry may or may not have subordinate entries. The server shall not dereference any aliases in locating the entry to be renamed.
      Parameters:
      dn - The distinguished name of the entry to be renamed.
      Returns:
      This modify DN request.
      Throws:
      UnsupportedOperationException - If this modify DN request does not permit the distinguished name to be set.
      NullPointerException - If dn was null.

    • setName

      ModifyDNRequest setName(String dn)
      Sets the distinguished name of the entry to be renamed. This entry may or may not have subordinate entries. The server shall not dereference any aliases in locating the entry to be renamed.
      Parameters:
      dn - The distinguished name of the entry to be renamed.
      Returns:
      This modify DN request.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If dn could not be decoded using the default schema.
      UnsupportedOperationException - If this modify DN request does not permit the distinguished name to be set.
      NullPointerException - If dn was null.

    • setNewRDN

      ModifyDNRequest setNewRDN(RDN rdn)
      Sets the new RDN of the entry to be renamed. The value of the old RDN is supplied when moving the entry to a new superior without changing its RDN. Attribute values of the new RDN not matching any attribute value of the entry are added to the entry, and an appropriate error is returned if this fails.
      Parameters:
      rdn - The new RDN of the entry to be renamed.
      Returns:
      This modify DN request.
      Throws:
      UnsupportedOperationException - If this modify DN request does not permit the new RDN to be set.
      NullPointerException - If rdn was null.

    • setNewRDN

      ModifyDNRequest setNewRDN(String rdn)
      Sets the new RDN of the entry to be renamed. The value of the old RDN is supplied when moving the entry to a new superior without changing its RDN. Attribute values of the new RDN not matching any attribute value of the entry are added to the entry, and an appropriate error is returned if this fails.
      Parameters:
      rdn - The new RDN of the entry to be renamed.
      Returns:
      This modify DN request.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If rdn could not be decoded using the default schema.
      UnsupportedOperationException - If this modify DN request does not permit the new RDN to be set.
      NullPointerException - If rdn was null.

    • setNewSuperior

      ModifyDNRequest setNewSuperior(DN dn)
      Sets the distinguished name of an existing entry that will become the immediate superior (parent) of the entry to be renamed. The server shall not dereference any aliases in locating the new superior entry. The default value is null, indicating that the entry is to remain under the same parent entry.
      Parameters:
      dn - The distinguished name of an existing entry that will become the immediate superior (parent) of the entry to be renamed, may be null.
      Returns:
      This modify DN request.
      Throws:
      UnsupportedOperationException - If this modify DN request does not permit the new superior to be set.

    • setNewSuperior

      ModifyDNRequest setNewSuperior(String dn)
      Sets the distinguished name of an existing entry that will become the immediate superior (parent) of the entry to be renamed. The server shall not dereference any aliases in locating the new superior entry. The default value is null, indicating that the entry is to remain under the same parent entry.
      Parameters:
      dn - The distinguished name of an existing entry that will become the immediate superior (parent) of the entry to be renamed, may be null.
      Returns:
      This modify DN request.
      Throws:
      org.forgerock.i18n.LocalizedIllegalArgumentException - If dn could not be decoded using the default schema.
      UnsupportedOperationException - If this modify DN request does not permit the new superior to be set.