io.temporal.failure

Class ApplicationFailure

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.temporal.failure.TemporalException

io.temporal.failure.TemporalFailure

io.temporal.failure.ApplicationFailure

All Implemented Interfaces:

java.io.Serializable

public final class ApplicationFailure
extends TemporalFailure

Application failure is used to communicate application specific failures between workflows and activities.

Throw this exception to have full control over type and details if the exception delivered to the caller workflow or client.

Any unhandled exception which doesn't extend TemporalFailure is converted to an instance of this class before being returned to a caller.

The type property is used by RetryOptions to determine if an instance of this exception is non retryable. Another way to avoid retrying an exception of this type is by setting nonRetryable flag to @{code true}.

The conversion of an exception that doesn't extend TemporalFailure to an ApplicationFailure is done as following:

• type is set to the exception full type name.
• message is set to the exception message
• nonRetryable is set to false
• details are set to null
• stack trace is copied from the original exception

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
Values	getDetails()
java.lang.String	getType()
boolean	isNonRetryable()
static ApplicationFailure	newFailure(java.lang.String message, java.lang.String type, java.lang.Object... details) New ApplicationFailure with isNonRetryable() flag set to false.
static ApplicationFailure	newNonRetryableFailure(java.lang.String message, java.lang.String type, java.lang.Object... details) New ApplicationFailure with isNonRetryable() flag set to true.
void	setDataConverter(DataConverter converter)
void	setNonRetryable(boolean nonRetryable)

Methods inherited from class io.temporal.failure.TemporalFailure

getOriginalMessage

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

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

Method Detail

newFailure

public static ApplicationFailure newFailure(java.lang.String message,
                                            java.lang.String type,
                                            java.lang.Object... details)

New ApplicationFailure with isNonRetryable() flag set to false. Note that this exception still can be not retried by the service if its type is included into doNotRetry property of the correspondent retry policy.

Parameters:

message - optional error message

type - optional error type that is used by RetryOptions.Builder.setDoNotRetry(String...).

details - optional details about the failure. They are serialized using the same approach as arguments and results.

newNonRetryableFailure

public static ApplicationFailure newNonRetryableFailure(java.lang.String message,
                                                        java.lang.String type,
                                                        java.lang.Object... details)

New ApplicationFailure with isNonRetryable() flag set to true.

It means that this exception is not going to be retried even if it is not included into retry policy doNotRetry list.

Parameters:

message - optional error message

type - optional error type

details - optional details about the failure. They are serialized using the same approach as arguments and results.

getType

public java.lang.String getType()

getDetails

public Values getDetails()

setNonRetryable

public void setNonRetryable(boolean nonRetryable)

isNonRetryable

public boolean isNonRetryable()

setDataConverter

public void setDataConverter(DataConverter converter)

Overrides:

setDataConverter in class TemporalFailure