org.eclipse.ditto.signals.commands.things.modify

Class CreateThing

java.lang.Object

org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>

org.eclipse.ditto.signals.commands.things.modify.CreateThing

All Implemented Interfaces:

org.eclipse.ditto.model.base.headers.WithDittoHeaders<CreateThing>, 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.signals.base.Signal<CreateThing>, org.eclipse.ditto.signals.base.WithId, org.eclipse.ditto.signals.base.WithName, org.eclipse.ditto.signals.base.WithOptionalEntity, org.eclipse.ditto.signals.base.WithResource, org.eclipse.ditto.signals.base.WithThingId, org.eclipse.ditto.signals.base.WithType, org.eclipse.ditto.signals.commands.base.Command<CreateThing>, ThingModifyCommand<CreateThing>, ThingCommand<CreateThing>

@Immutable
public final class CreateThing
extends org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>
implements ThingModifyCommand<CreateThing>

This command creates a new Thing. It contains the full Thing including the Thing ID which should be used for creation. If the Thing ID is already in the system, a response with a status code 409 (Conflict) will be generated.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.ditto.signals.commands.things.ThingCommand

ThingCommand.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>, 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>

Field Summary

Fields

Modifier and Type	Field and Description
static org.eclipse.ditto.json.JsonFieldDefinition<org.eclipse.ditto.json.JsonObject>	JSON_INITIAL_POLICY Json Field definition for the optional initial "inline" policy when creating a Thing.
static String	NAME Name of the "Create Thing" command.
static String	TYPE Type of this command.

Fields inherited from interface org.eclipse.ditto.signals.commands.things.ThingCommand

RESOURCE_TYPE, TYPE_PREFIX

Fields inherited from interface org.eclipse.ditto.signals.commands.base.Command

TYPE_QUALIFIER

Method Summary

Modifier and Type	Method and Description
protected void	appendPayload(org.eclipse.ditto.json.JsonObjectBuilder jsonObjectBuilder, org.eclipse.ditto.model.base.json.JsonSchemaVersion schemaVersion, Predicate<org.eclipse.ditto.json.JsonField> thePredicate)
protected boolean	canEqual(Object other)
boolean	changesAuthorization() Checks whether this command may change authorization of the Thing.
boolean	equals(Object obj)
static CreateThing	fromJson(org.eclipse.ditto.json.JsonObject jsonObject, org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders) Creates a new CreateThing from a JSON object.
static CreateThing	fromJson(String jsonString, org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders) Creates a new CreateThing from a JSON string.
Optional<org.eclipse.ditto.json.JsonValue>	getEntity(org.eclipse.ditto.model.base.json.JsonSchemaVersion schemaVersion)
Optional<org.eclipse.ditto.json.JsonObject>	getInitialPolicy()
org.eclipse.ditto.json.JsonPointer	getResourcePath()
org.eclipse.ditto.model.things.Thing	getThing() Returns the Thing to create.
String	getThingId()
int	hashCode()
static CreateThing	of(org.eclipse.ditto.model.things.Thing newThing, org.eclipse.ditto.json.JsonObject initialPolicy, org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders) Returns a Command for creating a new Thing which is passed as argument.
CreateThing	setDittoHeaders(org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)
String	toString()

Methods inherited from class org.eclipse.ditto.signals.commands.base.AbstractCommand

getDittoHeaders, getManifest, getType, toJson

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.ditto.signals.commands.things.ThingCommand

getId, getResourceType, getTypePrefix

Methods inherited from interface org.eclipse.ditto.signals.commands.base.Command

getImplementedSchemaVersion, toJson, toJson

Methods inherited from interface org.eclipse.ditto.signals.base.Signal

getName

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

toJson, toJsonString, toJsonString

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.headers.WithDittoHeaders

getDittoHeaders

Methods inherited from interface org.eclipse.ditto.model.base.headers.WithManifest

getManifest

Methods inherited from interface org.eclipse.ditto.signals.base.WithType

getType

Methods inherited from interface org.eclipse.ditto.signals.base.WithOptionalEntity

getEntity

Field Detail

NAME

public static final String NAME

Name of the "Create Thing" command.

