Package org.forgerock.opendj.ldap.responses

Interface SearchResultReference

All Superinterfaces:
Response
public interface SearchResultReference extends Response
A Search Result Reference represents an area not yet explored during a Search operation.

  • Method Details

    • addControl

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

    • addURI

      SearchResultReference addURI(String uri)
      Adds the provided continuation reference URI to this search result reference.
      Parameters:
      uri - The continuation reference URI to be added.
      Returns:
      This search result reference.
      Throws:
      UnsupportedOperationException - If this search result reference does not permit continuation reference URI to be added.
      NullPointerException - If uri was null.

    • getControl

      <C extends Control> C getControl(ControlDecoder<C> decoder, DecodeOptions options) throws DecodeException
      Description copied from interface: Response
      Decodes and returns the first control in this response having an OID corresponding to the provided control decoder.
      Specified by:
      getControl in interface Response
      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 response.
      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: Response
      Returns a List containing the controls included with this response. The returned List may be modified if permitted by this response.
      Specified by:
      getControls in interface Response
      Returns:
      A List containing the controls.

    • getURIs

      List<String> getURIs()
      Returns a List containing the continuation reference URIs included with this search result reference. The returned List may be modified if permitted by this search result reference.
      Returns:
      A List containing the continuation reference URIs.