Package org.forgerock.opendj.ldap.messages

Class AbstractExtendedResultDecoder<S extends ExtendedResult>

  • Type Parameters:
    S - The type of result.
    All Implemented Interfaces:
    ExtendedResultDecoder<S>
    public abstract class AbstractExtendedResultDecoder<S extends ExtendedResult>
extends Object
implements ExtendedResultDecoder<S>
    This class provides a skeletal implementation of the ExtendedResultDecoder interface, to minimize the effort required to implement this interface.

    • Constructor Detail

      • AbstractExtendedResultDecoder

        protected AbstractExtendedResultDecoder()
        Creates a new abstract extended result decoder.

    • Method Detail

      • adaptDecodeException

        public S adaptDecodeException​(DecodeException exception)
        Description copied from interface: ExtendedResultDecoder
        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.
        Specified by:
        adaptDecodeException in interface ExtendedResultDecoder<S extends ExtendedResult>
        Parameters:
        exception - The decoding exception to be adapted.
        Returns:
        An extended operation error result representing the decoding exception.

      • decodeExtendedResult

        public abstract S decodeExtendedResult​(ExtendedResult result,
                                       DecodeOptions options)
                                throws DecodeException
        Description copied from interface: ExtendedResultDecoder
        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.
        Specified by:
        decodeExtendedResult in interface ExtendedResultDecoder<S extends ExtendedResult>
        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

        public abstract S newExtendedErrorResult​(ResultCode resultCode,
                                         String matchedDN,
                                         CharSequence diagnosticMessage)
        Description copied from interface: ExtendedResultDecoder
        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.
        Specified by:
        newExtendedErrorResult in interface ExtendedResultDecoder<S extends ExtendedResult>
        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.