How alibaba/fastjson2 works
FASTJSON 2 is a Java JSON library with text and JSONB formats, object mapping, JSONPath selection, schema validation, and language/framework adapters. The principal workflow starts with an application calling the JSON API to parse input into typed objects or serialize objects to output. Reader/writer providers and field-level mapping form the central internal layer. The tree and README establish several capabilities whose implementation details were not sampled; those branches are shown without asserting unsupported internal calls.
Main entry points: JSON.java JSON API · FastJsonHttpMessageConverter.java Spring Adapter · JSONReader.java Text Reader · reader Reader Provider
Components 18
Core API
- JSON API
core/src/main/java/com/alibaba/fastjson2/JSON.java - Text Reader
core/src/main/java/com/alibaba/fastjson2/JSONReader.java - JSON Writer
core/src/main/java/com/alibaba/fastjson2/JSONWriter.java
Object Mapping
- Reader Provider
core/src/main/java/com/alibaba/fastjson2/reader - Field Readers
core/src/main/java/com/alibaba/fastjson2/reader/FieldReader.java - Writer Provider
core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java - Object Writers
core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java - Runtime Factory
core/src/main/java/com/alibaba/fastjson2/JSONFactory.java - Type Conversion
core/src/main/java/com/alibaba/fastjson2/util/TypeUtils.java
Formats And Queries
- JSONB Format
core/src/main/java/com/alibaba/fastjson2/JSONB.java - JSONPath
core/src/main/java/com/alibaba/fastjson2/JSONPathParser.java - Schema Validation
core/src/main/java/com/alibaba/fastjson2/schema
Language And Framework Adapters
- Kotlin API
kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt - v1 Compatibility
fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java - Spring Adapter
extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java - Adapter Config
extension/src/main/java/com/alibaba/fastjson2/support/config/FastJsonConfig.java
Generated Mapping
- Compiled Mapping
codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java
Other components
- Java Application
Connections 22
- Java Application → JSON API: calls
README.md - JSON API → Text Reader: creates reader
core/src/main/java/com/alibaba/fastjson2/JSON.java - JSON API → Reader Provider: gets typed reader
core/src/main/java/com/alibaba/fastjson2/JSON.java - Text Reader → Field Readers: uses field mapping
core/src/main/java/com/alibaba/fastjson2/JSONReader.java - Java Application → JSON Writer: serializes object
README.md - JSON Writer → Object Writers: writes values
core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java - Writer Provider → Object Writers: provides writers
core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java - Runtime Factory → Reader Provider: supplies provider
core/src/main/java/com/alibaba/fastjson2/JSONFactory.java - Runtime Factory → Writer Provider: supplies provider
core/src/main/java/com/alibaba/fastjson2/JSONFactory.java - Java Application → JSONB Format: uses binary format
README.md - Java Application → JSONPath: selects data
README.md - Java Application → Schema Validation: validates data
README.md - Java Application → Kotlin API: uses Kotlin API
README.md - Kotlin API → JSON API: extends API
kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt - Java Application → v1 Compatibility: uses v1 facade
README.md - v1 Compatibility → Text Reader: delegates parsing
fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java - Java Application → Spring Adapter: uses Spring adapter
README.md - Spring Adapter → JSON API: calls JSON API
extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java - Spring Adapter → Adapter Config: uses configuration
extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java - Compiled Mapping → Object Writers: generates writers
codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java - Compiled Mapping → Field Readers: generates readers
codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java - Reader Provider → Type Conversion: converts types
core/src/main/java/com/alibaba/fastjson2/reader/ObjectReaderProvider.java