# alibaba/fastjson2 architecture

> Architecture diagram of the GitHub repository alibaba/fastjson2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alibaba/fastjson2
- Repository: https://github.com/alibaba/fastjson2

## Overview

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: [`core/src/main/java/com/alibaba/fastjson2/JSON.java`](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSON.java) (JSON API), [`extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java`](https://github.com/alibaba/fastjson2/blob/main/extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java) (Spring Adapter), [`core/src/main/java/com/alibaba/fastjson2/JSONReader.java`](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONReader.java) (Text Reader), [`core/src/main/java/com/alibaba/fastjson2/reader`](https://github.com/alibaba/fastjson2/tree/main/core/src/main/java/com/alibaba/fastjson2/reader) (Reader Provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Core API"]
  node_json_api["JSON API<br/>[JSON.java]"]
  node_reader["Text Reader<br/>[JSONReader.java]"]
  node_writer["JSON Writer<br/>[JSONWriter.java]"]
end

subgraph group_mapping["Object Mapping"]
  node_reader_provider["Reader Provider"]
  node_field_reader["Field Readers<br/>[FieldReader.java]"]
  node_writer_provider["Writer Provider"]
  node_object_writer["Object Writers<br/>[ObjectWriter.java]"]
  node_factory["Runtime Factory<br/>[JSONFactory.java]"]
  node_type_utils["Type Conversion<br/>[TypeUtils.java]"]
end

subgraph group_features["Formats And Queries"]
  node_jsonb["JSONB Format<br/>[JSONB.java]"]
  node_jsonpath["JSONPath"]
  node_schema["Schema Validation"]
end

subgraph group_adapters["Language And Framework Adapters"]
  node_kotlin["Kotlin API<br/>[JSON.kt]"]
  node_compat["v1 Compatibility<br/>[JSON.java]"]
  node_spring["Spring Adapter"]
  node_config["Adapter Config"]
end

subgraph group_generation["Generated Mapping"]
  node_codegen["Compiled Mapping"]
end

node_application(("Java Application"))

node_application -->|"calls"| node_json_api
node_json_api -->|"creates reader"| node_reader
node_json_api -->|"gets typed reader"| node_reader_provider
node_reader -.->|"uses field mapping"| node_field_reader
node_application -->|"serializes object"| node_writer
node_writer -->|"writes values"| node_object_writer
node_writer_provider -->|"provides writers"| node_object_writer
node_factory -->|"supplies provider"| node_reader_provider
node_factory -.->|"supplies provider"| node_writer_provider
node_application -->|"uses binary format"| node_jsonb
node_application -->|"selects data"| node_jsonpath
node_application -->|"validates data"| node_schema
node_application -->|"uses Kotlin API"| node_kotlin
node_kotlin -->|"extends API"| node_json_api
node_application -->|"uses v1 facade"| node_compat
node_compat -->|"delegates parsing"| node_reader
node_application -->|"uses Spring adapter"| node_spring
node_spring -->|"calls JSON API"| node_json_api
node_spring -->|"uses configuration"| node_config
node_codegen -->|"generates writers"| node_object_writer
node_codegen -->|"generates readers"| node_field_reader
node_reader_provider -.->|"converts types"| node_type_utils

click node_json_api "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSON.java"
click node_reader "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONReader.java"
click node_reader_provider "https://github.com/alibaba/fastjson2/tree/main/core/src/main/java/com/alibaba/fastjson2/reader"
click node_field_reader "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/reader/FieldReader.java"
click node_writer "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONWriter.java"
click node_writer_provider "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java"
click node_object_writer "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java"
click node_factory "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONFactory.java"
click node_type_utils "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/util/TypeUtils.java"
click node_jsonb "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONB.java"
click node_jsonpath "https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONPathParser.java"
click node_schema "https://github.com/alibaba/fastjson2/tree/main/core/src/main/java/com/alibaba/fastjson2/schema"
click node_kotlin "https://github.com/alibaba/fastjson2/blob/main/kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt"
click node_compat "https://github.com/alibaba/fastjson2/blob/main/fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java"
click node_spring "https://github.com/alibaba/fastjson2/blob/main/extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java"
click node_config "https://github.com/alibaba/fastjson2/blob/main/extension/src/main/java/com/alibaba/fastjson2/support/config/FastJsonConfig.java"
click node_codegen "https://github.com/alibaba/fastjson2/blob/main/codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_json_api,node_reader,node_writer toneBlue
class node_reader_provider,node_field_reader,node_writer_provider,node_object_writer,node_factory,node_type_utils toneAmber
class node_jsonb,node_jsonpath,node_schema toneMint
class node_kotlin,node_compat,node_spring,node_config toneRose
class node_codegen,node_application toneIndigo
```

## Components

### Core API

- [JSON API](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSON.java): `core/src/main/java/com/alibaba/fastjson2/JSON.java`
- [Text Reader](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONReader.java): `core/src/main/java/com/alibaba/fastjson2/JSONReader.java`
- [JSON Writer](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONWriter.java): `core/src/main/java/com/alibaba/fastjson2/JSONWriter.java`

### Object Mapping

- [Reader Provider](https://github.com/alibaba/fastjson2/tree/main/core/src/main/java/com/alibaba/fastjson2/reader): `core/src/main/java/com/alibaba/fastjson2/reader`
- [Field Readers](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/reader/FieldReader.java): `core/src/main/java/com/alibaba/fastjson2/reader/FieldReader.java`
- [Writer Provider](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java): `core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java`
- [Object Writers](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java): `core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java`
- [Runtime Factory](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONFactory.java): `core/src/main/java/com/alibaba/fastjson2/JSONFactory.java`
- [Type Conversion](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/util/TypeUtils.java): `core/src/main/java/com/alibaba/fastjson2/util/TypeUtils.java`

### Formats And Queries

- [JSONB Format](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONB.java): `core/src/main/java/com/alibaba/fastjson2/JSONB.java`
- [JSONPath](https://github.com/alibaba/fastjson2/blob/main/core/src/main/java/com/alibaba/fastjson2/JSONPathParser.java): `core/src/main/java/com/alibaba/fastjson2/JSONPathParser.java`
- [Schema Validation](https://github.com/alibaba/fastjson2/tree/main/core/src/main/java/com/alibaba/fastjson2/schema): `core/src/main/java/com/alibaba/fastjson2/schema`

### Language And Framework Adapters

- [Kotlin API](https://github.com/alibaba/fastjson2/blob/main/kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt): `kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt`
- [v1 Compatibility](https://github.com/alibaba/fastjson2/blob/main/fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java): `fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java`
- [Spring Adapter](https://github.com/alibaba/fastjson2/blob/main/extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java): `extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java`
- [Adapter Config](https://github.com/alibaba/fastjson2/blob/main/extension/src/main/java/com/alibaba/fastjson2/support/config/FastJsonConfig.java): `extension/src/main/java/com/alibaba/fastjson2/support/config/FastJsonConfig.java`

### Generated Mapping

- [Compiled Mapping](https://github.com/alibaba/fastjson2/blob/main/codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java): `codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java`

### Other components

- **Java Application**

## Connections

- Java Application → JSON API: calls (evidence: `README.md`)
- JSON API → Text Reader: creates reader (evidence: `core/src/main/java/com/alibaba/fastjson2/JSON.java`)
- JSON API → Reader Provider: gets typed reader (evidence: `core/src/main/java/com/alibaba/fastjson2/JSON.java`)
- Text Reader → Field Readers: uses field mapping (evidence: `core/src/main/java/com/alibaba/fastjson2/JSONReader.java`)
- Java Application → JSON Writer: serializes object (evidence: `README.md`)
- JSON Writer → Object Writers: writes values (evidence: `core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriter.java`)
- Writer Provider → Object Writers: provides writers (evidence: `core/src/main/java/com/alibaba/fastjson2/writer/ObjectWriterProvider.java`)
- Runtime Factory → Reader Provider: supplies provider (evidence: `core/src/main/java/com/alibaba/fastjson2/JSONFactory.java`)
- Runtime Factory → Writer Provider: supplies provider (evidence: `core/src/main/java/com/alibaba/fastjson2/JSONFactory.java`)
- Java Application → JSONB Format: uses binary format (evidence: `README.md`)
- Java Application → JSONPath: selects data (evidence: `README.md`)
- Java Application → Schema Validation: validates data (evidence: `README.md`)
- Java Application → Kotlin API: uses Kotlin API (evidence: `README.md`)
- Kotlin API → JSON API: extends API (evidence: `kotlin/src/main/kotlin/com/alibaba/fastjson2/JSON.kt`)
- Java Application → v1 Compatibility: uses v1 facade (evidence: `README.md`)
- v1 Compatibility → Text Reader: delegates parsing (evidence: `fastjson1-compatible/src/main/java/com/alibaba/fastjson/JSON.java`)
- Java Application → Spring Adapter: uses Spring adapter (evidence: `README.md`)
- Spring Adapter → JSON API: calls JSON API (evidence: `extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java`)
- Spring Adapter → Adapter Config: uses configuration (evidence: `extension-spring5/src/main/java/com/alibaba/fastjson2/support/spring/http/converter/FastJsonHttpMessageConverter.java`)
- Compiled Mapping → Object Writers: generates writers (evidence: `codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java`)
- Compiled Mapping → Field Readers: generates readers (evidence: `codegen/src/main/java/com/alibaba/fastjson2/internal/processor/JSONCompiledAnnotationProcessor.java`)
- Reader Provider → Type Conversion: converts types (evidence: `core/src/main/java/com/alibaba/fastjson2/reader/ObjectReaderProvider.java`)
