How google/gson works
Gson is a Java library for converting Java objects to JSON and JSON to Java objects, including generic and pre-existing types. The main workflow is for an application to configure a Gson instance, then serialize or deserialize through type adapters and JSON streams; callers can also parse JSON into a tree. The graph includes the documented customization and generic-type capabilities, plus notable adapter extensions in the tree. Source excerpts show key API and parser calls; several adapter internals are unsampled, so their links are omitted rather than inferred.
Main entry points: TypeAdapter.java TypeAdapter · Gson.java Gson · JsonReader.java JsonReader · Streams.java Tree stream bridge
Components 19
Public API
- GsonBuilder
gson/src/main/java/com/google/gson/GsonBuilder.java - Gson
gson/src/main/java/com/google/gson/Gson.java - TypeToken
gson/src/main/java/com/google/gson/reflect/TypeToken.java - JSON tree API
gson/src/main/java/com/google/gson/JsonElement.java
Conversion Engine
- TypeAdapter
gson/src/main/java/com/google/gson/TypeAdapter.java - Adapter factories
gson/src/main/java/com/google/gson/TypeAdapterFactory.java - Reflective mapping
gson/src/main/java/com/google/gson/internal/bind/ReflectiveTypeAdapterFactory.java - Collection mapping
gson/src/main/java/com/google/gson/internal/bind/CollectionTypeAdapterFactory.java - Built-in adapters
gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java
JSON Processing
- JSON parser
gson/src/main/java/com/google/gson/JsonParser.java - Stream parser
gson/src/main/java/com/google/gson/JsonStreamParser.java - Tree stream bridge
gson/src/main/java/com/google/gson/internal/Streams.java - JsonReader
gson/src/main/java/com/google/gson/stream/JsonReader.java - JsonWriter
gson/src/main/java/com/google/gson/stream/JsonWriter.java
Adapter Extensions
- Runtime type adapter
extras/src/main/java/com/google/gson/typeadapters/RuntimeTypeAdapterFactory.java - UTC date adapter
extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java - Protocol Buffers adapters
proto/src/main/java/com/google/gson/protobuf/ProtoTypeAdapter.java - Legacy proto adapter
proto/src/main/java/com/google/gson/protobuf/LegacyProtoTypeAdapterFactory.java
Other components
- Java application
Connections 19
- Java application → GsonBuilder: configures
gson/src/main/java/com/google/gson/GsonBuilder.java - Java application → Gson: converts with
README.md - GsonBuilder → Gson: creates
gson/src/main/java/com/google/gson/GsonBuilder.java - Gson → TypeAdapter: delegates to
gson/src/main/java/com/google/gson/Gson.java - Gson → JsonReader: reads from
gson/src/main/java/com/google/gson/Gson.java - Gson → JsonWriter: writes to
gson/src/main/java/com/google/gson/Gson.java - Gson → TypeToken: accepts types
gson/src/main/java/com/google/gson/Gson.java - TypeAdapter → JsonReader: reads tokens
gson/src/main/java/com/google/gson/TypeAdapter.java - TypeAdapter → JsonWriter: writes tokens
gson/src/main/java/com/google/gson/TypeAdapter.java - TypeAdapter → Tree stream bridge: uses bridge
gson/src/main/java/com/google/gson/TypeAdapter.java - JSON parser → JsonReader: parses input
gson/src/main/java/com/google/gson/JsonParser.java - JSON parser → Tree stream bridge: parses through
gson/src/main/java/com/google/gson/JsonParser.java - Stream parser → JsonReader: reads stream
gson/src/main/java/com/google/gson/JsonStreamParser.java - Stream parser → Tree stream bridge: parses through
gson/src/main/java/com/google/gson/JsonStreamParser.java - Runtime type adapter → TypeAdapter: implements
extras/src/main/java/com/google/gson/typeadapters/RuntimeTypeAdapterFactory.java - UTC date adapter → TypeAdapter: implements
extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java - Protocol Buffers adapters → TypeAdapter: adapts types
- Legacy proto adapter → TypeAdapter: creates adapters
proto/src/main/java/com/google/gson/protobuf/LegacyProtoTypeAdapterFactory.java - Legacy proto adapter → Gson: uses context
proto/src/main/java/com/google/gson/protobuf/LegacyProtoTypeAdapterFactory.java