Package 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:
-
Constructor Summary
ConstructorDescriptionStaleSequenceException
(String message, long headSeq) Creates a StaleSequenceException with the given message.StaleSequenceException
(String message, long headSeq, Throwable cause) -
Method Summary
Modifier and TypeMethodDescriptionlong
Returns the last known head sequence.wrap()
Returns a new exception of the same type asthis
exception, usingthis
exception as its cause.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
StaleSequenceException
Creates a StaleSequenceException with the given message.- Parameters:
message
- the messageheadSeq
- the last known head sequence.
-
StaleSequenceException
-
-
Method Details
-
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 aRingbuffer.readOne(long)
.- Returns:
- last known head sequence.
-
wrap
Description copied from interface:com.hazelcast.spi.impl.operationservice.WrappableException
Returns a new exception of the same type asthis
exception, usingthis
exception as its cause. This is useful whenthis
is a remote or async exception, because its stack trace is disconnected from the client code that handles the exception. The returned exception includes all the state ofthis
exception, while providing the local stack trace and the remote/async stack trace in itscause
.- Specified by:
wrap
in interfacecom.hazelcast.spi.impl.operationservice.WrappableException<StaleSequenceException>
- Returns:
- a new
WrappableException
withthis
as itscause
.
-