See Also:

Constant Field Values

TYPE

public static final String TYPE

Type of this command.

See Also:

Constant Field Values

JSON_INITIAL_POLICY

public static final org.eclipse.ditto.json.JsonFieldDefinition<org.eclipse.ditto.json.JsonObject> JSON_INITIAL_POLICY

Json Field definition for the optional initial "inline" policy when creating a Thing.

Method Detail

of

public static CreateThing of(org.eclipse.ditto.model.things.Thing newThing,
                             @Nullable
                             org.eclipse.ditto.json.JsonObject initialPolicy,
                             org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)

Returns a Command for creating a new Thing which is passed as argument.

Parameters:

newThing - the new Thing to create.

initialPolicy - the initial Policy to set for the Thing - may be null.

dittoHeaders - the headers of the command.

Returns:

a Command for creating the provided new Thing.

Throws:

NullPointerException - if any argument is null.

org.eclipse.ditto.model.things.ThingIdInvalidException - if the Thing's ID is not valid.

org.eclipse.ditto.model.things.AclInvalidException - if the Access Control List of thing does not contain at least one authorization subject which has the permissions Permission.READ, Permission.WRITE and Permission.WRITE.

fromJson

public static CreateThing fromJson(String jsonString,
                                   org.eclipse.ditto.model.base.headers.DittoHeaders dittoHeaders)

Creates a new CreateThing from a JSON string.

Parameters:

jsonString - the JSON string of which the command is to be created.

dittoHeaders - the headers of the command.

Returns:

the command.

Throws:

NullPointerException - if jsonString is null.

IllegalArgumentException - if jsonString is empty.

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

fromJson

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

Creates a new CreateThing from a JSON object.

Parameters:

jsonObject - the JSON object of which the command is to be created.

dittoHeaders - the headers of the command.

Returns:

the command.

Throws:

NullPointerException - if jsonObject is null.

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

getThing

public org.eclipse.ditto.model.things.Thing getThing()

Returns the Thing to create.

Returns:

the Thing to create.

getInitialPolicy

public Optional<org.eclipse.ditto.json.JsonObject> getInitialPolicy()

Returns:

the initial Policy if there should be one applied when creating the Thing.

getThingId

public String getThingId()

Specified by:

getThingId in interface org.eclipse.ditto.signals.base.WithThingId

getEntity

public Optional<org.eclipse.ditto.json.JsonValue> getEntity(org.eclipse.ditto.model.base.json.JsonSchemaVersion schemaVersion)

Specified by:

getEntity in interface org.eclipse.ditto.signals.base.WithOptionalEntity

getResourcePath

public org.eclipse.ditto.json.JsonPointer getResourcePath()

Specified by:

getResourcePath in interface org.eclipse.ditto.signals.base.WithResource

appendPayload

protected void appendPayload(org.eclipse.ditto.json.JsonObjectBuilder jsonObjectBuilder,
                             org.eclipse.ditto.model.base.json.JsonSchemaVersion schemaVersion,
                             Predicate<org.eclipse.ditto.json.JsonField> thePredicate)

Specified by:

appendPayload in class org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>

setDittoHeaders

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

Specified by:

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

Specified by:

setDittoHeaders in interface org.eclipse.ditto.signals.commands.base.Command<CreateThing>

Specified by:

setDittoHeaders in interface ThingModifyCommand<CreateThing>

Specified by:

setDittoHeaders in interface ThingCommand<CreateThing>

changesAuthorization

public boolean changesAuthorization()

Description copied from interface: ThingModifyCommand

Checks whether this command may change authorization of the Thing.

Specified by:

changesAuthorization in interface ThingModifyCommand<CreateThing>

Returns:

true if authorization would change, false otherwise.

hashCode

public int hashCode()

Overrides:

hashCode in class org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>

equals

public boolean equals(@Nullable
                      Object obj)

Overrides:

equals in class org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>

canEqual

protected boolean canEqual(@Nullable
                           Object other)

Overrides:

canEqual in class org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>

toString

public String toString()

Overrides:

toString in class org.eclipse.ditto.signals.commands.base.AbstractCommand<CreateThing>