com.hazelcast.ringbuffer

Class StaleSequenceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.hazelcast.ringbuffer.StaleSequenceException

All Implemented Interfaces:

SilentException, com.hazelcast.spi.impl.operationservice.WrappableException<StaleSequenceException>, Serializable

public class StaleSequenceException
extends RuntimeException
implements SilentException, com.hazelcast.spi.impl.operationservice.WrappableException<StaleSequenceException>

An RuntimeException that is thrown when accessing an item in the Ringbuffer using a sequence that is smaller than the current head sequence and that the ringbuffer store is disabled. This means that the item isn't available in the ringbuffer and it cannot be loaded from the store either, thus being completely unavailable.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StaleSequenceException(String message, long headSeq) Creates a StaleSequenceException with the given message.

Method Summary

Modifier and Type	Method and Description
long	getHeadSeq() Returns the last known head sequence.
StaleSequenceException	wrap() Returns a new exception of the same type as this exception, using this exception as its cause.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

StaleSequenceException

public StaleSequenceException(String message,
                              long headSeq)

Creates a StaleSequenceException with the given message.

Parameters:

message - the message

headSeq - the last known head sequence.

Method Detail

getHeadSeq

public long getHeadSeq()

Returns the last known head sequence. Beware that this sequence could already be stale again if you want to use it to do a Ringbuffer.readOne(long).

Returns:

last known head sequence.

wrap

public StaleSequenceException wrap()

Description copied from interface: com.hazelcast.spi.impl.operationservice.WrappableException

Returns a new exception of the same type as this exception, using this exception as its cause. This is useful when this is a remote or async exception, because it's stack trace is disconnected from the client code that handles the exception. The returned exception includes all the state of this exception, while providing the local stack trace and the remote/async stack trace in its cause.

Specified by:

wrap in interface com.hazelcast.spi.impl.operationservice.WrappableException<StaleSequenceException>

Returns:

a new WrappableException with this as its cause.