Utilities for JSON as specified in RFC 4627: The application/json Media Type for JavaScript Object Notation (JSON) and Introducing JSON.
Classes
CustomizeJsonParser
Beta
Customizes the behavior of a JSON parser.
All methods have a default trivial implementation, so subclasses need only implement the methods whose behavior needs customization.
Implementation has no fields and therefore thread-safe, but sub-classes are not necessarily thread-safe.
GenericJson
Generic JSON data that stores all unknown key name/value pairs.
Subclasses can declare fields for known data keys using the Key annotation. Each field
can be of any visibility (private, package private, protected, or public) and must not be static.
null unknown data key names are not allowed, but null data values are allowed.
Implementation is not thread-safe. For a thread-safe choice instead use an implementation of ConcurrentMap.
Json
JSON utilities.
JsonFactory
Abstract low-level JSON factory.
Implementation is thread-safe, and sub-classes must be thread-safe. For maximum efficiency, applications should use a single globally-shared instance of the JSON factory.
JsonGenerator
Abstract low-level JSON serializer.
Implementation has no fields and therefore thread-safe, but sub-classes are not necessarily thread-safe.
JsonObjectParser
Parses JSON data into an data class of key/value pairs.
Implementation is thread-safe.
Sample usage:
static void setParser(HttpRequest request) {
request.setParser(new JsonObjectParser(new JacksonFactory()));
}
JsonObjectParser.Builder
Builder.
Implementation is not thread-safe.
JsonParser
Abstract low-level JSON parser. See https://developers.google.com/api-client-library/java/google-http-java-client/json
Implementation has no fields and therefore thread-safe, but sub-classes are not necessarily thread-safe.
If a JSON map is encountered while using a destination class of type Map, then an java.util.ArrayMap is used by default for the parsed values.
Enums
JsonToken
JSON token in the low-level JSON library.
Annotation Types
JsonPolymorphicTypeMap
Beta
Declares that the data type enclosing this field is polymorphic, and that the value of this field
in a heterogeneous JSON schema will determine what type the data should be parsed into.
A data structure must have no more than one field with this annotation present. The annotated field's type must be considered "primitive" by Data#isPrimitive(Type). The field's value will be compared against the TypeDef#key() using Object#toString().
JsonPolymorphicTypeMap.TypeDef
Declares a mapping between a key value and a referenced class.
JsonString
Use this annotation to specify that a declared numeric Java field should map to a JSON string.
By default declared Java numeric fields are stored as JSON numbers. For example:
class A {
@Key BigInteger value;
}
can be used for this JSON content:
{"value" : 12345768901234576890123457689012345768901234576890}
However, if instead the JSON content uses a JSON String to store the value, one needs to use the JsonString annotation. For example:
class B {
@Key @JsonString BigInteger value;
}
can be used for this JSON content:
{"value" : "12345768901234576890123457689012345768901234576890"}