Package co.ankatech.ankasecure.sdk.exception
package co.ankatech.ankasecure.sdk.exception
-
ClassDescriptionA uniform, localization-ready exception thrown by all public ANKASecure SDK APIs.Thrown when a cryptographic operation fails due to local processing errors.The fail-closed outcome of a streaming decrypt-then-verify whose two-verdict trailing part is
INVALID: the decrypted plaintext was discarded and no file exists at the destination.Thrown when a file-output operation cannot commit its result because a file already exists at the destination andFAIL_IF_EXISTS(the default) is in effect.A streaming request that requires HTTP/2 was about to be sent over a connection that negotiated something else, and was refused before any request byte was written.Thrown when input validation fails for SDK operations.Thrown when a file operation fails on the caller's own file system: an input file could not be read, or the result — or a working file derived from the input — could not be written.What the operation needed of the file.Thrown by the auto-paginatinglistAllKeys(filters)when the server reports more pages than the SDK's defensive ceiling allows (ceil(totalElements/size)+1iterations, hard-capped at 10000 pages).A request under PQC transport was refused by the SDK, either because the response cannot be trusted as the server's answer, or because completing it would take a route that PQC transport does not protect and the caller did not choose that route.Why the request was refused.High-level, protocol-agnostic error categories recognised by the SDK.Thrown when a streaming / atomic file-output operation cannot create its quarantine sidecar (<destination>.part) because a file already exists at the sidecar path — the signature of a stale sidecar orphaned by a prior crashed or force-killed operation (theCREATE_NEWsidecar is normally deleted on BOTH the success and the fail-closed paths, so a surviving one indicates an earlier abnormal termination).Thrown when a streaming file-output operation cannot commit its result because the server-emitted end-of-stream integrity verdict did not pass (fail-closed).The request body could not be written to completion, so nothing was committed.Thrown when the server rejects a previously-issued access token with HTTP 401 on a data-plane operation.