Package org.opendaylight.controller.cluster.access.concepts

Class RequestFailure<T extends WritableIdentifier,C extends RequestFailure<T,C>>

java.lang.Object

org.opendaylight.controller.cluster.access.concepts.Message<T,C>

org.opendaylight.controller.cluster.access.concepts.Response<T,C>

org.opendaylight.controller.cluster.access.concepts.RequestFailure<T,C>

Type Parameters:

T - Target identifier type

C - Message class

All Implemented Interfaces:

Serializable, Immutable, MutationBehaviour<Immutable>

Direct Known Subclasses:

ConnectClientFailure, LocalHistoryFailure, TransactionFailure

@Beta
public abstract class RequestFailure<T extends WritableIdentifier,C extends RequestFailure<T,C>>
extends Response<T,C>

A failure response to a Request. Contains a RequestException detailing the cause for this failure.

Author:

Robert Varga

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	RequestFailure.SerialForm<T extends WritableIdentifier,C extends RequestFailure<T,C>>	Externalizable proxy for use with RequestFailure subclasses.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RequestFailure(@NonNull C failure, @NonNull ABIVersion version)
protected	RequestFailure(@NonNull T target, long sequence, @NonNull RequestException cause)

Method Summary

Modifier and Type	Method	Description
protected MoreObjects.ToStringHelper	addToStringAttributes(MoreObjects.ToStringHelper toStringHelper)	Add attributes to the output of Message.toString().
protected abstract RequestFailure.SerialForm<T,C>	externalizableProxy(ABIVersion version)	Instantiate a serialization proxy for this object for the target ABI version.
@NonNull RequestException	getCause()	Return the failure cause.
boolean	isHardFailure()	Return an indication of whether this a hard failure.

Methods inherited from class org.opendaylight.controller.cluster.access.concepts.Message

cloneAsVersion, getSequence, getTarget, getVersion, toString, toVersion, writeReplace

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestFailure

protected RequestFailure(@NonNull C failure,
                         @NonNull ABIVersion version)

RequestFailure

protected RequestFailure(@NonNull T target,
                         long sequence,
                         @NonNull RequestException cause)

Method Detail

getCause

public final @NonNull RequestException getCause()

Return the failure cause.

Returns:

Failure cause.

isHardFailure

public final boolean isHardFailure()

Return an indication of whether this a hard failure. Hard failures must not be retried but need to be treated as authoritative response to a request.

Returns:

True if this represents a hard failure, false otherwise.

addToStringAttributes

protected MoreObjects.ToStringHelper addToStringAttributes(MoreObjects.ToStringHelper toStringHelper)

Description copied from class: Message

Add attributes to the output of Message.toString(). Subclasses wanting to contribute additional information should override this method. Any null attributes will be omitted from the output.

Overrides:

addToStringAttributes in class Message<T extends WritableIdentifier,C extends RequestFailure<T,C>>

Parameters:

toStringHelper - a MoreObjects.ToStringHelper instance

Returns:

The MoreObjects.ToStringHelper passed in as argument

externalizableProxy

protected abstract RequestFailure.SerialForm<T,C> externalizableProxy(ABIVersion version)

Description copied from class: Message

Instantiate a serialization proxy for this object for the target ABI version. Implementations should return different objects for incompatible ABIVersions. This method should never fail, as any compatibility checks should have been done by Message.cloneAsVersion(ABIVersion).

Specified by:

externalizableProxy in class Message<T extends WritableIdentifier,C extends RequestFailure<T,C>>

Parameters:

version - Requested ABI version

Returns:

Proxy for this object