# alibabatech/fastjson architecture

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

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

## Overview

fastjson is a Java JSON library: callers parse JSON text into generic or typed Java values, or serialize Java values to JSON text. Its runtime also provides JSON object/array containers, configurable parsing and serialization, Java type conversion, and a Spring HTTP message-converter integration. Parsing and serialization internals are represented at subsystem level; the sampled excerpts do not establish all dispatch details, so uncertain integration links are dashed.

Main entry points: [`src/main/java/com/alibaba/fastjson/JSON.java`](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java) (JSON API), [`src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java) (JSON parser), [`src/main/java/com/alibaba/fastjson/parser/deserializer`](https://github.com/alibabatech/fastjson/tree/master/src/main/java/com/alibaba/fastjson/parser/deserializer) (Type deserializers), [`src/main/java/com/alibaba/fastjson/util/TypeUtils.java`](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/TypeUtils.java) (Type conversion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_json_api["JSON API<br/>[JSON.java]"]
  node_object["JSON object<br/>[JSONObject.java]"]
  node_array["JSON array<br/>[JSONArray.java]"]
end

subgraph group_parse["Parsing and Mapping"]
  node_parser["JSON parser"]
  node_lexer["Scanner and tokens<br/>[JSONScanner.java]"]
  node_parser_config["Parser configuration<br/>[ParserConfig.java]"]
  node_deserializers["Type deserializers"]
  node_field_mapping["Field mapping"]
  node_type_utils["Type conversion<br/>[TypeUtils.java]"]
end

subgraph group_serialize["Serialization"]
  node_serializer["JSON serializer"]
  node_serialize_config["Serializer configuration"]
  node_writer["JSON writer"]
  node_serializer_features["Serializer features"]
end

subgraph group_runtime["Runtime Integrations"]
  node_asm_writer["Bytecode emitter<br/>[ClassWriter.java]"]
  node_asm_deserializers["Generated deserializers"]
  node_spring_converter["Spring converter"]
end

node_caller(("Java caller"))

node_caller -->|"calls"| node_json_api
node_json_api -->|"parses with"| node_parser
node_parser -->|"scans input"| node_lexer
node_json_api -->|"configures parser"| node_parser_config
node_parser -->|"uses deserializers"| node_deserializers
node_parser_config -->|"registers types"| node_deserializers
node_deserializers -->|"sets fields"| node_field_mapping
node_json_api -->|"serializes with"| node_serializer
node_json_api -->|"creates writer"| node_writer
node_json_api -->|"accepts mapping"| node_serialize_config
node_json_api -->|"accepts features"| node_serializer_features
node_object -->|"converts values"| node_type_utils
node_array -->|"converts values"| node_type_utils
node_parser -->|"converts values"| node_type_utils
node_asm_deserializers -.->|"emits bytecode"| node_asm_writer
node_spring_converter -.->|"uses JSON API"| node_json_api

click node_json_api "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java"
click node_object "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONObject.java"
click node_array "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONArray.java"
click node_parser "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java"
click node_lexer "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/JSONScanner.java"
click node_parser_config "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/ParserConfig.java"
click node_deserializers "https://github.com/alibabatech/fastjson/tree/master/src/main/java/com/alibaba/fastjson/parser/deserializer"
click node_field_mapping "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java"
click node_type_utils "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/TypeUtils.java"
click node_serializer "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java"
click node_serialize_config "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java"
click node_writer "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java"
click node_serializer_features "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializerFeature.java"
click node_asm_writer "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/asm/ClassWriter.java"
click node_asm_deserializers "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/ASMDeserializerFactory.java"
click node_spring_converter "https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.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_object,node_array toneBlue
class node_parser,node_lexer,node_parser_config,node_deserializers,node_field_mapping,node_type_utils toneAmber
class node_serializer,node_serialize_config,node_writer,node_serializer_features toneMint
class node_asm_writer,node_asm_deserializers,node_spring_converter toneRose
class node_caller toneIndigo
```

## Components

### Public API

- [JSON API](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSON.java): `src/main/java/com/alibaba/fastjson/JSON.java`
- [JSON object](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONObject.java): `src/main/java/com/alibaba/fastjson/JSONObject.java`
- [JSON array](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/JSONArray.java): `src/main/java/com/alibaba/fastjson/JSONArray.java`

### Parsing and Mapping

- [JSON parser](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java): `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`
- [Scanner and tokens](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/JSONScanner.java): `src/main/java/com/alibaba/fastjson/parser/JSONScanner.java`
- [Parser configuration](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/ParserConfig.java): `src/main/java/com/alibaba/fastjson/parser/ParserConfig.java`
- [Type deserializers](https://github.com/alibabatech/fastjson/tree/master/src/main/java/com/alibaba/fastjson/parser/deserializer): `src/main/java/com/alibaba/fastjson/parser/deserializer`
- [Field mapping](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java): `src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java`
- [Type conversion](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/util/TypeUtils.java): `src/main/java/com/alibaba/fastjson/util/TypeUtils.java`

### Serialization

- [JSON serializer](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java): `src/main/java/com/alibaba/fastjson/serializer/JSONSerializer.java`
- [Serializer configuration](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java): `src/main/java/com/alibaba/fastjson/serializer/SerializeConfig.java`
- [JSON writer](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java): `src/main/java/com/alibaba/fastjson/serializer/SerializeWriter.java`
- [Serializer features](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/serializer/SerializerFeature.java): `src/main/java/com/alibaba/fastjson/serializer/SerializerFeature.java`

### Runtime Integrations

- [Bytecode emitter](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/asm/ClassWriter.java): `src/main/java/com/alibaba/fastjson/asm/ClassWriter.java`
- [Generated deserializers](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/parser/deserializer/ASMDeserializerFactory.java): `src/main/java/com/alibaba/fastjson/parser/deserializer/ASMDeserializerFactory.java`
- [Spring converter](https://github.com/alibabatech/fastjson/blob/master/src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java): `src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java`

### Other components

- **Java caller**

## Connections

- Java caller → JSON API: calls
- JSON API → JSON parser: parses with (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON parser → Scanner and tokens: scans input (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- JSON API → Parser configuration: configures parser (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON parser → Type deserializers: uses deserializers (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- Parser configuration → Type deserializers: registers types (evidence: `src/main/java/com/alibaba/fastjson/parser/ParserConfig.java`)
- Type deserializers → Field mapping: sets fields (evidence: `src/main/java/com/alibaba/fastjson/parser/deserializer/FieldDeserializer.java`)
- JSON API → JSON serializer: serializes with (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON API → JSON writer: creates writer (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON API → Serializer configuration: accepts mapping (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON API → Serializer features: accepts features (evidence: `src/main/java/com/alibaba/fastjson/JSON.java`)
- JSON object → Type conversion: converts values (evidence: `src/main/java/com/alibaba/fastjson/JSONObject.java`)
- JSON array → Type conversion: converts values (evidence: `src/main/java/com/alibaba/fastjson/JSONArray.java`)
- JSON parser → Type conversion: converts values (evidence: `src/main/java/com/alibaba/fastjson/parser/DefaultJSONParser.java`)
- Generated deserializers → Bytecode emitter: emits bytecode (evidence: `src/main/java/com/alibaba/fastjson/parser/deserializer/ASMDeserializerFactory.java`)
- Spring converter → JSON API: uses JSON API (evidence: `src/main/java/com/alibaba/fastjson/support/spring/FastJsonHttpMessageConverter.java`)
