Package org.eclipse.ditto.json

Class JsonRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.eclipse.ditto.json.JsonRuntimeException

All Implemented Interfaces:

Serializable, JsonException

Direct Known Subclasses:

JsonFieldSelectorInvalidException, JsonKeyInvalidException, JsonMissingFieldException, JsonParseException, JsonPointerInvalidException

public class JsonRuntimeException
extends RuntimeException
implements JsonException

Common base type of all unchecked JSON exceptions.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	JsonRuntimeException.Builder	A mutable builder for a JsonRuntimeException.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	JsonRuntimeException(String errorCode, String message, String description, Throwable cause, URI href)	Constructs a new JsonRuntimeException object with the specified values.

Method Summary

Modifier and Type	Method	Description
Optional<String>	getDescription()	Returns the description which should be reported to the user.
String	getErrorCode()	Returns the error code to uniquely identify this exception.
Optional<URI>	getHref()	Returns a link with which the user can find further information regarding this exception.
static JsonExceptionBuilder	newBuilder(String errorCode)	Returns a builder for fluently creating instances of JsonRuntimeExceptions..

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

Constructor Detail

JsonRuntimeException

protected JsonRuntimeException(String errorCode,
                               @Nullable
                               String message,
                               @Nullable
                               String description,
                               @Nullable
                               Throwable cause,
                               @Nullable
                               URI href)

Constructs a new JsonRuntimeException object with the specified values.

Parameters:

errorCode - the error code of the exception.

message - the detail message for later retrieval with Throwable.getMessage().

description - a description with further information about the exception.

cause - the cause of the exception for later retrieval with Throwable.getCause().

href - a link to a resource which provides further information about the exception.

Throws:

NullPointerException - if errorCode is null.

IllegalArgumentException - if errorCode is empty.

Method Detail

newBuilder

public static JsonExceptionBuilder newBuilder(String errorCode)

Returns a builder for fluently creating instances of JsonRuntimeExceptions..

Parameters:

errorCode - a code which uniquely identifies the exception.

Returns:

a new builder for JsonRuntimeException objects.

Throws:

NullPointerException - if errorCode is null.

IllegalArgumentException - if errorCode is empty.

getErrorCode

public String getErrorCode()

Description copied from interface: JsonException

Returns the error code to uniquely identify this exception.

Specified by:

getErrorCode in interface JsonException

Returns:

the error code.

getDescription

public Optional<String> getDescription()

Description copied from interface: JsonException

Returns the description which should be reported to the user.

Specified by:

getDescription in interface JsonException

Returns:

the description.

getHref

public Optional<URI> getHref()

Description copied from interface: JsonException

Returns a link with which the user can find further information regarding this exception.

Specified by:

getHref in interface JsonException

Returns:

a link to provide the user with further information about this exception.