# alibaba/fastjson architecture

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

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

## Overview

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: [`src/main/java/com/alibaba/fastjson/JSON.java`](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java) (JSON facade), [`src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java) (JSON parser), [`src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java`](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java) (Serializer engine), [`src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java`](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java) (Serializer registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Core API"]
  node_json["JSON facade<br/>[JSON.java]"]
  node_objects["Object and array trees<br/>[JSONObject.java]"]
  node_metadata["Bean metadata<br/>[JavaBeanInfo.java]"]
  node_typeutils["Type conversion<br/>[TypeUtils.java]"]
end

subgraph group_parse["Parsing"]
  node_parser["JSON parser"]
  node_lexer["Lexer and scanner<br/>[JSONLexerBase.java]"]
  node_parserconfig["Parser registry<br/>[ParserConfig.java]"]
  node_beanread["Bean deserializer"]
  node_fieldread["Field deserializer"]
end

subgraph group_serialize["Serialization"]
  node_serialize["Serializer engine"]
  node_writer["Output writer"]
  node_serializeconfig["Serializer registry"]
  node_beanwrite["Bean serializer"]
  node_asm["Bytecode generation<br/>[ClassWriter.java]"]
end

subgraph group_tools["JSON Utilities"]
  node_jsonpath["JSONPath queries<br/>[JSONPath.java]"]
  node_patch["JSON Patch<br/>[JSONPatch.java]"]
  node_validation["JSON validation<br/>[JSONValidator.java]"]
  node_streaming["Streaming APIs<br/>[JSONReader.java]"]
end

subgraph group_integrations["Framework Integrations"]
  node_spring["Spring adapters"]
  node_jaxrs["JAX-RS provider"]
  node_retrofit["Retrofit converter"]
end

node_caller(("Java caller"))

node_caller -->|"requests conversion"| node_json
node_json -->|"parses input"| node_parser
node_parser -->|"scans tokens"| node_lexer
node_parser -->|"resolves types"| node_parserconfig
node_parserconfig -->|"selects deserializer"| node_beanread
node_beanread -->|"delegates fields"| node_fieldread
node_parser -->|"uses conversions"| node_typeutils
node_json -->|"serializes objects"| node_serialize
node_serialize -->|"writes output"| node_writer
node_serialize -->|"selects serializers"| node_serializeconfig
node_serializeconfig -->|"creates bean serializer"| node_beanwrite
node_serializeconfig -->|"generates bytecode"| node_asm
node_metadata -->|"uses type utilities"| node_typeutils
node_caller -->|"queries JSON"| node_jsonpath
node_caller -.->|"applies patches"| node_patch
node_caller -.->|"validates JSON"| node_validation
node_caller -.->|"streams JSON"| node_streaming
node_spring -->|"converts messages"| node_json
node_jaxrs -->|"converts entities"| node_json
node_retrofit -->|"converts bodies"| node_json

click node_json "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java"
click node_objects "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONObject.java"
click node_parser "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java"
click node_lexer "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/JSONLexerBase.java"
click node_parserconfig "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/ParserConfig.java"
click node_beanread "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java"
click node_fieldread "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java"
click node_serialize "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java"
click node_writer "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java"
click node_serializeconfig "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java"
click node_beanwrite "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JavaBeanSerializer.java"
click node_asm "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/asm/ClassWriter.java"
click node_metadata "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/JavaBeanInfo.java"
click node_typeutils "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/TypeUtils.java"
click node_jsonpath "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONPath.java"
click node_patch "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONPatch.java"
click node_validation "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONValidator.java"
click node_streaming "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONReader.java"
click node_spring "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java"
click node_jaxrs "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java"
click node_retrofit "https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.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,node_objects,node_metadata,node_typeutils toneBlue
class node_parser,node_lexer,node_parserconfig,node_beanread,node_fieldread toneAmber
class node_serialize,node_writer,node_serializeconfig,node_beanwrite,node_asm toneMint
class node_jsonpath,node_patch,node_validation,node_streaming toneRose
class node_spring,node_jaxrs,node_retrofit,node_caller toneIndigo
```

## Components

### Core API

- [JSON facade](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java): `src/main/java/com/alibaba/fastjson/JSON.java`
- [Object and array trees](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONObject.java): `src/main/java/com/alibaba/fastjson/JSONObject.java`
- [Bean metadata](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/JavaBeanInfo.java): `src/main/java/com/alibaba/fastjson/util/JavaBeanInfo.java`
- [Type conversion](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/TypeUtils.java): `src/main/java/com/alibaba/fastjson/util/TypeUtils.java`

### Parsing

- [JSON parser](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java): `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`
- [Lexer and scanner](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/JSONLexerBase.java): `src/main/java/com/alibaba/fastjson/parser/JSONLexerBase.java`
- [Parser registry](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/ParserConfig.java): `src/main/java/com/alibaba/fastjson/parser/ParserConfig.java`
- [Bean deserializer](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java): `src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java`
- [Field deserializer](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java): `src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java`

### Serialization

- [Serializer engine](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java): `src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java`
- [Output writer](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java): `src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java`
- [Serializer registry](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java): `src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java`
- [Bean serializer](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JavaBeanSerializer.java): `src/main/java/com/alibaba/fastjson/serializer/JavaBeanSerializer.java`
- [Bytecode generation](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/asm/ClassWriter.java): `src/main/java/com/alibaba/fastjson/asm/ClassWriter.java`

### JSON Utilities

- [JSONPath queries](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONPath.java): `src/main/java/com/alibaba/fastjson/JSONPath.java`
- [JSON Patch](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONPatch.java): `src/main/java/com/alibaba/fastjson/JSONPatch.java`
- [JSON validation](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONValidator.java): `src/main/java/com/alibaba/fastjson/JSONValidator.java`
- [Streaming APIs](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONReader.java): `src/main/java/com/alibaba/fastjson/JSONReader.java`

### Framework Integrations

- [Spring adapters](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java): `src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java`
- [JAX-RS provider](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java): `src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java`
- [Retrofit converter](https://github.com/alibaba/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.java): `src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.java`

### Other components

- **Java caller**

## Connections

- Java caller → JSON facade: requests conversion
- JSON facade → JSON parser: parses input (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON parser → Lexer and scanner: scans tokens (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- JSON parser → Parser registry: resolves types (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- Parser registry → Bean deserializer: selects deserializer (evidence: `src/main/java/com/alibaba/fastjson/parser/ParserConfig.java`)
- Bean deserializer → Field deserializer: delegates fields (evidence: `src/main/java/com/alibaba/fastjson/parser/deserializer/JavaBeanDeserializer.java`)
- JSON parser → Type conversion: uses conversions (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- JSON facade → Serializer engine: serializes objects (evidence: `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 (evidence: `src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java`)
- Serializer registry → Bytecode generation: generates bytecode (evidence: `src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java`)
- Bean metadata → Type conversion: uses type utilities (evidence: `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 (evidence: `src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java`)
- JAX-RS provider → JSON facade: converts entities (evidence: `src/main/java/com/alibaba/fastjson/support/jaxrs/FastJsonProvider.java`)
- Retrofit converter → JSON facade: converts bodies (evidence: `src/main/java/com/alibaba/fastjson/support/retrofit/Retrofit2ConverterFactory.java`)
