io.nats.client

Class RequestFailureException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

io.nats.client.RequestFailureException

All Implemented Interfaces:

java.io.Serializable

public class RequestFailureException
extends java.io.IOException

Carries the detail of a request that came back without a response, but only when Options.Builder.advancedRequestBehavior() is enabled. It wraps a RequestFailureMessage and exposes a specific RequestFailureReason plus the connection status and last protocol error captured at the moment the request failed, so the actual cause (timeout vs. reconnect vs. permissions vs. no-responders) can be told apart. The original caught exception is chained as the cause (an ExecutionException is unwrapped to its cause; see RequestFailureMessage.getCause()). Extends IOException so existing catch blocks and signatures are unaffected.

JetStream requests (publish, stream/consumer management) throw this in place of the generic "Timeout or no response waiting for NATS JetStream server" IOException. Core Connection.request(...) calls instead return the RequestFailureMessage carrier directly (it is a Message), which callers can inspect or wrap in this exception.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RequestFailureException(RequestFailureMessage rfm)

Method Summary

Modifier and Type	Method and Description
Connection.Status	getConnectionStatus()
java.lang.String	getLastError()
RequestFailureReason	getReason()

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RequestFailureException

public RequestFailureException(RequestFailureMessage rfm)

Method Detail

getReason

public RequestFailureReason getReason()

Returns:

the classified reason the request returned no response

getConnectionStatus

public Connection.Status getConnectionStatus()

Returns:

the connection status at the moment the request failed

getLastError

public java.lang.String getLastError()

Returns:

the last protocol error reported by the server (may be null or empty)