Package com.google.gson
This package provides the
Gson
class to convert Json to Java and
vice-versa.
The primary class to use is Gson
which can be constructed with
new Gson()
(using default settings) or by using GsonBuilder
(to configure various options such as using versioning and so on).
-
Interface Summary Interface Description ExclusionStrategy A strategy (or policy) definition that is used to decide whether or not a field or top-level class should be serialized or deserialized as part of the JSON output/input.FieldNamingStrategy A mechanism for providing custom field naming in Gson.InstanceCreator<T> This interface is implemented to create instances of a class that does not define a no-args constructor.JsonDeserializationContext Context for deserialization that is passed to a custom deserializer during invocation of itsJsonDeserializer.deserialize(JsonElement, Type, JsonDeserializationContext)
method.JsonDeserializer<T> Interface representing a custom deserializer for Json.JsonSerializationContext Context for serialization that is passed to a custom serializer during invocation of itsJsonSerializer.serialize(Object, Type, JsonSerializationContext)
method.JsonSerializer<T> Interface representing a custom serializer for Json.ToNumberStrategy A strategy that is used to control how numbers should be deserialized forObject
andNumber
when a concrete type of the deserialized number is unknown in advance.TypeAdapterFactory Creates type adapters for set of related types. -
Class Summary Class Description FieldAttributes A data object that stores attributes of a field.Gson This is the main class for using Gson.GsonBuilder Use this builder to construct aGson
instance when you need to set configuration options other than the default.JsonArray A class representing an array type in Json.JsonElement A class representing an element of Json.JsonNull A class representing a Jsonnull
value.JsonObject A class representing an object type in Json.JsonParser A parser to parse Json into a parse tree ofJsonElement
sJsonPrimitive A class representing a Json primitive value.JsonStreamParser A streaming parser that allows reading of multipleJsonElement
s from the specified reader asynchronously.TypeAdapter<T> Converts Java objects to and from JSON. -
Enum Summary Enum Description FieldNamingPolicy An enumeration that defines a few standard naming conventions for JSON field names.LongSerializationPolicy Defines the expected format for along
orLong
type when it is serialized.ToNumberPolicy An enumeration that defines two standard number reading strategies and a couple of strategies to overcome some historical Gson limitations while deserializing numbers asObject
andNumber
. -
Exception Summary Exception Description JsonIOException This exception is raised when Gson was unable to read an input stream or write to one.JsonParseException This exception is raised if there is a serious issue that occurs during parsing of a Json string.JsonSyntaxException This exception is raised when Gson attempts to read (or write) a malformed JSON element.