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

Class ThingPreconditionFailedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

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

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

All Implemented Interfaces:

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

@Immutable
public final class ThingPreconditionFailedException
extends org.eclipse.ditto.base.model.exceptions.DittoRuntimeException
implements 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 final class	ThingPreconditionFailedException.Builder	A mutable builder with a fluent API for a ThingPreconditionFailedException.

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

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

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

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

Field Summary

Fields

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

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

ERROR_CODE_PREFIX

Method Summary

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

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

appendToJson, asDittoRuntimeException, equals, fromJson, fromMessage, getDescription, getDittoHeaders, getErrorCode, getHref, getHref, getHttpStatus, getHttpStatus, getImplementedSchemaVersion, getManifest, hashCode, 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.base.model.json.Jsonifiable

getLatestSchemaVersion, getSupportedSchemaVersions, implementsSchemaVersion, implementsSchemaVersion, toJsonString

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

toJson, toJsonString, toJsonString

Field Details

ERROR_CODE

public static final String ERROR_CODE

Error code of this exception.

See Also:

• Constant Field Values

Method Details

newBuilder

public static ThingPreconditionFailedException.Builder newBuilder()

A mutable builder for a ThingPreconditionFailedException.

Returns:

the builder.

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.base.model.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.base.model.exceptions.DittoRuntimeException setDittoHeaders(org.eclipse.ditto.base.model.headers.DittoHeaders dittoHeaders)

Specified by:

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