Skip to content

Home

Jump to bottom
frosxt edited this page Jan 18, 2026 · 1 revision

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.

Clone this wiki locally