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

Class ThingPreconditionFailedException

  • All Implemented Interfaces:
    java.io.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 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 java.lang.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 java.lang.Object>

    • Field Summary

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

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      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​(java.lang.String conditionalHeaderName, java.lang.String expected, java.lang.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 Detail

      • ERROR_CODE

        public static final java.lang.String ERROR_CODE
        Error code of this exception.
        See Also:
        Constant Field Values

    • Method Detail

      • newBuilder

        public static ThingPreconditionFailedException.Builder newBuilder​(java.lang.String conditionalHeaderName,
                                                                  java.lang.String expected,
                                                                  java.lang.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:
        java.lang.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>