Package io.oxia.client.api.exceptions
package io.oxia.client.api.exceptions
Checked exceptions raised by the Oxia client.
All client-side errors extend the abstract OxiaException. The asynchronous client surfaces them by completing
the returned CompletableFuture exceptionally. The synchronous client
throws the ones that a method declares directly, and the others in an unchecked OxiaUncheckedException.
UnexpectedVersionIdException— a conditional put or delete failed because the server's versionId does not match the expected one.KeyAlreadyExistsException— a put withIfRecordDoesNotExistfound an existing record.SessionDoesNotExistException— an operation tied to an ephemeral session was attempted after the session expired.InvalidArgumentException— the server rejected a put or delete range for an invalid argument, such as a sequential put that doesn't fit its sequence.UnsupportedAuthenticationException— the configured authentication plugin could not be loaded.ResourceUnavailableException— the operation failed while the server was temporarily unavailable. The outcome of a write that fails with it is unknown: it may have been applied.NamespaceNotFoundException— the namespace of the client does not exist on the server.RequestTimeoutException— the operation did not complete within the request timeout. The outcome of a write that fails with it is unknown.AlreadyClosedException— the client, or a resource that it uses, has been closed.UnknownException— any other error of the server or of the client transport. The outcome of a write that fails with it is unknown.
-
ExceptionsClassDescriptionThe client, or a resource that it uses, has been closed, so the operation was not sent.An operation was rejected for an invalid argument, and was not applied.The key already exists at the server.The namespace of the client does not exist on the server.A super-class of exceptions describing errors that occurred on an Oxia server.Wraps a checked exception with an unchecked one, as
UncheckedIOExceptiondoes for anIOException.The operation did not complete within the request timeout.The operation failed while the server was unavailable, e.g.The session does not exist on the server.The versionId at the server did not that match supplied in the call.An error of the server or of the client transport that has no more specific exception, e.g.Unsupported authentication exception thrown by Oxia client.