org.forgerock.opendj.ldap.messages

Class AbstractExtendedResultDecoder<S extends ExtendedResult>

java.lang.Object

org.forgerock.opendj.ldap.messages.AbstractExtendedResultDecoder<S>

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 Summary

Constructors

Modifier	Constructor and Description
protected	AbstractExtendedResultDecoder() Creates a new abstract extended result decoder.

Method Summary

Modifier and Type	Method and Description
S	adaptDecodeException(DecodeException exception) Creates a new extended operation error result using the provided decoding exception.
abstract S	decodeExtendedResult(ExtendedResult result, DecodeOptions options) Decodes the provided extended operation result as a Result of type S.
abstract S	newExtendedErrorResult(ResultCode resultCode, String matchedDN, CharSequence diagnosticMessage) Creates a new extended error result using the provided result code, matched DN, and diagnostic message.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.forgerock.opendj.ldap.messages.ExtendedResultDecoder

getExtendedResultClass

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.