Package com.pkgrove.pkgrovekit.storage

Class StorageException

  • All Implemented Interfaces:
    java.io.Serializable 
    
public class StorageException
extends RuntimeException

    Typed storage outcomes (HEL-236). Every failure an implementation surfaces is one of these — callers classify by TYPE, never by parsing provider message strings.

    retrySafe is the retry contract: true means re-running the SAME operation cannot corrupt state (idempotent read/delete, or a write whose source is repeatable and whose condition still guards it); false means a blind retry is UNSAFE (one-shot source already partially consumed, or a non-idempotent sequence) and the caller must re-plan, not re-fire.

    Security rule: messages may contain object KEYS (validated to carry no secrets — see ObjectKey) but never credentials, presigned query strings, or row values.

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description

    • Constructor Summary

      Constructors 
      Constructor Description

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description

    • Method Summary

      Modifier and Type Method Description
      final Boolean getRetrySafe()

      • Methods inherited from class kotlin.Throwable

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

      • Methods inherited from class java.lang.Object

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