Package org.forgerock.opendj.ldap.responses

Interface GenericIntermediateResponse

All Superinterfaces:
IntermediateResponse, Response
public interface GenericIntermediateResponse extends IntermediateResponse
A Generic Intermediate response provides a mechanism for communicating unrecognized or unsupported Intermediate responses to the client.

  • Method Details

    • addControl

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

    • 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 IntermediateResponse
      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 IntermediateResponse
      Specified by:
      getControls in interface Response
      Returns:
      A List containing the controls.

    • getOID

      String getOID()
      Description copied from interface: IntermediateResponse
      Returns the numeric OID, if any, associated with this intermediate response.
      Specified by:
      getOID in interface IntermediateResponse
      Returns:
      The numeric OID associated with this intermediate response, or null if there is no OID.

    • getValue

      ByteString getValue()
      Description copied from interface: IntermediateResponse
      Returns the value, if any, associated with this intermediate response. Its format is defined by the specification of this intermediate response.
      Specified by:
      getValue in interface IntermediateResponse
      Returns:
      The value associated with this intermediate response, or null if there is no value.

    • hasValue

      boolean hasValue()
      Description copied from interface: IntermediateResponse
      Returns true if this intermediate response has a value. In some circumstances it may be useful to determine if an intermediate response has a value, without actually calculating the value and incurring any performance costs.
      Specified by:
      hasValue in interface IntermediateResponse
      Returns:
      true if this intermediate response has a value, or false if there is no value.

    • setOID

      GenericIntermediateResponse setOID(String oid)
      Sets the numeric OID, if any, associated with this intermediate response.
      Parameters:
      oid - The numeric OID associated with this intermediate response, or null if there is no value.
      Returns:
      This generic intermediate response.
      Throws:
      UnsupportedOperationException - If this intermediate response does not permit the response name to be set.

    • setValue

      GenericIntermediateResponse setValue(Object value)
      Sets the value, if any, associated with this intermediate response. Its format is defined by the specification of this intermediate response.

      If value is not an instance of ByteString then it will be converted using the ByteString.valueOfObject(Object) method.

      Parameters:
      value - The value associated with this intermediate response, or null if there is no value.
      Returns:
      This generic intermediate response.
      Throws:
      UnsupportedOperationException - If this intermediate response does not permit the response value to be set.