Package org.eclipse.ditto.signals.commands.things.exceptions

Class ThingPreconditionFailedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.eclipse.ditto.model.base.exceptions.DittoRuntimeException

org.eclipse.ditto.signals.commands.things.exceptions.ThingPreconditionFailedException

All Implemented Interfaces:

Serializable, org.eclipse.ditto.model.base.headers.WithDittoHeaders<org.eclipse.ditto.model.base.exceptions.DittoRuntimeException>, org.eclipse.ditto.model.base.headers.WithManifest, org.eclipse.ditto.model.base.json.Jsonifiable<org.eclipse.ditto.json.JsonObject>, org.eclipse.ditto.model.base.json.Jsonifiable.WithPredicate<org.eclipse.ditto.json.JsonObject,org.eclipse.ditto.json.JsonField>, org.eclipse.ditto.model.things.ThingException

@Immutable
public final class ThingPreconditionFailedException
extends org.eclipse.ditto.model.base.exceptions.DittoRuntimeException
implements org.eclipse.ditto.model.things.ThingException

Thrown when validating a precondition header fails on a Thing or one of its sub-entities.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ThingPreconditionFailedException.Builder	A mutable builder with a fluent API for a ThingPreconditionFailedException.

Nested classes/interfaces inherited from class org.eclipse.ditto.model.base.exceptions.DittoRuntimeException

org.eclipse.ditto.model.base.exceptions.DittoRuntimeException.JsonFields

Nested classes/interfaces inherited from interface org.eclipse.ditto.model.base.json.Jsonifiable

org.eclipse.ditto.model.base.json.Jsonifiable.WithFieldSelector, org.eclipse.ditto.model.base.json.Jsonifiable.WithFieldSelectorAndPredicate<T extends Object>, org.eclipse.ditto.model.base.json.Jsonifiable.WithPointer<J extends org.eclipse.ditto.json.JsonValue>, org.eclipse.ditto.model.base.json.Jsonifiable.WithPredicate<J extends org.eclipse.ditto.json.JsonValue,T extends Object>

Field Summary

Fields

Modifier and Type	Field	Description
static String	ERROR_CODE	Error code of this exception.

Fields inherited from interface org.eclipse.ditto.model.things.ThingException

ERROR_CODE_PREFIX

Method Summary

Modifier and Type	Method	Description
static ThingPreconditionFailedException	fromJson(org.eclipse.ditto.json.JsonObject jsonObject, org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)	Constructs a new ThingPreconditionFailedException object with the exception message extracted from the given JSON object.
static ThingPreconditionFailedException.Builder	newBuilder(String conditionalHeaderName, String expected, String actual)	A mutable builder for a ThingPreconditionFailedException.
org.eclipse.ditto.model.base.exceptions.DittoRuntimeException	setDittoHeaders(org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)

Methods inherited from class org.eclipse.ditto.model.base.exceptions.DittoRuntimeException

appendToJson, asDittoRuntimeException, equals, fromJson, fromMessage, fromUnknownErrorJson, getBuilder, getDescription, getDittoHeaders, getEmptyBuilder, getErrorCode, getHref, getImplementedSchemaVersion, getManifest, getStatusCode, hashCode, newBuilder, newBuilder, readDescription, readHRef, readMessage, toBuilder, toJson, toJson, toString

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.ditto.model.base.json.Jsonifiable

getLatestSchemaVersion, getSupportedSchemaVersions, implementsSchemaVersion, implementsSchemaVersion, toJsonString

Methods inherited from interface org.eclipse.ditto.model.base.json.Jsonifiable.WithPredicate

toJson, toJsonString, toJsonString

Field Detail

ERROR_CODE

public static final String ERROR_CODE

Error code of this exception.

See Also:

Constant Field Values

Method Detail

newBuilder

public static ThingPreconditionFailedException.Builder newBuilder(String conditionalHeaderName,
                                                                  String expected,
                                                                  String actual)

A mutable builder for a ThingPreconditionFailedException.

Parameters:

conditionalHeaderName - the name of the conditional header.

expected - the expected value.

actual - the actual ETag value.

Returns:

the builder.

fromJson

public static ThingPreconditionFailedException fromJson(org.eclipse.ditto.json.JsonObject jsonObject,
                                                        org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)

Constructs a new ThingPreconditionFailedException object with the exception message extracted from the given JSON object.

Parameters:

jsonObject - the JSON to read the DittoRuntimeException.JsonFields.MESSAGE field from.

dittoHeaders - the headers of the command which resulted in this exception.

Returns:

the new ThingPreconditionFailedException.

Throws:

NullPointerException - if any argument is null.

org.eclipse.ditto.json.JsonMissingFieldException - if this JsonObject did not contain an error message.

org.eclipse.ditto.json.JsonParseException - if the passed in jsonObject was not in the expected format.

setDittoHeaders

public org.eclipse.ditto.model.base.exceptions.DittoRuntimeException setDittoHeaders(org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)

Specified by:

setDittoHeaders in interface org.eclipse.ditto.model.base.headers.WithDittoHeaders<org.eclipse.ditto.model.base.exceptions.DittoRuntimeException>

Overrides:

setDittoHeaders in class org.eclipse.ditto.model.base.exceptions.DittoRuntimeException