Package org.eclipse.ditto.json

@AllParametersAndReturnValuesAreNonnullByDefault package org.eclipse.ditto.json

Ditto JSON is a general purpose JSON library. This package provides the corresponding interfaces as well as implementations. There is one central place for obtaining instances of the various interfaces: JsonFactory. JsonFactory provides only static methods which means that they can be imported statically and by thus make calls concise to assist the readability of your code.

Please note that Ditto JSON is designed for immutability. Therefore each object returned by JsonFactory - apart from builders - is immutable and thus thread safe. If interfaces provide methods for altering an object then invoking this method does not change the state of that object but a new object with the altered state is returned instead. This is the same behavior like it is shown by java.lang.String for example.

Class	Description
AbstractJsonExceptionBuilder<T extends JsonException>	Abstract base implementation for builders which create objects of subtypes of JsonRuntimeException.
CborFactory	This interface abstracts serialization/deserialization via CBOR.
JsonArray	Represents a JSON array.
JsonArrayBuilder	A mutable builder with a fluent API for a JsonArray.
JsonCollectors	This class provides implementations of Collector that implement various useful reduction operations, such as accumulating JSON fields into JSON objects etc.
JsonException	The methods of this interface are common for all JSON related exceptions.
JsonExceptionBuilder<T extends JsonException>	A mutable builder for a JsonException.
JsonFactory	The main entry point for the Eclipse Ditto JSON API.
JsonField	Represents a single JSON field.
JsonFieldDefinition<T>	A JsonFieldDefinition is a formal description of a single JsonField.
JsonFieldMarker	Marker interface to provide a common type for markers of JSON fields.
JsonFieldSelector	A JsonFieldSelector is basically a set of JsonPointers.
JsonFieldSelectorBuilder	A mutable builder with a fluent API for a JsonFieldSelector.
JsonFieldSelectorInvalidException	Thrown if a field selector at was in a invalid format.
JsonFieldSelectorInvalidException.Builder	A mutable builder for a JsonPointerInvalidException.
JsonKey	Represents a JSON key.
JsonKeyInvalidException	Thrown if a JsonKey was in an invalid format.
JsonKeyInvalidException.Builder	A mutable builder for a JsonKeyInvalidException.
JsonMergePatch	This class is responsible to compute or apply a JSON merge patch according to RFC 7386 for json values.
JsonMissingFieldException	Thrown if an expected JSON field is not in the JSON.
JsonMissingFieldException.Builder	A mutable builder for a JsonMissingFieldException.
JsonNumber	This interface represents a JSON number.
JsonObject	Represents a JSON object.
JsonObjectBuilder	A mutable builder for a JsonObject.
JsonParseException	Thrown if JSON could not be parsed because it was in an invalid format.
JsonParseException.Builder	A mutable builder for a JsonParseException.
JsonParseOptions	Holding options about how to parse a Json type (JsonObject, JsonPointer, ...) from a String.
JsonParseOptionsBuilder	A mutable builder for a JsonParseOptions.
JsonPatch	Defines a JSON Patch which can be used to specify modifications on JSON Objects.
JsonPatch.JsonFields	An enumeration of the known JsonFields of a Thing.
JsonPatch.Operation	Enumeration defining the supported JSON Patch operation types.
JsonPointer	A JSON pointer defines a path within a JSON object.
JsonPointerInvalidException	Thrown if a JsonPointer was in an invalid format.
JsonPointerInvalidException.Builder	A mutable builder for a JsonPointerInvalidException.
JsonRuntimeException	Common base type of all unchecked JSON exceptions.
JsonRuntimeException.Builder	A mutable builder for a JsonRuntimeException.
JsonValue	Represents a JSON value.
JsonValueContainer<T>	Abstract representation of a data structure which somehow holds JSON values.
SerializationContext	Bundles state and configuration for serialization.