How simdjson/simdjson-java works
simdjson-java is a Java SIMD-oriented JSON parsing library. An application supplies a byte buffer to SimdJsonParser, which validates UTF-8 and indexes structural characters before dispatching to either a DOM-producing iterator or a schema-based iterator; the result is a JsonValue tree or a typed Java object. The runtime also includes an on-demand iterator and specialized string, number, and schema-resolution logic. Relationships below follow the README and source-index references; unsampled implementation details are not inferred beyond those references.
Main entry points: SimdJsonParser.java Parser API · NumberParser.java Number parser · JsonIterator.java DOM iterator · TapeBuilder.java Tape builder
Components 23
Parsing entry
- Parser API
src/main/java/org/simdjson/SimdJsonParser.java - UTF-8 validation
src/main/java/org/simdjson/Utf8Validator.java - Structural indexer
src/main/java/org/simdjson/StructuralIndexer.java - Structural indexes
src/main/java/org/simdjson/BitIndexes.java
Document traversal
- DOM iterator
src/main/java/org/simdjson/JsonIterator.java - On-demand iterator
src/main/java/org/simdjson/OnDemandJsonIterator.java - Tape builder
src/main/java/org/simdjson/TapeBuilder.java - Value tape
src/main/java/org/simdjson/Tape.java - DOM values
src/main/java/org/simdjson/JsonValue.java
Value decoding
- String decoder
src/main/java/org/simdjson/StringParser.java - Number parser
src/main/java/org/simdjson/NumberParser.java - Exponent parser
src/main/java/org/simdjson/ExponentParser.java - Floating conversion
src/main/java/org/simdjson/DoubleParser.java - Float conversion
src/main/java/org/simdjson/FloatParser.java - Number tables
src/main/java/org/simdjson/NumberParserTables.java - Character utilities
src/main/java/org/simdjson/CharacterUtils.java - Vector utilities
src/main/java/org/simdjson/VectorUtils.java - Parse errors
src/main/java/org/simdjson/JsonParsingException.java
Schema mapping
- Schema iterator
src/main/java/org/simdjson/SchemaBasedJsonIterator.java - Class resolver
src/main/java/org/simdjson/ClassResolver.java - Resolved schema
src/main/java/org/simdjson/ResolvedClass.java - Constructor arguments
src/main/java/org/simdjson/ConstructorArgumentsMap.java
Other components
- Application
Connections 25
- Application → Parser API: supplies JSON
README.md - Parser API → UTF-8 validation: validates bytes
src/main/java/org/simdjson/SimdJsonParser.java - Parser API → Structural indexer: indexes structure
src/main/java/org/simdjson/SimdJsonParser.java - Structural indexer → Structural indexes: writes positions
src/main/java/org/simdjson/StructuralIndexer.java - Parser API → DOM iterator: dispatches DOM parse
src/main/java/org/simdjson/SimdJsonParser.java - Parser API → Schema iterator: dispatches typed parse
src/main/java/org/simdjson/SimdJsonParser.java - DOM iterator → Tape builder: builds tape
src/main/java/org/simdjson/JsonIterator.java - DOM iterator → Structural indexes: reads positions
src/main/java/org/simdjson/JsonIterator.java - DOM iterator → DOM values: returns values
src/main/java/org/simdjson/JsonIterator.java - Tape builder → Value tape: appends values
src/main/java/org/simdjson/TapeBuilder.java - Tape builder → String decoder: decodes strings
src/main/java/org/simdjson/TapeBuilder.java - Tape builder → Number parser: parses numbers
src/main/java/org/simdjson/TapeBuilder.java - DOM values → Value tape: reads values
src/main/java/org/simdjson/JsonValue.java - Number parser → Exponent parser: parses exponents
src/main/java/org/simdjson/NumberParser.java - Number parser → Floating conversion: converts doubles
src/main/java/org/simdjson/NumberParser.java - Number parser → Float conversion: converts floats
src/main/java/org/simdjson/NumberParser.java - Floating conversion → Number tables: uses tables
src/main/java/org/simdjson/DoubleParser.java - Float conversion → Number tables: uses tables
src/main/java/org/simdjson/FloatParser.java - String decoder → Character utilities: decodes escapes
src/main/java/org/simdjson/StringParser.java - String decoder → Vector utilities: uses SIMD vectors
src/main/java/org/simdjson/StringParser.java - Schema iterator → Resolved schema: uses resolved schema
src/main/java/org/simdjson/SchemaBasedJsonIterator.java - Schema iterator → On-demand iterator: uses traversal
src/main/java/org/simdjson/SchemaBasedJsonIterator.java - Class resolver → Resolved schema: resolves classes
src/main/java/org/simdjson/ClassResolver.java - Resolved schema → Constructor arguments: maps parameters
src/main/java/org/simdjson/ResolvedClass.java - Number parser → Parse errors: raises parse errors
src/main/java/org/simdjson/NumberParser.java