Home

Welcome to the JsonConfig Wiki

JsonConfig is a Java library for handling JSON files as configuration objects. It provides a path-based API (key.subkey).

Core Concepts

• Zero Dependencies: The library implements its own parser and lexer. It does not rely on Gson, Jackson, or standard Java JSON libraries.
• Configuration vs Object Mapping: Unlike data-binding libraries (Jackson/Gson), JsonConfig does not try to map JSON to Java Classes. It keeps the structure dynamic, allowing you to read/write arbitrary paths at runtime.
• Thread Safety: A dedicated concurrency module provides thread-safe access for multi-threaded applications.

Navigation

1. Installation - Gradle/Maven setup via JitPack.
2. Basic Usage - Loading, reading, editing, and saving files.
3. Path Syntax - How to access nested objects and arrays.
4. Merge Strategies - Managing defaults and updating configurations.
5. Thread Safety - Using ConcurrentJsonConfiguration.
6. Integrations - Using Gson and Jackson adapters.