Package org.forgerock.opendj.ldap.responses

Interface ExtendedResultDecoder<S extends ExtendedResult>

Type Parameters:
S - The type of result.
All Known Implementing Classes:
AbstractExtendedResultDecoder
public interface ExtendedResultDecoder<S extends ExtendedResult>
A factory interface for decoding a generic extended result as an extended result of specific type.

  • Method Details

    • adaptDecodeException

      S adaptDecodeException(DecodeException exception)
      Creates a new extended operation error result using the provided decoding exception. This method should be used to adapt DecodeException encountered while decoding an extended request or result. The returned error result will have the result code ResultCode.PROTOCOL_ERROR.
      Parameters:
      exception - The decoding exception to be adapted.
      Returns:
      An extended operation error result representing the decoding exception.
      Throws:
      NullPointerException - If exception was null.

    • adaptExtendedResultHandler

      <R extends ExtendedResult> LdapResultHandler<S> adaptExtendedResultHandler(ExtendedRequest<R> request, LdapResultHandler<? super R> resultHandler, DecodeOptions options)
      Adapts the provided extended result handler into a result handler which is compatible with this extended result decoder. Extended results handled by the returned handler will be automatically converted and passed to the provided result handler. Decoding errors encountered while decoding the extended result will be converted into protocol errors.
      Type Parameters:
      R - The type of result handler to be adapted.
      Parameters:
      request - The extended request whose result handler is to be adapted.
      resultHandler - The extended result handler which is to be adapted.
      options - The set of decode options which should be used when decoding the extended operation result.
      Returns:
      A result handler which is compatible with this extended result decoder.

    • decodeExtendedResult

      S decodeExtendedResult(ExtendedResult result, DecodeOptions options) throws DecodeException
      Decodes the provided extended operation result as a Result of type S. This method is called when an extended result is received from the server. The result may indicate success or failure of the extended request.
      Parameters:
      result - The extended operation result to be decoded.
      options - The set of decode options which should be used when decoding the extended operation result.
      Returns:
      The decoded extended operation result.
      Throws:
      DecodeException - If the provided extended operation result could not be decoded. For example, if the request name was wrong, or if the request value was invalid.

    • newExtendedErrorResult

      S newExtendedErrorResult(ResultCode resultCode, String matchedDN, String diagnosticMessage)
      Creates a new extended error result using the provided result code, matched DN, and diagnostic message. This method is called when a generic failure occurs, such as a connection failure, and the error result needs to be converted to a Result of type S.
      Parameters:
      resultCode - The result code.
      matchedDN - The matched DN, which may be empty if none was provided.
      diagnosticMessage - The diagnostic message, which may be empty if none was provided.
      Returns:
      The decoded extended operation error result.
      Throws:
      NullPointerException - If resultCode, matchedDN, or diagnosticMessage were null.