Class 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 Details

    • StaleSequenceException

      public StaleSequenceException(String message, long headSeq)
      Creates a StaleSequenceException with the given message.
      Parameters:
      message - the message
      headSeq - the last known head sequence.
    • StaleSequenceException

      public StaleSequenceException(String message, long headSeq, Throwable cause)
  • 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 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 its 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.