How alibaba/fastjson works
Fastjson is a Java JSON binding library: callers convert JSON text or bytes into Java objects and convert Java objects back into JSON. Its central flow is exposed through JSON, with parsing, type-specific deserialization, object metadata and serialization as distinct internal stages. The repository also provides tree-model values, JSONPath, JSON Patch, validation and streaming APIs, plus framework adapters. Relationships below use README statements and SOURCE INDEX references; unsampled implementation details are not asserted.
Main entry points: JSON.java JSON facade · DefaultJSONParser.java JSON parser · JSONSerializer.java Serializer engine · SerializeConfig.java Serializer registry
Components 22
Core API
- JSON facade
src/main/java/com/alibaba/fastjson/JSON.java - Object and array trees
src/main/java/com/alibaba/fastjson/JSONObject.java - Bean metadata
src/main/java/com/alibaba/fastjson/util/JavaBeanInfo.java - Type conversion
src/main/java/com/alibaba/fastjson/util/TypeUtils.java
Parsing
- JSON parser
src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java - Lexer and scanner
src/main/java/com/alibaba/fastjson/parser/JSONLexerBase.java - Parser registry
src/main/java/com/alibaba/fastjson/parser/ParserConfig.java - Bean deserializer
src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java - Field deserializer
src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java
Serialization
- Serializer engine
src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java - Output writer
src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java - Serializer registry
src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java - Bean serializer
src/main/java/com/alibaba/fastjson/serializer/JavaBeanSerializer.java - Bytecode generation
src/main/java/com/alibaba/fastjson/asm/ClassWriter.java
JSON Utilities
- JSONPath queries
src/main/java/com/alibaba/fastjson/JSONPath.java - JSON Patch
src/main/java/com/alibaba/fastjson/JSONPatch.java - JSON validation
src/main/java/com/alibaba/fastjson/JSONValidator.java - Streaming APIs
src/main/java/com/alibaba/fastjson/JSONReader.java
Framework Integrations
- Spring adapters
src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java - JAX-RS provider
src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java - Retrofit converter
src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.java
Other components
- Java caller
Connections 20
- Java caller → JSON facade: requests conversion
- JSON facade → JSON parser: parses input
src/main/java/com/alibaba/fastjson/JSON.java - JSON parser → Lexer and scanner: scans tokens
src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java - JSON parser → Parser registry: resolves types
src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java - Parser registry → Bean deserializer: selects deserializer
src/main/java/com/alibaba/fastjson/parser/ParserConfig.java - Bean deserializer → Field deserializer: delegates fields
src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java - JSON parser → Type conversion: uses conversions
src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java - JSON facade → Serializer engine: serializes objects
src/main/java/com/alibaba/fastjson/JSON.java - Serializer engine → Output writer: writes output
- Serializer engine → Serializer registry: selects serializers
- Serializer registry → Bean serializer: creates bean serializer
src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java - Serializer registry → Bytecode generation: generates bytecode
src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java - Bean metadata → Type conversion: uses type utilities
src/main/java/com/alibaba/fastjson/util/JavaBeanInfo.java - Java caller → JSONPath queries: queries JSON
- Java caller → JSON Patch: applies patches
- Java caller → JSON validation: validates JSON
- Java caller → Streaming APIs: streams JSON
- Spring adapters → JSON facade: converts messages
src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java - JAX-RS provider → JSON facade: converts entities
src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java - Retrofit converter → JSON facade: converts bodies
src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.java