feat: Upgrade configured to v4.1.0

docs: Update license [skip ci]
docs: Translated to English
2026-06-04 18:48:20 +08:00 · 2025-03-15 01:52:52 +08:00 · 2025-03-15 01:51:07 +08:00 · 2025-03-14 19:34:06 +08:00 · 2025-03-14 19:33:30 +08:00 · 2025-03-14 19:20:31 +08:00
75 changed files with 1454 additions and 1037 deletions
@@ -1,9 +1,3 @@
-# EasyConfiguration Javadoc
+# configured Javadoc

-基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/EasyConfiguration) 。
-
-## 如何实现？
-
-若您也想通过 [Github Actions](https://docs.github.com/en/actions/learn-github-actions)
-自动部署项目的Javadoc到 [Github Pages](https://pages.github.com/) ，
-可以参考我的文章 [《自动部署Javadoc到Github Pages》](https://pages.carm.cc/doc/javadoc-in-github.html) 。
+Based on [Github Pages](https://pages.github.com/), please see [JavaDoc](https://carmjos.github.io/configured) 。
@@ -1,16 +1 @@
-# 欢迎使用 EasyConfiguration ！
-
-这个项目刚刚创建，详细的Javadoc与开发指南还在补充，请给我一点时间~
-
-
-## 基本定义
-
-Value: 实际配置的单例值。
-
-Manifest: 用于描述值基本配置的对象。
-
-Provider: 用于提供配置文件的接口。
-
-Wrapper: 用于包装配置文件的接口。
-
-Initializer: 用于初始化的接口
+# Documentation
@@ -47,7 +47,7 @@ jobs:
        id: sitemap
        uses: cicirello/generate-sitemap@v1
        with:
-          base-url-path: https://CarmJos.github.io/EasyConfiguration
+          base-url-path: https://CarmJos.github.io/configured
          path-to-root: docs

      - name: "Output stats"
@@ -72,7 +72,7 @@ jobs:
        run: |
          cd docs
          git init
-          git remote add origin git@github.com:CarmJos/EasyConfiguration.git
+          git remote add origin git@github.com:CarmJos/configured.git
          git checkout -b gh-pages
          git add -A
          git commit -m "API Document generated."
@@ -1,6 +1,7 @@
                   GNU LESSER GENERAL PUBLIC LICENSE
                       Version 3, 29 June 2007

+
 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.
@@ -1,26 +1,24 @@
-```text
-   ____                _____          ____                    __  _
-  / __/__ ____ __ __  / ___/__  ___  / _(_)__ ___ _________ _/ /_(_)__  ___
- / _// _ `(_-</ // / / /__/ _ \/ _ \/ _/ / _ `/ // / __/ _ `/ __/ / _ \/ _ \
-/___/\_,_/___/\_, /  \___/\___/_//_/_//_/\_, /\_,_/_/  \_,_/\__/_/\___/_//_/
-             /___/                      /___/
-```
+<div align=center>
+<img src=".doc/images/banner.png"  alt="Banner"/>
+
+[![version](https://img.shields.io/github/v/release/CarmJos/configured)](https://github.com/CarmJos/configured/releases)
+[![License](https://img.shields.io/github/license/CarmJos/configured)](https://www.gnu.org/licenses/lgpl-3.0.html)
+[![workflow](https://github.com/CarmJos/configured/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/configured/actions/workflows/maven.yml)
+[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/configured/badge)](https://www.codefactor.io/repository/github/carmjos/configured)
+![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/configured)
+![](https://visitor-badge.glitch.me/badge?page_id=configured.readme)

 README LANGUAGES [ [**English**](README.md) | [中文](README_CN.md)  ]
+</div>

-# EasyConfiguration
+# configured (config-framework)

-[![version](https://img.shields.io/github/v/release/CarmJos/EasyConfiguration)](https://github.com/CarmJos/EasyConfiguration/releases)
-[![License](https://img.shields.io/github/license/CarmJos/EasyConfiguration)](https://www.gnu.org/licenses/lgpl-3.0.html)
-[![workflow](https://github.com/CarmJos/EasyConfiguration/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/EasyConfiguration/actions/workflows/maven.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/easyconfiguration/badge)](https://www.codefactor.io/repository/github/carmjos/easyconfiguration)
-![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/EasyConfiguration)
-![](https://visitor-badge.glitch.me/badge?page_id=EasyConfiguration.readme)
+_**"Once set, Simple get."**_ 

-**Easy _(to make)_ Configurations!**
+A simple, easy-to-use and universal solution for managing, loading, reading, 
+and updating configuration files. 

-A simple, easy-to-use and universal solution for managing configuration files.
-Enjoy the ease of use with customizable formats for loading, reading, and updating your configuration files.
+Supported **JSON**, **YAML**, **Hocon**, **TOML**, **SQL**, **MongoDB**... and much more!

 ## Features & Advantages

@@ -35,13 +33,14 @@ format.

 ## Development

-For the latest JavaDoc release, [CLICK HERE](https://CarmJos.github.io/EasyConfiguration).
+For the latest JavaDoc release, [CLICK HERE](https://CarmJos.github.io/configured).

 For a detailed development guide, [CLICK HERE](.doc/README.md).

 ### Code Samples

 To quickly demonstrate the applicability of the project, here are a few practical demonstrations:
+
 - [Database configuration.](demo/src/main/java/cc/carm/lib/configuration/demo/DatabaseConfiguration.java)
 - [Demonstration of all types of configuration instance classes.](demo/src/main/java/cc/carm/lib/configuration/demo/tests/conf/DemoConfiguration.java)

@@ -49,35 +48,36 @@ Check out all code demonstrations [HERE](demo/src/main/java/cc/carm/lib/configur
 For more examples, see the [Development Guide](.doc/README.md).

 ```java
+
@ConfigPath(root = true)
@HeaderComments("Configurations for sample")
 public interface SampleConfig extends Configuration {

-  @InlineComment("Enabled?") // Inline comment
-  ConfiguredValue<Boolean> ENABLED = ConfiguredValue.of(true);
+    @InlineComment("Enabled?") // Inline comment
+    ConfiguredValue<Boolean> ENABLED = ConfiguredValue.of(true);

-  @HeaderComments("Server configurations") // Header comment
-  ConfiguredValue<Integer> PORT = ConfiguredValue.of(Integer.class);
+    @HeaderComments("Server configurations") // Header comment
+    ConfiguredValue<Integer> PORT = ConfiguredValue.of(Integer.class);

-  @HeaderComments({"[ UUID >-----------------------------------", "A lot of UUIDs"})
-  @FooterComments("[ UUID >-----------------------------------")
-  ConfiguredList<UUID> UUIDS = ConfiguredList.builderOf(UUID.class).fromString()
-          .parse(UUID::fromString).serialize(UUID::toString)
-          .defaults(
-                  UUID.fromString("00000000-0000-0000-0000-000000000000"),
-                  UUID.fromString("00000000-0000-0000-0000-000000000001")
-          ).build();
+    @HeaderComments({"[ UUID >-----------------------------------", "A lot of UUIDs"})
+    @FooterComments("[ UUID >-----------------------------------")
+    ConfiguredList<UUID> UUIDS = ConfiguredList.builderOf(UUID.class).fromString()
+            .parse(UUID::fromString).serialize(UUID::toString)
+            .defaults(
+                    UUID.fromString("00000000-0000-0000-0000-000000000000"),
+                    UUID.fromString("00000000-0000-0000-0000-000000000001")
+            ).build();

-  @ConfigPath("info") // Custom path
-  interface INFO extends Configuration {
+    @ConfigPath("info") // Custom path
+    interface INFO extends Configuration {

-    @HeaderComments("Configure your name!") // Header comment
-    ConfiguredValue<String> NAME = ConfiguredValue.of("Joker");
+        @HeaderComments("Configure your name!") // Header comment
+        ConfiguredValue<String> NAME = ConfiguredValue.of("Joker");

-    @ConfigPath("how-old-are-you") // Custom path
-    ConfiguredValue<Integer> AGE = ConfiguredValue.of(24);
+        @ConfigPath("how-old-are-you") // Custom path
+        ConfiguredValue<Integer> AGE = ConfiguredValue.of(24);

-  }
+    }

 }

@@ -85,23 +85,23 @@ public interface SampleConfig extends Configuration {

 ```java
 public class Sample {
-  public static void main(String[] args) {
-    // 1. Make a configuration provider from a file.
-    ConfigurationHolder<?> holder = YAMLConfigFactory.from("target/config.yml")
-            .resourcePath("configs/sample.yml")
-            .indent(4) // Optional: Set the indentation of the configuration file.
-            .build();
+    public static void main(String[] args) {
+        // 1. Make a configuration provider from a file.
+        ConfigurationHolder<?> holder = YAMLConfigFactory.from("target/config.yml")
+                .resourcePath("configs/sample.yml")
+                .indent(4) // Optional: Set the indentation of the configuration file.
+                .build();

-    // 2. Initialize the configuration classes or instances.
-    holder.initialize(SampleConfig.class);
-    // 3. Enjoy using the configuration!
-    System.out.println("Enabled? -> " + SampleConfig.ENABLED.resolve());
-    SampleConfig.ENABLED.set(false);
-    System.out.println("And now? -> " + SampleConfig.ENABLED.resolve());
-    // p.s. Changes not save so enable value will still be true in the next run.
+        // 2. Initialize the configuration classes or instances.
+        holder.initialize(SampleConfig.class);
+        // 3. Enjoy using the configuration!
+        System.out.println("Enabled? -> " + SampleConfig.ENABLED.resolve()); // true
+        SampleConfig.ENABLED.set(false);
+        System.out.println("And now? -> " + SampleConfig.ENABLED.resolve()); // false
+        // p.s. Changes not save so enable value will still be true in the next run.

-    System.out.println("Your name is " + SampleConfig.INFO.NAME.resolve() + " (age=" + SampleConfig.INFO.AGE.resolve() + ")!");
-  }
+        System.out.println("Your name is " + SampleConfig.INFO.NAME.resolve() + " (age=" + SampleConfig.INFO.AGE.resolve() + ")!");
+    }
 }

 ```
@@ -148,9 +148,9 @@ info:

        <repository>
            <!-- Using GitHub dependencies for real-time updates, configuration required (recommended). -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

    </repositories>
@@ -169,7 +169,7 @@ info:
        <!-- Basic implementation part, requiring custom implementation of “Provider” and “Wrapper”. -->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -177,7 +177,7 @@ info:
        <!-- YAML file-based implementation, compatible with all Java environments. -->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-yaml</artifactId>
+            <artifactId>configured-yaml</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -185,7 +185,7 @@ info:
        <!-- JSON file-based implementation, compatible with all Java environments. -->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-gson</artifactId>
+            <artifactId>configured-gson</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -208,7 +208,7 @@ repositories {
    mavenCentral()

    // Using GitHub dependencies for real-time updates, configuration required (recommended).
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

 }
 ```
@@ -223,13 +223,13 @@ repositories {
 dependencies {

    // Basic implementation part, requiring custom implementation of “Provider” and “Wrapper”.
-    api "cc.carm.lib:easyconfiguration-core:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-core:[LATEST RELEASE]"

    // YAML file-based implementation, compatible with all Java environments.
-    api "cc.carm.lib:easyconfiguration-yaml:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-yaml:[LATEST RELEASE]"

    // JSON file-based implementation, compatible with all Java environments.
-    api "cc.carm.lib:easyconfiguration-gson:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-gson:[LATEST RELEASE]"

 }
 ```
@@ -240,7 +240,7 @@ dependencies {

 ### [**MineConfiguration**](https://github.com/CarmJos/MineConfiguration) (by @CarmJos)

-EasyConfiguration for MineCraft!
+configured for MineCraft!
 Easily manage configurations on MineCraft-related server platforms.

 Currently, it supports BungeeCord, Velocity, Bukkit (Spigot) servers,
@@ -254,7 +254,7 @@ Thank you for supporting open-source projects!

 Many thanks to Jetbrains for kindly providing a license for us to work on this and other open-source projects.

-[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/EasyConfiguration)
+[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/configured)

 Many thanks to [ArtformGames](https://github.com/ArtformGames) for their
 strong support and active contribution to this project!
@@ -1,29 +1,26 @@
-```text
-   ____                _____          ____                    __  _
-  / __/__ ____ __ __  / ___/__  ___  / _(_)__ ___ _________ _/ /_(_)__  ___
- / _// _ `(_-</ // / / /__/ _ \/ _ \/ _/ / _ `/ // / __/ _ `/ __/ / _ \/ _ \
-/___/\_,_/___/\_, /  \___/\___/_//_/_//_/\_, /\_,_/_/  \_,_/\__/_/\___/_//_/
-             /___/                      /___/
-```
+<div align=center>
+<img src=".doc/images/banner.png"  alt="Banner"/>
+
+[![version](https://img.shields.io/github/v/release/CarmJos/configured)](https://github.com/CarmJos/configured/releases)
+[![License](https://img.shields.io/github/license/CarmJos/configured)](https://www.gnu.org/licenses/lgpl-3.0.html)
+[![workflow](https://github.com/CarmJos/configured/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/configured/actions/workflows/maven.yml)
+[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/configured/badge)](https://www.codefactor.io/repository/github/carmjos/configured)
+![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/configured)
+![](https://visitor-badge.glitch.me/badge?page_id=configured.readme)

 README LANGUAGES [ [English](README.md) | [**中文**](README_CN.md)  ]

-# EasyConfiguration
+</div>

-[![version](https://img.shields.io/github/v/release/CarmJos/EasyConfiguration)](https://github.com/CarmJos/EasyConfiguration/releases)
-[![License](https://img.shields.io/github/license/CarmJos/EasyConfiguration)](https://www.gnu.org/licenses/lgpl-3.0.html)
-[![workflow](https://github.com/CarmJos/EasyConfiguration/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/EasyConfiguration/actions/workflows/maven.yml)
-[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/easyconfiguration/badge)](https://www.codefactor.io/repository/github/carmjos/easyconfiguration)
-![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/EasyConfiguration)
-![](https://visitor-badge.glitch.me/badge?page_id=EasyConfiguration.readme)
+# configured (config-framework)

-**轻松(做)配置！**
+**一次配置，轻松读取！**

 一款简单便捷的通用配置文件加载、读取与更新工具，可自定义配置的格式。

 ## 特性 & 优势

-支持 [YAML](impl/yaml), [JSON](impl/json), [HOCON](impl/hocon) 和 [SQL](impl/sql) 等多种配置文件格式。
+支持 [YAML](providers/yaml), [JSON](providers/gson), [HOCON](providers/hocon) 和 [SQL](providers/sql) 等多种配置文件格式。

 - 基于类的配置文件初始化、加载、获取与更新机制，方便快捷。
 - 支持复杂配置的手动序列化、反序列化。
@@ -33,7 +30,7 @@ README LANGUAGES [ [English](README.md) | [**中文**](README_CN.md)  ]
 ## 开发

 详细开发介绍请 [点击这里](.doc/README.md) , JavaDoc(最新Release)
-请 [点击这里](https://CarmJos.github.io/EasyConfiguration) 。
+请 [点击这里](https://CarmJos.github.io/configured) 。

 ### 示例代码

@@ -142,9 +139,9 @@ info:

        <repository>
            <!--采用github依赖库，实时更新，但需要配置 (推荐) -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

        <repository>
@@ -170,7 +167,7 @@ info:
        <!--基础实现部分，需要自行实现“Provider”与“Wrapper”。-->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -178,7 +175,7 @@ info:
        <!--基于YAML文件的实现版本，可用于全部Java环境。-->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-yaml</artifactId>
+            <artifactId>configured-yaml</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -187,21 +184,21 @@ info:
        <!--需要注意的是，JSON不支持文件注释。-->
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-gson</artifactId>
+            <artifactId>configured-gson</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-hocon</artifactId>
+            <artifactId>configured-hocon</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-sql</artifactId>
+            <artifactId>configured-sql</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -224,7 +221,7 @@ repositories {
    mavenCentral()

    // 采用github依赖库，实时更新，但需要配置 (推荐)
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

    // 采用我的私人依赖库，简单方便，但可能因为变故而无法使用
    maven { url 'https://repo.carm.cc/repository/maven-public/' }
@@ -241,18 +238,18 @@ repositories {
 dependencies {

    //基础实现部分，需要自行实现“Provider”与“Wrapper”。
-    api "cc.carm.lib:easyconfiguration-core:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-core:[LATEST RELEASE]"

    //基于YAML文件的实现版本，可用于全部Java环境。
-    api "cc.carm.lib:easyconfiguration-yaml:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-yaml:[LATEST RELEASE]"

    //基于JSON文件的实现版本，可用于全部Java环境。
    //需要注意的是，JSON不支持文件注释。
-    api "cc.carm.lib:easyconfiguration-gson:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-gson:[LATEST RELEASE]"

-    api "cc.carm.lib:easyconfiguration-hocon:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-hocon:[LATEST RELEASE]"

-    api "cc.carm.lib:easyconfiguration-sql:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-sql:[LATEST RELEASE]"

 }
 ```
@@ -263,7 +260,7 @@ dependencies {

 ### [**MineConfiguration**](https://github.com/CarmJos/MineConfiguration) (by @CarmJos )

-EasyConfiguration for MineCraft!
+configured for MineCraft!
 开始在 MineCraft 相关服务器平台上轻松(做)配置吧！

 目前支持 BungeeCord, Bukkit(Spigot) 服务端，后续将支持更多平台。
@@ -276,7 +273,7 @@ EasyConfiguration for MineCraft!

 万分感谢 Jetbrains 为我们提供了从事此项目和其他开源项目的许可！

-[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/EasyConfiguration)
+[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/configured)

 万分感谢来自 [ArtformGames](https://github.com/ArtformGames) 对本项目的大力支持与积极贡献！

@@ -3,9 +3,9 @@
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.7</version>
+        <version>4.1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <properties>
@@ -15,7 +15,7 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-core</artifactId>
+    <artifactId>configured-core</artifactId>
    <packaging>jar</packaging>

    <build>
@@ -4,6 +4,7 @@ import org.jetbrains.annotations.NotNull;

 import java.lang.reflect.ParameterizedType;
 import java.lang.reflect.Type;
+import java.util.List;
 import java.util.Map;
 import java.util.Objects;

@@ -157,7 +158,7 @@ public abstract class ValueType<T> {
            ParameterizedType pt = (ParameterizedType) type;
            Type raw = pt.getRawType();
            StringBuilder sb = new StringBuilder();
-            sb.append(raw.getTypeName());
+            sb.append(raw.getClass().getName());
            sb.append('<');
            Type[] args = pt.getActualTypeArguments();
            for (int i = 0; i < args.length; i++) {
@@ -166,6 +167,7 @@ public abstract class ValueType<T> {
                }
                sb.append(args[i].getTypeName());
            }
+            sb.append('>');
            return sb.toString();
        }
        return type.getTypeName();
@@ -49,9 +49,7 @@ public abstract class AbstractSectionBuilder<
    }

    public @NotNull SELF serialize(@NotNull DataFunction<PARAM, ? extends Map<String, Object>> serializer) {
-        return serialize((p, value) -> {
-            return serializer.handle(value);
-        });
+        return serialize((p, value) -> serializer.handle(value));
    }

    public @NotNull SELF serialize(@NotNull ValueConsumer<Map<String, Object>, PARAM> serializer) {
@@ -3,10 +3,7 @@ package cc.carm.lib.configuration.builder.map;
 import cc.carm.lib.configuration.adapter.ValueType;
 import org.jetbrains.annotations.NotNull;

-import java.util.HashMap;
-import java.util.LinkedHashMap;
-import java.util.Map;
-import java.util.TreeMap;
+import java.util.*;
 import java.util.function.Supplier;

 public class ConfigMapCreator<K, V> {
@@ -45,4 +42,8 @@ public class ConfigMapCreator<K, V> {
        return constructor(TreeMap::new);
    }

+    public @NotNull ConfigMapBuilder<TreeMap<K, V>, K, V> asTreeMap(@NotNull Comparator<? super K> comparator) {
+        return constructor(() -> new TreeMap<>(comparator));
+    }
+
 }
@@ -75,6 +75,10 @@ public class SectionMapBuilder<MAP extends Map<K, V>, K, V>
        });
    }

+    public @NotNull SectionMapBuilder<MAP, K, V> defaults(@NotNull K key, @NotNull V value) {
+        return defaults(map -> map.put(key, value));
+    }
+
    public @NotNull ValueAdapter<K> buildKeyAdapter() {
        return new ValueAdapter<>(this.keyType)
                .parser((holder, type, data) -> {
@@ -53,6 +53,10 @@ public class SourceMapBuilder<MAP extends Map<K, V>, SOURCE, K, V>
        });
    }

+    public @NotNull SourceMapBuilder<MAP, SOURCE, K, V> defaults(@NotNull K key, @NotNull V value) {
+        return defaults(map -> map.put(key, value));
+    }
+
    public @NotNull SourceMapBuilder<MAP, SOURCE, K, V> parseKey(@NotNull DataFunction<String, K> keyParser) {
        return parseKey((holder, data) -> keyParser.handle(data));
    }
@@ -6,9 +6,11 @@ import cc.carm.lib.configuration.adapter.ValueType;
 import cc.carm.lib.configuration.source.loader.ConfigurationInitializer;
 import cc.carm.lib.configuration.source.meta.ConfigurationMetaHolder;
 import cc.carm.lib.configuration.source.meta.ConfigurationMetadata;
+import cc.carm.lib.configuration.source.meta.StandardMeta;
 import cc.carm.lib.configuration.source.option.ConfigurationOption;
 import cc.carm.lib.configuration.source.option.ConfigurationOptionHolder;
 import cc.carm.lib.configuration.source.section.ConfigureSource;
+import cc.carm.lib.configuration.value.ConfigValue;
 import cc.carm.lib.configuration.value.ValueManifest;
 import org.jetbrains.annotations.Contract;
 import org.jetbrains.annotations.NotNull;
@@ -18,6 +20,8 @@ import org.jetbrains.annotations.UnmodifiableView;
 import java.util.Collections;
 import java.util.LinkedHashMap;
 import java.util.Map;
+import java.util.Objects;
+import java.util.function.Predicate;

 public abstract class ConfigurationHolder<SOURCE extends ConfigureSource<?, ?, SOURCE>> {

@@ -51,7 +55,7 @@ public abstract class ConfigurationHolder<SOURCE extends ConfigureSource<?, ?, S
        return options;
    }

-    public <O> O option(@NotNull ConfigurationOption<O> option) {
+    public <O> @NotNull O option(@NotNull ConfigurationOption<O> option) {
        return options().get(option);
    }

@@ -66,14 +70,26 @@ public abstract class ConfigurationHolder<SOURCE extends ConfigureSource<?, ?, S
    @NotNull
    @UnmodifiableView
    public <M> Map<String, M> extractMetadata(@NotNull ConfigurationMetadata<M> type) {
+        return extractMetadata(type, Objects::nonNull);
+    }
+
+    @NotNull
+    @UnmodifiableView
+    public <M> Map<String, M> extractMetadata(@NotNull ConfigurationMetadata<M> type, @NotNull Predicate<M> filter) {
        Map<String, M> metas = new LinkedHashMap<>();
        for (Map.Entry<String, ConfigurationMetaHolder> entry : this.metadata.entrySet()) {
            M data = entry.getValue().get(type);
-            if (data != null) metas.put(entry.getKey(), data);
+            if (filter.test(data)) metas.put(entry.getKey(), data);
        }
        return Collections.unmodifiableMap(metas);
    }

+    @NotNull
+    @UnmodifiableView
+    public Map<String, ConfigValue<?>> registeredValues() {
+        return extractMetadata(StandardMeta.VALUE);
+    }
+
    public ValueAdapterRegistry adapters() {
        return this.adapters;
    }
@@ -5,26 +5,27 @@ import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

@FunctionalInterface
-public interface ConfigInitializeHandler<T> {
+public interface ConfigInitializeHandler<T, V> {

-    static <T> ConfigInitializeHandler<T> start() {
-        return (provider, path, value) -> {
+    static <T, V> ConfigInitializeHandler<T, V> start() {
+        return (provider, path, value, instace) -> {
        };
    }

-    void whenInitialize(@NotNull ConfigurationHolder<?> holder, @Nullable String path, @NotNull T value) throws Exception;
+    void whenInitialize(@NotNull ConfigurationHolder<?> holder, @Nullable String path,
+                        @NotNull T value, @Nullable V instance) throws Exception;

-    default ConfigInitializeHandler<T> andThen(ConfigInitializeHandler<T> after) {
-        return (provider, path, value) -> {
-            whenInitialize(provider, path, value);
-            after.whenInitialize(provider, path, value);
+    default ConfigInitializeHandler<T, V> andThen(ConfigInitializeHandler<T, V> after) {
+        return (provider, path, value, instance) -> {
+            whenInitialize(provider, path, value, instance);
+            after.whenInitialize(provider, path, value, instance);
        };
    }

-    default ConfigInitializeHandler<T> compose(ConfigInitializeHandler<T> before) {
-        return (provider, path, value) -> {
-            before.whenInitialize(provider, path, value);
-            whenInitialize(provider, path, value);
+    default ConfigInitializeHandler<T, V> compose(ConfigInitializeHandler<T, V> before) {
+        return (provider, path, value, instance) -> {
+            before.whenInitialize(provider, path, value, instance);
+            whenInitialize(provider, path, value, instance);
        };
    }

@@ -21,18 +21,18 @@ import java.util.function.Function;
 public class ConfigurationInitializer {

    protected @NotNull PathGenerator pathGenerator;
-    protected @NotNull ConfigInitializeHandler<Field> fieldInitializer;
-    protected @NotNull ConfigInitializeHandler<Class<? extends Configuration>> classInitializer;
+    protected @NotNull ConfigInitializeHandler<Field, ConfigValue<?>> valueInitializer;
+    protected @NotNull ConfigInitializeHandler<Class<? extends Configuration>, Object> classInitializer;

    public ConfigurationInitializer() {
        this(PathGenerator.of(), ConfigInitializeHandler.start(), ConfigInitializeHandler.start());
    }

    public ConfigurationInitializer(@NotNull PathGenerator pathGenerator,
-                                    @NotNull ConfigInitializeHandler<Field> fieldInitializer,
-                                    @NotNull ConfigInitializeHandler<Class<? extends Configuration>> classInitializer) {
+                                    @NotNull ConfigInitializeHandler<Field, ConfigValue<?>> valueInitializer,
+                                    @NotNull ConfigInitializeHandler<Class<? extends Configuration>, Object> classInitializer) {
        this.pathGenerator = pathGenerator;
-        this.fieldInitializer = fieldInitializer;
+        this.valueInitializer = valueInitializer;
        this.classInitializer = classInitializer;
    }

@@ -44,34 +44,34 @@ public class ConfigurationInitializer {
        return pathGenerator;
    }

-    public ConfigInitializeHandler<Field> fieldInitializer() {
-        return fieldInitializer;
+    public ConfigInitializeHandler<Field, ConfigValue<?>> fieldInitializer() {
+        return valueInitializer;
    }

-    public void fieldInitializer(@NotNull ConfigInitializeHandler<Field> fieldInitializer) {
-        this.fieldInitializer = fieldInitializer;
+    public void fieldInitializer(@NotNull ConfigInitializeHandler<Field, ConfigValue<?>> fieldInitializer) {
+        this.valueInitializer = fieldInitializer;
    }

-    public ConfigInitializeHandler<Class<? extends Configuration>> classInitializer() {
+    public ConfigInitializeHandler<Class<? extends Configuration>, Object> classInitializer() {
        return classInitializer;
    }

-    public void classInitializer(@NotNull ConfigInitializeHandler<Class<? extends Configuration>> classInitializer) {
+    public void classInitializer(@NotNull ConfigInitializeHandler<Class<? extends Configuration>, Object> classInitializer) {
        this.classInitializer = classInitializer;
    }

-    public void appendFieldInitializer(@NotNull ConfigInitializeHandler<Field> fieldInitializer) {
-        this.fieldInitializer = this.fieldInitializer.andThen(fieldInitializer);
+    public void appendFieldInitializer(@NotNull ConfigInitializeHandler<Field, ConfigValue<?>> fieldInitializer) {
+        this.valueInitializer = this.valueInitializer.andThen(fieldInitializer);
    }

-    public void appendClassInitializer(@NotNull ConfigInitializeHandler<Class<? extends Configuration>> classInitializer) {
+    public void appendClassInitializer(@NotNull ConfigInitializeHandler<Class<? extends Configuration>, Object> classInitializer) {
        this.classInitializer = this.classInitializer.andThen(classInitializer);
    }

    public <T, A extends Annotation> void registerClassAnnotation(@NotNull Class<A> annotation,
                                                                  @NotNull ConfigurationMetadata<T> metadata,
                                                                  @NotNull Function<A, T> extractor) {
-        appendClassInitializer((holder, path, clazz) -> {
+        appendClassInitializer((holder, path, clazz, instance) -> {
            A data = clazz.getAnnotation(annotation);
            if (data == null) return;
            holder.metadata(path).setIfAbsent(metadata, extractor.apply(data));
@@ -81,7 +81,7 @@ public class ConfigurationInitializer {
    public <T, A extends Annotation> void registerFieldAnnotation(@NotNull Class<A> annotation,
                                                                  @NotNull ConfigurationMetadata<T> metadata,
                                                                  @NotNull Function<A, T> extractor) {
-        appendFieldInitializer((holder, path, field) -> {
+        appendFieldInitializer((holder, path, field, instance) -> {
            A data = field.getAnnotation(annotation);
            if (data == null) return;
            holder.metadata(path).setIfAbsent(metadata, extractor.apply(data));
@@ -123,7 +123,7 @@ public class ConfigurationInitializer {
                                      @Nullable String parentPath, @Nullable Field configField) {
        String path = getClassPath(holder, parentPath, root.getClass(), configField);
        try {
-            this.classInitializer.whenInitialize(holder, path, root.getClass());
+            this.classInitializer.whenInitialize(holder, path, root.getClass(), root);
        } catch (Exception e) {
            e.printStackTrace();
        }
@@ -140,7 +140,7 @@ public class ConfigurationInitializer {
        String path = getClassPath(holder, parentPath, clazz, configField);

        try {
-            this.classInitializer.whenInitialize(holder, path, (Class<? extends Configuration>) clazz);
+            this.classInitializer.whenInitialize(holder, path, (Class<? extends Configuration>) clazz, configField);
        } catch (Exception e) {
            e.printStackTrace();
        }
@@ -169,15 +169,15 @@ public class ConfigurationInitializer {
                String path = getFieldPath(holder, parent, field);
                if (path == null) return;
                value.initialize(holder, path);
-                holder.metadata(path).set(StandardMeta.UNIT, true); // Mark the minimal config value unit.
-                try {
-                    this.fieldInitializer.whenInitialize(holder, path, field);
-                } catch (Exception e) {
-                    e.printStackTrace();
-                }
+                holder.metadata(path).set(StandardMeta.VALUE, value); // Mark the minimal config value unit.
                if (holder.option(StandardOptions.SET_DEFAULTS)) {
                    value.setDefault(); // Set default value.
                }
+                try {
+                    this.valueInitializer.whenInitialize(holder, path, field, value);
+                } catch (Exception e) {
+                    e.printStackTrace();
+                }
                if (holder.option(StandardOptions.PRELOAD)) {
                    value.get(); // Preload the value by calling #get method.
                }
@@ -1,10 +1,12 @@
 package cc.carm.lib.configuration.source.meta;

+import cc.carm.lib.configuration.value.ConfigValue;
+
 public interface StandardMeta {

    /**
-     * To mark the {@link cc.carm.lib.configuration.value.ConfigValue} as a minimal unit path.
+     * To mark the {@link ConfigValue} instance of specific path.
     */
-    ConfigurationMetadata<Boolean> UNIT = ConfigurationMetadata.of(false);
+    ConfigurationMetadata<ConfigValue<?>> VALUE = ConfigurationMetadata.of();

 }
@@ -23,12 +23,13 @@ public interface StandardOptions {
    ConfigurationOption<Boolean> LOAD_SUB_CLASSES = of(true);

    /**
-     * Whether to pre parse the config values.
-     * <br> if false, the values will be parsed when calling
-     * {@link cc.carm.lib.configuration.value.ConfigValue#get()}
+     * Whether to pre parse the config values,
+     * may good to set true if you want to keep the config format.
     * <br> if true, the values will be parsed when
     * {@link ConfigurationHolder#initialize(Configuration)}.
+     * <br> if false, the values will be parsed when calling
+     * {@link cc.carm.lib.configuration.value.ConfigValue#get()}
     */
-    ConfigurationOption<Boolean> PRELOAD = of(false);
+    ConfigurationOption<Boolean> PRELOAD = of(true);

 }
@@ -48,7 +48,6 @@ public interface ConfigureSection {
        return (parent().isRoot() ? "" : parent().fullPath() + pathSeparator()) + path();
    }

-
    /**
     * Get the path separator for the section.
     *
@@ -143,6 +142,17 @@ public interface ConfigureSection {
        return getValues(false);
    }

+    /**
+     * Get this section as a map.
+     * <p>
+     * In this map, child {@link ConfigureSection}s will also be represented as {@link Map}s.
+     *
+     * @return Map of data values contained within this Section.
+     */
+    @NotNull
+    @UnmodifiableView
+    Map<String, Object> asMap();
+
    /**
     * Create a stream of all values in this section.
     *
@@ -153,7 +163,7 @@ public interface ConfigureSection {
    }

    /**
-     * Iterates over all keys in this section.
+     * Iterates over all key-values in this section (include child sections)
     *
     * @param action The action to apply to each key.
     */
@@ -107,6 +107,11 @@ public abstract class ConfigureSource<
        return section().getKeys(deep);
    }

+    @Override
+    public @NotNull @UnmodifiableView Map<String, Object> asMap() {
+        return section().asMap();
+    }
+
    @Override
    public @NotNull ConfigureSection createSection(@NotNull String path, @NotNull Map<?, ?> data) {
        return section().createSection(path, data);
@@ -4,6 +4,7 @@ import cc.carm.lib.configuration.adapter.ValueType;
 import cc.carm.lib.configuration.source.ConfigurationHolder;
 import cc.carm.lib.configuration.source.meta.ConfigurationMetaHolder;
 import cc.carm.lib.configuration.source.section.ConfigureSource;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

@@ -20,7 +21,6 @@ public class ValueManifest<T> {

    protected @NotNull Supplier<@Nullable T> defaultSupplier;

-
    public ValueManifest(@NotNull ValueType<T> type) {
        this(type, () -> null, EMPTY_INITIALIZER, null, null);
    }
@@ -93,12 +93,12 @@ public class ValueManifest<T> {

    public @NotNull String path() {
        if (path != null) return path;
-        else throw new IllegalStateException("No section path provided.");
+        else throw new IllegalStateException("No section path provided for Value(" + type() + ").");
    }

    public @NotNull ConfigurationHolder<?> holder() {
        if (this.holder != null) return this.holder;
-        throw new IllegalStateException("Value does not have a provider.");
+        throw new IllegalStateException("Value(" + type() + ") does not have a provider.");
    }

    public @NotNull ConfigureSource<?, ?, ?> config() {
@@ -109,16 +109,17 @@ public class ValueManifest<T> {
        return holder().metadata(path());
    }

-    protected Object getData() {
+    @ApiStatus.Internal
+    protected @Nullable Object getData() {
        return config().get(path());
    }

+    @ApiStatus.Internal
    protected void setData(@Nullable Object value) {
        config().set(path(), value);
    }

-
-    private static final @NotNull BiConsumer<@NotNull ConfigurationHolder<?>, @NotNull String> EMPTY_INITIALIZER = (provider, path) -> {
+    private static final @NotNull BiConsumer<@NotNull ConfigurationHolder<?>, @NotNull String> EMPTY_INITIALIZER = (provider, valuePath) -> {
    };

 }
@@ -3,9 +3,9 @@
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.7</version>
+        <version>4.1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <properties>
@@ -14,21 +14,28 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>
-    <artifactId>easyconfiguration-demo</artifactId>
+    <artifactId>configured-demo</artifactId>
    <packaging>jar</packaging>

    <dependencies>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-commentable</artifactId>
+            <artifactId>configured-feature-commentable</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>${project.parent.groupId}</groupId>
+            <artifactId>configured-feature-versioned</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
@@ -7,7 +7,7 @@ import cc.carm.lib.configuration.value.ConfigValue;
 import cc.carm.lib.configuration.value.standard.ConfiguredValue;

@HeaderComments({"", "数据库配置", "  用于提供数据库连接，进行数据库操作。"})
-public class DatabaseConfiguration implements Configuration {
+public interface DatabaseConfiguration extends Configuration {

    @ConfigPath("driver")
    @HeaderComments({
@@ -16,18 +16,19 @@ public class DatabaseConfiguration implements Configuration {
            "- MySQL(新): com.mysql.cj.jdbc.Driver",
            "- MariaDB(推荐): org.mariadb.jdbc.Driver",
    })
-    protected static final ConfigValue<String> DRIVER_NAME = ConfiguredValue.of(
+    ConfigValue<String> DRIVER_NAME = ConfiguredValue.of(
            String.class, "com.mysql.cj.jdbc.Driver"
    );

-    protected static final ConfigValue<String> HOST = ConfiguredValue.of(String.class, "127.0.0.1");
-    protected static final ConfigValue<Integer> PORT = ConfiguredValue.of(Integer.class, 3306);
-    protected static final ConfigValue<String> DATABASE = ConfiguredValue.of(String.class, "minecraft");
-    protected static final ConfigValue<String> USERNAME = ConfiguredValue.of(String.class, "root");
-    protected static final ConfigValue<String> PASSWORD = ConfiguredValue.of(String.class, "password");
-    protected static final ConfigValue<String> EXTRA = ConfiguredValue.of(String.class, "?useSSL=false");
+    ConfigValue<String> HOST = ConfiguredValue.of(String.class, "127.0.0.1");
+    ConfigValue<Integer> PORT = ConfiguredValue.of(Integer.class, 3306);
+    ConfigValue<String> DATABASE = ConfiguredValue.of(String.class, "minecraft");
+    ConfigValue<String> USERNAME = ConfiguredValue.of(String.class, "root");
+    ConfigValue<String> PASSWORD = ConfiguredValue.of(String.class, "password");

-    protected static String buildJDBC() {
+    ConfigValue<String> EXTRA = ConfiguredValue.of(String.class, "?useSSL=false");
+
+    static String buildJDBC() {
        return String.format("jdbc:mysql://%s:%s/%s%s", HOST.get(), PORT.get(), DATABASE.get(), EXTRA.get());
    }

@@ -69,14 +69,14 @@ public class ConfigurationTest {
        provider.initialize(TEST);

        System.out.println("> Test Inner value before:");
-        System.out.println(TEST.INSTANCE.INNER_VALUE.resolve());
+        System.out.println(TEST.INSTANCE.STATUS.resolve());

        double after = Math.random() * 200D;
        System.out.println("> Test Inner value -> " + after);
-        TEST.INSTANCE.INNER_VALUE.set(after);
+        TEST.INSTANCE.STATUS.set(after);

        System.out.println("> Test Inner value after:");
-        System.out.println(TEST.INSTANCE.INNER_VALUE.resolve());
+        System.out.println(TEST.INSTANCE.STATUS.resolve());

    }

@@ -1,11 +1,7 @@
 package cc.carm.lib.configuration.demo.tests.conf;

 import cc.carm.lib.configuration.Configuration;
-import cc.carm.lib.configuration.annotation.ConfigPath;
-import cc.carm.lib.configuration.annotation.FooterComments;
-import cc.carm.lib.configuration.annotation.HeaderComments;
-import cc.carm.lib.configuration.annotation.InlineComment;
-import cc.carm.lib.configuration.demo.DatabaseConfiguration;
+import cc.carm.lib.configuration.annotation.*;
 import cc.carm.lib.configuration.demo.tests.model.ItemStack;
 import cc.carm.lib.configuration.demo.tests.model.UserRecord;
 import cc.carm.lib.configuration.value.ConfigValue;
@@ -24,12 +20,13 @@ import java.util.UUID;
        "------------------------------------------------",
        "此处内容将显示在配置文件的最下方",
        "可用于显示版权信息等",
-        "感谢您使用 https://github.com/CarmJos/EasyConfiguration !"
+        "感谢您使用 https://github.com/CarmJos/configured !"
 })
 public interface DemoConfiguration extends Configuration {

    @ConfigPath(root = true)
-    ConfigValue<Double> VERSION = ConfiguredValue.of(Double.class, 1.0D);
+    @ConfigVersion(2)
+    ConfigValue<Double> VERSION = ConfiguredValue.of(Double.class, 2.0D);

    @ConfigPath(root = true)
    @FooterComments({"此处内容将显示在配置条目的下方", "可用于补充说明，但一般不建议使用"})
@@ -39,9 +36,11 @@ public interface DemoConfiguration extends Configuration {
    @FooterComments({"上述的枚举内容本质上是通过STRING解析的"})
    ConfigValue<ChronoUnit> TEST_ENUM = ConfiguredValue.of(ChronoUnit.class, ChronoUnit.DAYS);

-    // 支持通过 Class<?> 变量标注子配置，一并注册。
-    // 注意： 若对应类也有注解，则优先使用类的注解。
-    Class<?> DATABASE = DatabaseConfiguration.class;
+    @HeaderComments({"空值测试"})
+    @InlineComment("空值Inline注释")
+    ConfiguredMap<String, String> EMPTY = ConfiguredMap.builderOf(String.class, String.class)
+            .asLinkedMap().fromString()
+            .build();

    @ConfigPath("registered_users") // 通过注解规定配置文件中的路径，若不进行注解则以变量名自动生成。
    @HeaderComments({"Section类型数据测试"}) // 通过注解给配置添加注释。
@@ -8,6 +8,6 @@ import cc.carm.lib.configuration.value.standard.ConfiguredValue;
@HeaderComments("Inner Test")
 public class InstanceConfig implements Configuration {

-    public final ConfigValue<Double> INNER_VALUE = ConfiguredValue.of(1.0D);
+    public final ConfigValue<Double> STATUS = ConfiguredValue.of(1.0D);

 }
@@ -20,7 +20,7 @@ public class RegistryConfig implements Configuration {
    @FooterComments({"12313213212"})
    @InlineComment(value = "用户名(匹配注释)", regex = "name") // 通过注解给配置添加注释。
    @InlineComment(value = "信息", regex = {"info.*", "info.game.*"}) // 通过注解给配置添加注释。
-    public final ConfigValue<UserRecord> TEST_MODEL = ConfiguredValue.builderOf(UserRecord.class).fromSection()
+    public final ConfigValue<UserRecord> OWNER = ConfiguredValue.builderOf(UserRecord.class).fromSection()
            .defaults(new UserRecord("Carm", UUID.randomUUID()))
            .parse((holder, section) -> UserRecord.deserialize(section))
            .serialize((holder, data) -> data.serialize()).build();
@@ -5,8 +5,8 @@
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.7</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -16,13 +16,13 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-feature-commentable</artifactId>
+    <artifactId>configured-feature-commentable</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
@@ -49,6 +49,17 @@ public interface CommentableMeta {
                FooterComments.class, FOOTER,
                a -> Arrays.asList(a.value())
        );
+        initializer.registerAnnotation(InlineComment.class, INLINE, a -> {
+            Map<String, String> map = new HashMap<>();
+            if (a.regex().length == 0) { // for current path
+                map.put(null, a.value());
+                return map;
+            }
+            for (String regex : a.regex()) { // for specified path
+                map.put(regex, a.value());
+            }
+            return map;
+        });
        initializer.registerAnnotation(InlineComments.class, INLINE, a -> {
            Map<String, String> map = new HashMap<>();
            for (InlineComment comment : a.value()) {
@@ -5,8 +5,8 @@
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.7</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -16,13 +16,13 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-feature-file</artifactId>
+    <artifactId>configured-feature-file</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
@@ -5,8 +5,8 @@
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.7</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -16,13 +16,13 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-feature-section</artifactId>
+    <artifactId>configured-feature-section</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
@@ -75,12 +75,23 @@ public abstract class AbstractMapSection<R extends AbstractMapSection<R>> implem
        return deep ? getKeys(true).size() : this.data.size();
    }

+    @Override
    @UnmodifiableView
-    public @NotNull Map<String, Object> rawMap() {
+    public @NotNull Map<String, Object> asMap() {
        Map<String, Object> output = new LinkedHashMap<>();
        for (Map.Entry<String, Object> entry : this.data.entrySet()) {
            if (entry.getValue() instanceof AbstractMapSection<?>) {
-                output.put(entry.getKey(), ((AbstractMapSection<?>) entry.getValue()).rawMap());
+                output.put(entry.getKey(), ((AbstractMapSection<?>) entry.getValue()).asMap());
+            } else if (entry.getValue() instanceof List<?>) {
+                List<Object> list = new ArrayList<>();
+                for (Object obj : (List<?>) entry.getValue()) {
+                    if (obj instanceof AbstractMapSection<?>) {
+                        list.add(((AbstractMapSection<?>) obj).asMap());
+                    } else {
+                        list.add(obj);
+                    }
+                }
+                output.put(entry.getKey(), list);
            } else {
                output.put(entry.getKey(), entry.getValue());
            }
@@ -98,6 +109,11 @@ public abstract class AbstractMapSection<R extends AbstractMapSection<R>> implem
        return Collections.unmodifiableMap(deep ? mappingValues(this, null, true, String.valueOf(pathSeparator())) : data());
    }

+    @Override
+    public @NotNull @UnmodifiableView Set<String> getKeys(boolean deep) {
+        return Collections.unmodifiableSet(deep ? mappingKeys(this, null, true, String.valueOf(pathSeparator())) : data().keySet());
+    }
+
    @Override
    public void set(@NotNull String path, @Nullable Object value) {
        if (value instanceof Map) value = createSection(path, (Map<?, ?>) value);
@@ -157,5 +173,17 @@ public abstract class AbstractMapSection<R extends AbstractMapSection<R>> implem
        return output;
    }

+    protected static Set<String> mappingKeys(@NotNull AbstractMapSection<?> section, @Nullable String parent, boolean deep, String pathSeparator) {
+        Set<String> keys = new LinkedHashSet<>();
+        for (Map.Entry<String, Object> entry : section.data().entrySet()) {
+            String path = (parent == null ? "" : parent + pathSeparator) + entry.getKey();
+            keys.add(path);
+            if (deep && entry.getValue() instanceof AbstractMapSection<?>) {
+                keys.addAll(mappingKeys((AbstractMapSection<?>) entry.getValue(), path, true, pathSeparator));
+            }
+        }
+        return keys;
+    }
+

 }
@@ -20,13 +20,18 @@ public class ImmutableSection implements ConfigureSection {
    }

    protected final @Nullable ImmutableSection parent;
-    protected final @NotNull ConfigureSection section;
+    protected final @NotNull ConfigureSection raw;

-    private ImmutableSection(@Nullable ImmutableSection parent, @NotNull ConfigureSection section) {
+    private ImmutableSection(@Nullable ImmutableSection parent, @NotNull ConfigureSection raw) {
        this.parent = parent;
-        this.section = section;
+        this.raw = raw;
    }

+    private @NotNull ConfigureSection raw() {
+        return raw;
+    }
+
+
    @Override
    public @Nullable ImmutableSection parent() {
        return this.parent;
@@ -34,16 +39,12 @@ public class ImmutableSection implements ConfigureSection {

    @Override
    public @NotNull String path() {
-        return section().path();
-    }
-
-    private @NotNull ConfigureSection section() {
-        return section;
+        return raw().path();
    }

    @Override
    public @NotNull @UnmodifiableView Map<String, Object> getValues(boolean deep) {
-        return section().getValues(deep);
+        return raw().getValues(deep);
    }

    @Override
@@ -58,12 +59,12 @@ public class ImmutableSection implements ConfigureSection {

    @Override
    public @NotNull ImmutableSection createSection(@NotNull String path, @NotNull Map<?, ?> data) {
-        return new ImmutableSection(this, section().createSection(path, data));
+        return new ImmutableSection(this, raw().createSection(path, data));
    }

    @Override
    public @Nullable Object get(@NotNull String path) {
-        Object value = section().get(path);
+        Object value = raw().get(path);
        if (value instanceof ConfigureSection && !(value instanceof ImmutableSection)) {
            return new ImmutableSection(this, (ConfigureSection) value);
        }
@@ -72,7 +73,7 @@ public class ImmutableSection implements ConfigureSection {

    @Override
    public @Nullable ConfigureSection getSection(@NotNull String path) {
-        ConfigureSection get = section().getSection(path);
+        ConfigureSection get = raw().getSection(path);
        if (get != null && !(get instanceof ImmutableSection)) {
            return new ImmutableSection(this, get);
        }
@@ -81,297 +82,302 @@ public class ImmutableSection implements ConfigureSection {

    @Override
    public char pathSeparator() {
-        return section().pathSeparator();
+        return raw().pathSeparator();
    }

    @Override
    public boolean isRoot() {
-        return section().isRoot();
+        return raw().isRoot();
    }

    @Override
    public boolean isEmpty() {
-        return section().isEmpty();
+        return raw().isEmpty();
    }

    @Override
    public @NotNull @UnmodifiableView Set<String> getKeys(boolean deep) {
-        return section().getKeys(deep);
+        return raw().getKeys(deep);
    }

    @Override
    public @NotNull @UnmodifiableView Set<String> keys() {
-        return section().keys();
+        return raw().keys();
    }

    @Override
    public @NotNull @UnmodifiableView Map<String, Object> values() {
-        return section().values();
+        return raw().values();
+    }
+
+    @Override
+    public @NotNull @UnmodifiableView Map<String, Object> asMap() {
+        return raw().asMap();
    }

    @Override
    public Stream<Map.Entry<String, Object>> stream() {
-        return section().stream();
+        return raw().stream();
    }

    @Override
    public void forEach(@NotNull BiConsumer<String, Object> action) {
-        section().forEach(action);
+        raw().forEach(action);
    }

    @Override
    public boolean contains(@NotNull String path) {
-        return section().contains(path);
+        return raw().contains(path);
    }

    @Override
    public boolean containsValue(@NotNull String path) {
-        return section().containsValue(path);
+        return raw().containsValue(path);
    }

    @Override
    public <T> boolean isType(@NotNull String path, @NotNull Class<T> typeClass) {
-        return section().isType(path, typeClass);
+        return raw().isType(path, typeClass);
    }

    @Override
    public boolean isList(@NotNull String path) {
-        return section().isList(path);
+        return raw().isList(path);
    }

    @Override
    public @Nullable List<?> getList(@NotNull String path) {
-        return section().getList(path);
+        return raw().getList(path);
    }

    @Override
    public boolean isSection(@NotNull String path) {
-        return section().isSection(path);
+        return raw().isSection(path);
    }

    @Override
    public <T> @Nullable T get(@NotNull String path, @NotNull Class<T> type) {
-        return section().get(path, type);
+        return raw().get(path, type);
    }

    @Override
    public <T> @Nullable T get(@NotNull String path, @NotNull DataFunction<@Nullable Object, T> parser) {
-        return section().get(path, parser);
+        return raw().get(path, parser);
    }

    @Override
    public <T> @Nullable T get(@NotNull String path, @Nullable T defaults, @NotNull Class<T> clazz) {
-        return section().get(path, defaults, clazz);
+        return raw().get(path, defaults, clazz);
    }

    @Override
    public <T> @Nullable T get(@NotNull String path, @Nullable T defaultValue, @NotNull DataFunction<Object, T> parser) {
-        return section().get(path, defaultValue, parser);
+        return raw().get(path, defaultValue, parser);
    }

    @Override
    public boolean isBoolean(@NotNull String path) {
-        return section().isBoolean(path);
+        return raw().isBoolean(path);
    }

    @Override
    public boolean getBoolean(@NotNull String path) {
-        return section().getBoolean(path);
+        return raw().getBoolean(path);
    }

    @Override
    public @Nullable Boolean getBoolean(@NotNull String path, @Nullable Boolean def) {
-        return section().getBoolean(path, def);
+        return raw().getBoolean(path, def);
    }

    @Override
    public @Nullable Boolean isByte(@NotNull String path) {
-        return section().isByte(path);
+        return raw().isByte(path);
    }

    @Override
    public @Nullable Byte getByte(@NotNull String path) {
-        return section().getByte(path);
+        return raw().getByte(path);
    }

    @Override
    public @Nullable Byte getByte(@NotNull String path, @Nullable Byte def) {
-        return section().getByte(path, def);
+        return raw().getByte(path, def);
    }

    @Override
    public boolean isShort(@NotNull String path) {
-        return section().isShort(path);
+        return raw().isShort(path);
    }

    @Override
    public @Nullable Short getShort(@NotNull String path) {
-        return section().getShort(path);
+        return raw().getShort(path);
    }

    @Override
    public @Nullable Short getShort(@NotNull String path, @Nullable Short def) {
-        return section().getShort(path, def);
+        return raw().getShort(path, def);
    }

    @Override
    public boolean isInt(@NotNull String path) {
-        return section().isInt(path);
+        return raw().isInt(path);
    }

    @Override
    public @Nullable Integer getInt(@NotNull String path) {
-        return section().getInt(path);
+        return raw().getInt(path);
    }

    @Override
    public @Nullable Integer getInt(@NotNull String path, @Nullable Integer def) {
-        return section().getInt(path, def);
+        return raw().getInt(path, def);
    }

    @Override
    public boolean isLong(@NotNull String path) {
-        return section().isLong(path);
+        return raw().isLong(path);
    }

    @Override
    public @Nullable Long getLong(@NotNull String path) {
-        return section().getLong(path);
+        return raw().getLong(path);
    }

    @Override
    public @Nullable Long getLong(@NotNull String path, @Nullable Long def) {
-        return section().getLong(path, def);
+        return raw().getLong(path, def);
    }

    @Override
    public boolean isFloat(@NotNull String path) {
-        return section().isFloat(path);
+        return raw().isFloat(path);
    }

    @Override
    public @Nullable Float getFloat(@NotNull String path) {
-        return section().getFloat(path);
+        return raw().getFloat(path);
    }

    @Override
    public @Nullable Float getFloat(@NotNull String path, @Nullable Float def) {
-        return section().getFloat(path, def);
+        return raw().getFloat(path, def);
    }

    @Override
    public boolean isDouble(@NotNull String path) {
-        return section().isDouble(path);
+        return raw().isDouble(path);
    }

    @Override
    public @Nullable Double getDouble(@NotNull String path) {
-        return section().getDouble(path);
+        return raw().getDouble(path);
    }

    @Override
    public @Nullable Double getDouble(@NotNull String path, @Nullable Double def) {
-        return section().getDouble(path, def);
+        return raw().getDouble(path, def);
    }

    @Override
    public boolean isChar(@NotNull String path) {
-        return section().isChar(path);
+        return raw().isChar(path);
    }

    @Override
    public @Nullable Character getChar(@NotNull String path) {
-        return section().getChar(path);
+        return raw().getChar(path);
    }

    @Override
    public @Nullable Character getChar(@NotNull String path, @Nullable Character def) {
-        return section().getChar(path, def);
+        return raw().getChar(path, def);
    }

    @Override
    public boolean isString(@NotNull String path) {
-        return section().isString(path);
+        return raw().isString(path);
    }

    @Override
    public @Nullable String getString(@NotNull String path) {
-        return section().getString(path);
+        return raw().getString(path);
    }

    @Override
    public @Nullable String getString(@NotNull String path, @Nullable String def) {
-        return section().getString(path, def);
+        return raw().getString(path, def);
    }

    @Override
    public @NotNull <V> List<V> getList(@NotNull String path, @NotNull DataFunction<Object, V> parser) {
-        return section().getList(path, parser);
+        return raw().getList(path, parser);
    }

    @Override
    public @NotNull List<String> getStringList(@NotNull String path) {
-        return section().getStringList(path);
+        return raw().getStringList(path);
    }

    @Override
    public @NotNull List<Integer> getIntegerList(@NotNull String path) {
-        return section().getIntegerList(path);
+        return raw().getIntegerList(path);
    }

    @Override
    public @NotNull List<Long> getLongList(@NotNull String path) {
-        return section().getLongList(path);
+        return raw().getLongList(path);
    }

    @Override
    public @NotNull List<Double> getDoubleList(@NotNull String path) {
-        return section().getDoubleList(path);
+        return raw().getDoubleList(path);
    }

    @Override
    public @NotNull List<Float> getFloatList(@NotNull String path) {
-        return section().getFloatList(path);
+        return raw().getFloatList(path);
    }

    @Override
    public @NotNull List<Byte> getByteList(@NotNull String path) {
-        return section().getByteList(path);
+        return raw().getByteList(path);
    }

    @Override
    public @NotNull List<Character> getCharList(@NotNull String path) {
-        return section().getCharList(path);
+        return raw().getCharList(path);
    }

    @Override
    public <T, C extends Collection<T>> @NotNull C getCollection(@NotNull String path, @NotNull Supplier<C> constructor, @NotNull DataFunction<Object, T> parser) {
-        return section().getCollection(path, constructor, parser);
+        return raw().getCollection(path, constructor, parser);
    }

    @Override
    public @NotNull Stream<?> stream(@NotNull String path) {
-        return section().stream(path);
+        return raw().stream(path);
    }

    @Override
    public @NotNull <T> Stream<T> stream(@NotNull String path, @NotNull Function<Object, T> parser) {
-        return section().stream(path, parser);
+        return raw().stream(path, parser);
    }

    @Override
    public String childPath(String path) {
-        return section().childPath(path);
+        return raw().childPath(path);
    }

    @Override
    public int hashCode() {
-        return section.hashCode();
+        return raw.hashCode();
    }

    @Override
    public boolean equals(Object obj) {
-        return Objects.equals(section, obj);
+        return Objects.equals(raw, obj);
    }

 }
@@ -40,6 +40,12 @@ public class ShadedSection implements ConfigureSection {
        return merge(template, source).getValues(deep);
    }

+    @Override
+    public @NotNull @UnmodifiableView Map<String, Object> asMap() {
+        if (source == null) return template.asMap();
+        return merge(template, source).asMap();
+    }
+
    @Override
    public @NotNull @UnmodifiableView Set<String> getKeys(boolean deep) {
        Set<String> keys = new HashSet<>(template.getKeys(deep));
@@ -5,8 +5,8 @@
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.7</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -16,20 +16,20 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-feature-text</artifactId>
+    <artifactId>configured-feature-text</artifactId>
    <packaging>jar</packaging>

    <dependencies>

        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.version}</version>
        </dependency>

        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-yaml</artifactId>
+            <artifactId>configured-gson</artifactId>
            <version>${project.version}</version>
            <scope>test</scope>
        </dependency>
@@ -16,11 +16,12 @@ import java.util.stream.IntStream;
 public abstract class ContentHandler<RECEIVER, SELF extends ContentHandler<RECEIVER, SELF>> {

    /**
-     * Used to match the message insertion
+     * Used to match the message insertion.
     * <p>
     * format:
     * <br>- to insert parsed line {prefix}#content-id#{offset-above,offset-down}
     * <br>- to insert original line {prefix}@content-id@{offset-above,offset-down}
+     * <br>  original lines will not be parsed
     * <br> example:
     * <ul>
     *     <li>{- }#content-id#{1,1}</li>
@@ -30,6 +31,21 @@ public abstract class ContentHandler<RECEIVER, SELF extends ContentHandler<RECEI
    public static final @NotNull Pattern INSERT_PATTERN = Pattern.compile(
            "^(?:\\{(?<prefix>.*)})?(?<type>[#@])(?<id>.*)[#@](?:\\{(?<above>-?\\d+)(?:,(?<down>-?\\d+))?})?$"
    );
+
+    /**
+     * Used to match the message which can be inserted
+     * <p>
+     * format:
+     * <br>- ?[id]Message content
+     * <br> example:
+     * <ul>
+     *     <li>?[click]Click to use this item!</li>
+     * </ul>
+     */
+    public static final @NotNull Pattern ENABLE_PATTERN = Pattern.compile(
+            "^\\?\\[(?<id>.+)](?<content>.*)$"
+    );
+
    public static final @NotNull UnaryOperator<String> DEFAULT_PARAM_BUILDER = s -> "%(" + s + ")";

    protected BiFunction<RECEIVER, String, String> parser = (receiver, value) -> value;
@@ -45,7 +61,7 @@ public abstract class ContentHandler<RECEIVER, SELF extends ContentHandler<RECEI
    /**
     * Used to store the insertion of the message
     */
-    protected @NotNull Map<String, Function<RECEIVER, List<String>>> insertion = new HashMap<>();
+    protected @NotNull Map<String, @Nullable Function<RECEIVER, List<String>>> insertion = new HashMap<>();
    protected boolean disableInsertion = false;

    public abstract SELF self();
@@ -139,6 +155,17 @@ public abstract class ContentHandler<RECEIVER, SELF extends ContentHandler<RECEI
        return self();
    }

+    /**
+     * Insert the specific contents by the id.
+     *
+     * @param id the id of the insertion text
+     * @return the current {@link ContentHandler} instance
+     */
+    public SELF insert(@NotNull String id) {
+        this.insertion.put(id, null);
+        return self();
+    }
+
    /**
     * Insert the specific contents by the id.
     *
@@ -205,37 +232,50 @@ public abstract class ContentHandler<RECEIVER, SELF extends ContentHandler<RECEI
        }

        for (String line : contents.lines()) {
-            Matcher matcher = INSERT_PATTERN.matcher(line);
-            if (!matcher.matches()) {
-                lineConsumer.accept(parse(receiver, line));
+            Matcher insertMatcher = INSERT_PATTERN.matcher(line);
+            if (insertMatcher.matches()) {
+                doInsert(insertMatcher, receiver, lineConsumer);
                continue;
            }

-            String id = matcher.group("id");
-            List<String> values = Optional.ofNullable(this.insertion.get(id))
-                    .map(f -> f.apply(receiver))
-                    .orElse(null);
-            if (values == null || values.isEmpty()) continue;
-
-            String prefix = matcher.group("prefix");
-            String type = matcher.group("type");
-            boolean original = type.equals("@");
-            int offsetAbove = Optional.ofNullable(matcher.group("above"))
-                    .map(Integer::parseInt).orElse(0);
-            int offsetDown = Optional.ofNullable(matcher.group("down"))
-                    .map(Integer::parseInt).orElse(offsetAbove); // If offsetDown is not set, use offsetAbove
-
-            IntStream.range(0, Math.max(0, offsetAbove)).mapToObj(i -> "").forEach(lineConsumer);
-            String prefixContent = Optional.ofNullable(prefix).map(p -> parse(receiver, p)).orElse("");
-            if (original) {
-                values.stream().map(value -> prefixContent + value).forEach(lineConsumer);
-            } else {
-                values.stream().map(value -> prefixContent + parse(receiver, value)).forEach(lineConsumer);
+            Matcher enableMatcher = ENABLE_PATTERN.matcher(line);
+            if (enableMatcher.matches()) {
+                if (this.insertion.containsKey(enableMatcher.group("id"))) {
+                    lineConsumer.accept(parse(receiver, enableMatcher.group("content")));
+                }
+                continue;
            }
-            IntStream.range(0, Math.max(0, offsetDown)).mapToObj(i -> "").forEach(lineConsumer);
+
+            lineConsumer.accept(parse(receiver, line));
        }
    }

+    private void doInsert(Matcher matcher, @Nullable RECEIVER receiver,
+                          @NotNull Consumer<String> lineConsumer) {
+        String id = matcher.group("id");
+        List<String> values = Optional.ofNullable(this.insertion.get(id))
+                .map(f -> f.apply(receiver))
+                .orElse(null);
+        if (values == null || values.isEmpty()) return; // No values to insert
+
+        String prefix = matcher.group("prefix");
+        String type = matcher.group("type");
+        boolean original = type.equals("@");
+        int offsetAbove = Optional.ofNullable(matcher.group("above"))
+                .map(Integer::parseInt).orElse(0);
+        int offsetDown = Optional.ofNullable(matcher.group("down"))
+                .map(Integer::parseInt).orElse(offsetAbove); // If offsetDown is not set, use offsetAbove
+
+        IntStream.range(0, Math.max(0, offsetAbove)).mapToObj(i -> "").forEach(lineConsumer);
+        String prefixContent = Optional.ofNullable(prefix).map(p -> parse(receiver, p)).orElse("");
+        if (original) {
+            values.stream().map(value -> prefixContent + value).forEach(lineConsumer);
+        } else {
+            values.stream().map(value -> prefixContent + parse(receiver, value)).forEach(lineConsumer);
+        }
+        IntStream.range(0, Math.max(0, offsetDown)).mapToObj(i -> "").forEach(lineConsumer);
+    }
+
    public static String setPlaceholders(@NotNull String messages,
                                         @NotNull Map<String, Object> placeholders) {
        if (messages.isEmpty()) return messages;
@@ -2,10 +2,12 @@ package cc.carm.lib.configuration.value.text.tests;


 import cc.carm.lib.configuration.source.ConfigurationHolder;
-import cc.carm.lib.configuration.source.yaml.YAMLConfigFactory;
+import cc.carm.lib.configuration.source.json.JSONConfigFactory;
 import cc.carm.lib.configuration.value.text.tests.conf.AppMessages;
 import org.junit.Test;

+import java.io.File;
+
 public class ConfigTest {


@@ -19,7 +21,7 @@ public class ConfigTest {
    @Test
    public void test() {

-        ConfigurationHolder<?> holder = YAMLConfigFactory.from("target/messages.yml").build();
+        ConfigurationHolder<?> holder = JSONConfigFactory.from(new File("target/messages.json")).build();

        holder.initialize(AppMessages.class);

@@ -20,7 +20,9 @@ public class ParseTest {
        lines.add("#guidance#");
        lines.add("{- }#websites#{0,1}");
        lines.add("Thanks for your reading!");
-
+        lines.add("?[click]");
+        lines.add("?[click]Click to see more!");
+        lines.add("?[hidden]This entry should be hidden!");

        Map<String, List<String>> optional = new HashMap<>();
        optional.put("guidance", Arrays.asList("To get more information for %(name), see:"));
@@ -35,6 +37,7 @@ public class ParseTest {

        msg.placeholder("name", "Carm")
                .insert("guidance")
+                .insert("click")
                .insert("websites", "Baidu", "Bilibili", "Google");

        System.out.println("----------------------------");
@@ -5,8 +5,8 @@
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.7</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -16,13 +16,13 @@
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>

-    <artifactId>easyconfiguration-feature-versioned</artifactId>
+    <artifactId>configured-feature-versioned</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>${project.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
@@ -1,6 +1,5 @@
 package cc.carm.lib.configuration.annotation;

-import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;

 import java.lang.annotation.ElementType;
@@ -22,7 +21,7 @@ public @interface ConfigVersion {
     *
     * @return the version of the configuration field
     */
-    @Range(from = 0, to = Integer.MAX_VALUE)
+    @Range(from = 0, to = 65535)
    int value() default 0;

 }
@@ -1,13 +0,0 @@
-package cc.carm.lib.configuration.option;
-
-import cc.carm.lib.configuration.source.option.ConfigurationOption;
-
-public interface VersionedOptions {
-
-    /**
-     * Whether to set newer defaults when a {@link cc.carm.lib.configuration.value.ConfigValue}'s marked version
-     * is newer than the current in storage.
-     */
-    ConfigurationOption<Boolean> RESET_NEWER_DEFAULTS = ConfigurationOption.of(true);
-
-}
@@ -1,4 +1,4 @@
-package cc.carm.lib.configuration.commentable;
+package cc.carm.lib.configuration.versioned;

 import cc.carm.lib.configuration.annotation.ConfigVersion;
 import cc.carm.lib.configuration.source.ConfigurationHolder;
@@ -19,7 +19,18 @@ public interface VersionedMetaTypes {
    }

    static void register(@NotNull ConfigurationInitializer initializer) {
-        initializer.registerFieldAnnotation(ConfigVersion.class, VERSION, ConfigVersion::value);
+        initializer.appendFieldInitializer((holder, path, field, value) -> {
+            ConfigVersion annotation = field.getAnnotation(ConfigVersion.class);
+            if (annotation == null || value == null) return;
+            int currentVersion = annotation.value();
+            int savedVersion = holder.metadata(path).get(VERSION, 0);
+            if (currentVersion == savedVersion) return;
+
+            if (currentVersion > savedVersion) { // This values updated.
+                value.setDefault(true); // Mark as default value, force write.
+            }
+            holder.metadata(path).set(VERSION, currentVersion);
+        });
    }

 }
@@ -13,9 +13,9 @@
    </properties>

    <groupId>cc.carm.lib</groupId>
-    <artifactId>easyconfiguration-parent</artifactId>
+    <artifactId>configured-parent</artifactId>
    <packaging>pom</packaging>
-    <version>4.0.7</version>
+    <version>4.1.0</version>
    <modules>
        <module>core</module>
        <module>features/section</module>
@@ -26,16 +26,16 @@

        <module>providers/yaml</module>
        <module>providers/gson</module>
-        <!--        <module>providers/hocon</module>-->
-        <!--        <module>providers/sql</module>-->
-        <!--        <module>providers/mongodb</module>-->
+        <module>providers/hocon</module>
+        <module>providers/sql</module>
+        <module>providers/mongodb</module>

        <module>demo</module>
    </modules>

-    <name>EasyConfiguration</name>
+    <name>configured</name>
    <description>A simple, easy-to-use and universal solution for managing configuration files.</description>
-    <url>https://github.com/CarmJos/EasyConfiguration</url>
+    <url>https://github.com/CarmJos/configured</url>

    <developers>
        <developer>
@@ -48,9 +48,9 @@
    </developers>

    <scm>
-        <connection>scm:git:git@github.com:CarmJos/Easy.EasyConfiguration</connection>
-        <developerConnection>scm:git:git@github.com:CarmJos/EasyConfiguration.git</developerConnection>
-        <url>https://github.com/CarmJos/EasyConfiguration</url>
+        <connection>scm:git:git@github.com:CarmJos/Easy.configured</connection>
+        <developerConnection>scm:git:git@github.com:CarmJos/configured.git</developerConnection>
+        <url>https://github.com/CarmJos/configured</url>
        <tag>HEAD</tag>
    </scm>

@@ -63,12 +63,12 @@

    <issueManagement>
        <system>GitHub Issues</system>
-        <url>https://github.com/CarmJos/EasyConfiguration/issues</url>
+        <url>https://github.com/CarmJos/configured/issues</url>
    </issueManagement>

    <ciManagement>
        <system>GitHub Actions</system>
-        <url>https://github.com/CarmJos/EasyConfiguration/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/configured/actions/workflows/maven.yml</url>
    </ciManagement>

    <repositories>
@@ -92,11 +92,11 @@
    </repositories>

    <distributionManagement>
-        <downloadUrl>https://github.com/CarmJos/EasyConfiguration/releases</downloadUrl>
+        <downloadUrl>https://github.com/CarmJos/configured/releases</downloadUrl>
        <site>
            <id>javadoc</id>
-            <name>EasyConfiguration JavaDoc (on GitHub Pages)</name>
-            <url>https://CarmJos.github.io/EasyConfiguration</url>
+            <name>configured JavaDoc (on GitHub Pages)</name>
+            <url>https://CarmJos.github.io/configured</url>
        </site>
    </distributionManagement>

@@ -292,7 +292,7 @@
                <repository>
                    <id>github</id>
                    <name>GitHub Packages</name>
-                    <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+                    <url>https://maven.pkg.github.com/CarmJos/configured</url>
                </repository>
            </distributionManagement>
        </profile>
@@ -1,4 +1,4 @@
-# EasyConfiguration-JSON
+# configured-JSON

 JSON file-based implementation, compatible with all Java environments.

@@ -22,9 +22,9 @@ JSON file-based implementation, compatible with all Java environments.

        <repository>
            <!-- Using GitHub dependencies for real-time updates, configuration required (recommended). -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

    </repositories>
@@ -37,7 +37,7 @@ JSON file-based implementation, compatible with all Java environments.
    <dependencies>
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-json</artifactId>
+            <artifactId>configured-json</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -54,14 +54,14 @@ repositories {
    mavenCentral()

    // Using GitHub dependencies for real-time updates, configuration required (recommended).
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

 }
 ```

 ```groovy
 dependencies {
-    api "cc.carm.lib:easyconfiguration-json:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-json:[LATEST RELEASE]"
 }
 ```

@@ -3,9 +3,9 @@
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.7</version>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -15,35 +15,35 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>
-    <artifactId>easyconfiguration-gson</artifactId>
+    <artifactId>configured-gson</artifactId>
    <packaging>jar</packaging>

    <dependencies>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-file</artifactId>
+            <artifactId>configured-feature-file</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-section</artifactId>
+            <artifactId>configured-feature-section</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-demo</artifactId>
+            <artifactId>configured-demo</artifactId>
            <version>${project.parent.version}</version>
            <scope>test</scope>
        </dependency>
@@ -1,4 +1,4 @@
-# EasyConfiguration-HOCON
+# configured-HOCON

 HOCON file-based implementation, compatible with all Java environments.

@@ -20,9 +20,9 @@ HOCON file-based implementation, compatible with all Java environments.

        <repository>
            <!-- Using GitHub dependencies for real-time updates, configuration required (recommended). -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

    </repositories>
@@ -35,7 +35,7 @@ HOCON file-based implementation, compatible with all Java environments.
    <dependencies>
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-hocon</artifactId>
+            <artifactId>configured-hocon</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -52,14 +52,14 @@ repositories {
    mavenCentral()

    // Using GitHub dependencies for real-time updates, configuration required (recommended).
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

 }
 ```

 ```groovy
 dependencies {
-    api "cc.carm.lib:easyconfiguration-hocon:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-hocon:[LATEST RELEASE]"
 }
 ```

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>cc.carm.lib</groupId>
-        <artifactId>easyconfiguration-parent</artifactId>
-        <version>4.0.0</version>
+        <artifactId>configured-parent</artifactId>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -15,38 +15,38 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>
-    <artifactId>easyconfiguration-hocon</artifactId>
+    <artifactId>configured-hocon</artifactId>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-commentable</artifactId>
+            <artifactId>configured-feature-commentable</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-file</artifactId>
+            <artifactId>configured-feature-file</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-section</artifactId>
+            <artifactId>configured-feature-section</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-demo</artifactId>
+            <artifactId>configured-demo</artifactId>
            <version>${project.parent.version}</version>
            <scope>test</scope>
        </dependency>
@@ -1,36 +0,0 @@
-package cc.carm.lib.configuration;
-
-import cc.carm.lib.configuration.hocon.HOCONFileConfigProvider;
-
-import java.io.File;
-import java.io.IOException;
-
-public class EasyConfiguration {
-
-    private EasyConfiguration() {
-    }
-
-    public static HOCONFileConfigProvider from(File file, String source) {
-        HOCONFileConfigProvider provider = new HOCONFileConfigProvider(file);
-        try {
-            provider.initializeFile(source);
-            provider.initializeConfig();
-        } catch (IOException e) {
-            e.printStackTrace();
-        }
-        return provider;
-    }
-
-    public static HOCONFileConfigProvider from(File file) {
-        return from(file, file.getName());
-    }
-
-    public static HOCONFileConfigProvider from(String fileName) {
-        return from(fileName, fileName);
-    }
-
-    public static HOCONFileConfigProvider from(String fileName, String source) {
-        return from(new File(fileName), source);
-    }
-
-}
@@ -1,116 +0,0 @@
-package cc.carm.lib.configuration.hocon;
-
-import cc.carm.lib.configuration.hocon.util.HOCONUtils;
-import com.typesafe.config.*;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.*;
-
-public class HOCONConfigWrapper implements ConfigurationWrapper<Map<String, Object>> {
-    private static final char SEPARATOR = '.';
-    protected final Map<String, Object> data;
-
-    public HOCONConfigWrapper(ConfigObject config) {
-        this.data = new LinkedHashMap<>();
-
-        config.forEach((key, value) -> {
-            Config cfg = config.toConfig();
-            ConfigValue cv = cfg.getValue(key);
-            if (cv.valueType() == ConfigValueType.OBJECT) {
-                HOCONConfigWrapper.this.data.put(key, new HOCONConfigWrapper((ConfigObject) cv));
-            } else {
-                HOCONConfigWrapper.this.data.put(key, value.unwrapped());
-            }
-        });
-    }
-
-    @Override
-    public @NotNull Map<String, Object> getSource() {
-        return this.data;
-    }
-
-    @Override
-    public @NotNull Set<String> getKeys(boolean deep) {
-        return this.getValues(deep).keySet();
-    }
-
-    @Override
-    public @NotNull Map<String, Object> getValues(boolean deep) {
-        return HOCONUtils.getKeysFromObject(this, deep, "").stream().collect(
-                LinkedHashMap::new,
-                (map, key) -> map.put(key, get(key)),
-                LinkedHashMap::putAll
-        );
-    }
-
-    @Override
-    public void set(@NotNull String path, @Nullable Object value) {
-        if (value instanceof Map) {
-            //noinspection unchecked
-            value = new HOCONConfigWrapper(ConfigFactory.parseMap((Map<String, ?>) value).root());
-        }
-
-        HOCONConfigWrapper section = HOCONUtils.getObjectOn(this, path, SEPARATOR);
-        String simplePath = HOCONUtils.getSimplePath(path, SEPARATOR);
-
-        if (value == null) {
-            section.data.remove(simplePath);
-        } else {
-            section.setDirect(simplePath, value);
-        }
-    }
-
-    /**
-     * 只能设置当前路径下的内容
-     * 避免环回
-     *
-     * @param path 路径
-     */
-    public void setDirect(@NotNull String path, @Nullable Object value) {
-        this.data.put(path, value);
-    }
-
-    @Override
-    public boolean contains(@NotNull String path) {
-        return this.get(path) != null;
-    }
-
-    @Override
-    public @Nullable Object get(@NotNull String path) {
-        HOCONConfigWrapper section = HOCONUtils.getObjectOn(this, path, SEPARATOR);
-        return section.getDirect(HOCONUtils.getSimplePath(path, SEPARATOR));
-    }
-
-    /**
-     * 只能获取当前路径下的内容
-     * 避免环回
-     *
-     * @param path 路径
-     */
-    public Object getDirect(@NotNull String path) {
-        return this.data.get(path);
-    }
-
-    @Override
-    public boolean isList(@NotNull String path) {
-        return this.get(path) instanceof List<?>;
-    }
-
-    @Override
-    public @Nullable List<?> getList(@NotNull String path) {
-        Object val = this.get(path);
-        return (val instanceof List<?>) ? (List<?>) val : null;
-    }
-
-    @Override
-    public boolean isConfigurationSection(@NotNull String path) {
-        return this.get(path) instanceof HOCONConfigWrapper;
-    }
-
-    @Override
-    public @Nullable ConfigurationWrapper<Map<String, Object>> getConfigurationSection(@NotNull String path) {
-        Object val = get(path);
-        return (val instanceof HOCONConfigWrapper) ? (HOCONConfigWrapper) val : null;
-    }
-}
@@ -1,105 +0,0 @@
-package cc.carm.lib.configuration.hocon;
-
-import cc.carm.lib.configuration.source.comment.ConfigurationComments;
-import cc.carm.lib.configuration.core.source.impl.FileConfigProvider;
-import cc.carm.lib.configuration.hocon.exception.HOCONGetValueException;
-import cc.carm.lib.configuration.hocon.util.HOCONUtils;
-import com.typesafe.config.*;
-import org.jetbrains.annotations.Contract;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.io.File;
-import java.io.IOException;
-import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
-import java.util.List;
-import java.util.Set;
-
-public class HOCONFileConfigProvider extends FileConfigProvider<HOCONConfigWrapper> {
-    protected final @NotNull ConfigurationComments comments = new ConfigurationComments();
-    protected HOCONConfigWrapper configuration;
-    protected ConfigInitializer<HOCONFileConfigProvider> initializer;
-
-    public HOCONFileConfigProvider(@NotNull File file) {
-        super(file);
-        this.initializer = new ConfigInitializer<>(this);
-    }
-
-    public void initializeConfig() {
-        try {
-            this.configuration = new HOCONConfigWrapper(ConfigFactory.parseFile(this.file, ConfigParseOptions.defaults()
-                    .setSyntax(ConfigSyntax.CONF)
-                    .setAllowMissing(false)).root());
-        } catch (ConfigException e) {
-            e.printStackTrace();
-        }
-    }
-
-    @Override
-    public @NotNull HOCONConfigWrapper getConfiguration() {
-        return this.configuration;
-    }
-
-    @Override
-    public void save() throws IOException {
-        Files.write(this.file.toPath(), HOCONUtils.renderWithComment(configuration, comments::getHeaderComment).getBytes(StandardCharsets.UTF_8));
-    }
-
-    @Override
-    protected void onReload() throws ConfigException {
-        ConfigObject conf = ConfigFactory.parseFile(this.file, ConfigParseOptions.defaults()
-                .setSyntax(ConfigSyntax.CONF)
-                .setAllowMissing(false)).root();
-        this.configuration = new HOCONConfigWrapper(conf);
-    }
-
-    @Override
-    public @NotNull ConfigurationComments getComments() {
-        return this.comments;
-    }
-
-    @Override
-    public @NotNull ConfigInitializer<HOCONFileConfigProvider> getInitializer() {
-        return this.initializer;
-    }
-
-    public String serializeValue(@NotNull String key, @NotNull Object value) {
-        // 带有 key=value 的新空对象
-        return ConfigFactory.empty()
-                .withValue(key, ConfigValueFactory.fromAnyRef(value))
-                .root().render();
-    }
-
-    public @NotNull Set<String> getKeys() {
-        return getKeys(null, true);
-    }
-
-    @Contract("null,_->!null")
-    public @Nullable Set<String> getKeys(@Nullable String sectionKey, boolean deep) {
-        if (sectionKey == null) { // 当前路径
-            return HOCONUtils.getKeysFromObject(this.configuration, deep, "");
-        }
-
-        HOCONConfigWrapper section;
-        try {
-            // 获取目标字段所在路径
-            section = (HOCONConfigWrapper) this.configuration.get(sectionKey);
-        } catch (ClassCastException e) {
-            // 值和类型不匹配
-            throw new HOCONGetValueException(e);
-        }
-        if (section == null) {
-            return null;
-        }
-        return HOCONUtils.getKeysFromObject(section, deep, "");
-    }
-
-    public @Nullable Object getValue(@NotNull String key) {
-        return this.configuration.get(key);
-    }
-
-    public @Nullable List<String> getHeaderComments(@Nullable String key) {
-        return this.comments.getHeaderComment(key);
-    }
-}
@@ -1,19 +0,0 @@
-package cc.carm.lib.configuration.hocon.exception;
-
-public class HOCONGetValueException extends RuntimeException {
-    public HOCONGetValueException() {
-        super();
-    }
-
-    public HOCONGetValueException(String message) {
-        super(message);
-    }
-
-    public HOCONGetValueException(String message, Throwable cause) {
-        super(message, cause);
-    }
-
-    public HOCONGetValueException(Throwable cause) {
-        super(cause);
-    }
-}
@@ -1,110 +0,0 @@
-package cc.carm.lib.configuration.hocon.util;
-
-import cc.carm.lib.configuration.hocon.HOCONConfigWrapper;
-import cc.carm.lib.configuration.hocon.exception.HOCONGetValueException;
-import com.typesafe.config.*;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.LinkedHashSet;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-import java.util.function.Function;
-
-public class HOCONUtils {
-
-    private HOCONUtils() {
-    }
-
-    public static String getSimplePath(String path, char separator) {
-        int index = path.lastIndexOf(separator);
-        return (index == -1) ? path : path.substring(index + 1);
-    }
-
-    public static HOCONConfigWrapper getObjectOn(@NotNull HOCONConfigWrapper parent, @NotNull String path, char separator) {
-        String currentPath = path;
-        HOCONConfigWrapper currentObject = parent;
-        int index;
-        while ((index = currentPath.indexOf(separator)) != -1) {
-            HOCONConfigWrapper previousObject = currentObject;
-            String pathName = currentPath.substring(0, index);
-            try {
-                currentObject = (HOCONConfigWrapper) previousObject.getDirect(pathName);
-            } catch (ClassCastException e) {
-                throw new HOCONGetValueException(e);
-            }
-            if (currentObject == null) {
-                currentObject = new HOCONConfigWrapper(ConfigFactory.empty().root());
-                previousObject.setDirect(pathName, currentObject);
-            }
-            currentPath = currentPath.substring(index + 1);
-        }
-
-        return currentObject;
-    }
-
-    /**
-     * 在 Object 中获取所有键
-     * 思路：在第一次执行时 prefix 应该是 ""
-     * 后续找到了更深层的键，将会变为 "deep."
-     * 下一次键名就是 "deep.key"
-     *
-     * @param parent Object
-     * @param deep   是否更深层获取
-     * @param prefix 当前 Object 键名前缀
-     * @return Object 中的所有键
-     */
-    public static Set<String> getKeysFromObject(HOCONConfigWrapper parent, boolean deep, String prefix) {
-        return parent.getSource().entrySet().stream().collect(
-                LinkedHashSet::new,
-                (set, entry) -> {
-                    Object value = entry.getValue();
-                    if (value instanceof HOCONConfigWrapper && deep) {
-                        set.addAll(HOCONUtils.getKeysFromObject((HOCONConfigWrapper) value, true, prefix + entry.getKey() + "."));
-                    } else {
-                        set.add(prefix + entry.getKey());
-                    }
-                },
-                LinkedHashSet::addAll
-        );
-    }
-
-    /**
-     * 将 Object 保存为字符串
-     * 并使用注释器打上注释
-     *
-     * @param object    Object
-     * @param commenter 注释器
-     * @return 保存的字符串
-     */
-    public static @NotNull String renderWithComment(@NotNull HOCONConfigWrapper object, @NotNull Function<String, List<String>> commenter) {
-        return HOCONUtils.makeConfigWithComment(object, "", commenter).root().render(
-                ConfigRenderOptions.defaults()
-                        .setJson(false)
-                        .setOriginComments(false)
-        );
-    }
-
-    public static @NotNull Config makeConfigWithComment(@NotNull HOCONConfigWrapper object, @NotNull String prefix, @NotNull Function<String, List<String>> commenter) {
-        Config config = ConfigFactory.empty();
-        for (Map.Entry<String, Object> entry : object.getSource().entrySet()) {
-            String key = entry.getKey();
-            String fullKey = prefix + key;
-            Object value = entry.getValue();
-            ConfigValue result;
-            if (value instanceof Iterable) {
-                result = ConfigValueFactory.fromIterable((Iterable<?>) value);
-            } else if (value instanceof HOCONConfigWrapper) {
-                result = makeConfigWithComment((HOCONConfigWrapper) value, fullKey + ".", commenter).root();
-            } else {
-                result = ConfigValueFactory.fromAnyRef(value);
-            }
-            result = result.withOrigin(
-                    ConfigOriginFactory.newSimple()
-                            .withComments(commenter.apply(fullKey))
-            );
-            config = config.withValue(key, result);
-        }
-        return config;
-    }
-}
@@ -0,0 +1,48 @@
+package cc.carm.lib.configuration.source.hocon;
+
+import cc.carm.lib.configuration.commentable.Commentable;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.source.file.FileConfigFactory;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+
+public class HOCONConfigFactory extends FileConfigFactory<HOCONSource, ConfigurationHolder<HOCONSource>, HOCONConfigFactory> {
+    public static HOCONConfigFactory from(@NotNull String path) {
+        return new HOCONConfigFactory(new File(path));
+    }
+
+    public static HOCONConfigFactory from(@NotNull File file) {
+        return new HOCONConfigFactory(file);
+    }
+
+    public static HOCONConfigFactory from(@NotNull File parent, @NotNull String configName) {
+        return new HOCONConfigFactory(new File(parent, configName));
+    }
+
+    public HOCONConfigFactory(@NotNull File file) {
+        super(file);
+    }
+
+    @Override
+    protected HOCONConfigFactory self() {
+        return this;
+    }
+
+    @Override
+    public @NotNull ConfigurationHolder<HOCONSource> build() {
+        File configFile = this.file;
+        String sourcePath = this.resourcePath;
+
+        Commentable.registerMeta(this.initializer); // Register commentable meta types
+
+        return new ConfigurationHolder<HOCONSource>(this.adapters, this.options, this.metadata, this.initializer) {
+            final @NotNull HOCONSource source = new HOCONSource(this, configFile, sourcePath);
+
+            @Override
+            public @NotNull HOCONSource config() {
+                return this.source;
+            }
+        };
+    }
+}
@@ -1,69 +0,0 @@
-package cc.carm.lib.configuration.source.hocon;
-
-import cc.carm.lib.configuration.source.section.ConfigureSection;
-import com.typesafe.config.Config;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.UnmodifiableView;
-
-import java.util.List;
-import java.util.Map;
-
-public class HOCONSection implements ConfigureSection {
-
-    protected final @NotNull HOCONSource source;
-    protected final @Nullable HOCONSection parent;
-    protected final @NotNull Config data;
-
-    public HOCONSection(@NotNull HOCONSource source, @Nullable HOCONSection parent,
-                        @NotNull Config data) {
-        this.source = source;
-        this.parent = parent;
-        this.data = data;
-    }
-
-    public @NotNull Config data() {
-        return this.data;
-    }
-
-    @Override
-    public @NotNull HOCONSource source() {
-        return this.source;
-    }
-
-    @Override
-    public @Nullable HOCONSection parent() {
-        return this.parent;
-    }
-
-    @Override
-    public @NotNull @UnmodifiableView Map<String, Object> getValues(boolean deep) {
-        return data().root().unwrapped();
-    }
-
-    @Override
-    public void set(@NotNull String path, @Nullable Object value) {
-
-    }
-
-    @Override
-    public boolean contains(@NotNull String path) {
-        return data().hasPath(path);
-    }
-
-    @Override
-    public @Nullable List<?> getList(@NotNull String path) {
-        return data().getAnyRefList(path);
-    }
-
-    @Override
-    public @Nullable HOCONSection getSection(@NotNull String path) {
-        return data().getConfig(path) == null ? null : new HOCONSection(source, this, data().getConfig(path));
-    }
-
-    @Override
-    public @Nullable Object get(@NotNull String path) {
-        return data().getAnyRef(path);
-    }
-
-}
@@ -1,44 +1,104 @@
 package cc.carm.lib.configuration.source.hocon;

+import cc.carm.lib.configuration.commentable.Commentable;
 import cc.carm.lib.configuration.source.ConfigurationHolder;
-import cc.carm.lib.configuration.source.section.ConfigureSource;
-import com.typesafe.config.Config;
+import cc.carm.lib.configuration.source.file.FileConfigSource;
+import cc.carm.lib.configuration.source.section.SourcedSection;
+import com.typesafe.config.*;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;

-import java.util.Objects;
+import java.io.File;
+import java.util.*;

-public class HOCONSource extends ConfigureSource<HOCONSection, Config, HOCONSource> {
+public class HOCONSource
+        extends FileConfigSource<SourcedSection, Map<String, Object>, HOCONSource> {
+    protected @Nullable SourcedSection rootSection;

+    protected HOCONSource(
+            @NotNull ConfigurationHolder<? extends HOCONSource> holder,
+            @NotNull File file, @Nullable String resourcePath
+    ) {
+        super(holder, 0, file, resourcePath);

-    private HOCONSection rootSection;
+        this.initialize();
+    }

-    protected HOCONSource(@NotNull ConfigurationHolder<? extends HOCONSource> holder, long lastUpdateMillis) {
-        super(holder, lastUpdateMillis);
+    public void initialize() {
+        try {
+            this.initializeFile();
+            this.onReload();
+        } catch (Exception e) {
+            //noinspection CallToPrintStackTrace
+            e.printStackTrace();
+        }
    }

    @Override
-    protected HOCONSource self() {
+    protected @NotNull HOCONSource self() {
        return this;
    }

    @Override
-    public @NotNull Config original() {
-        return section().data();
+    public @NotNull Map<String, Object> original() {
+        return this.section().data();
    }

    @Override
-    public @NotNull HOCONSection section() {
-        return Objects.requireNonNull(rootSection, "RootSection is not initialized");
+    public @NotNull SourcedSection section() {
+        return Objects.requireNonNull(this.rootSection, "Root section is not initialized.");
+    }
+
+    public @NotNull String saveToString() {
+        // identity: 创建新的空 typesafe config
+        // accumulator: 将 Section 中的信息为 typesafe config 添加并返回
+        // combiner: 合并两个配置文件
+        Config config = this.getValues(true).entrySet().stream().reduce(
+                ConfigFactory.empty(),
+                (cfg, entry) -> {
+                    String key = entry.getKey(); // 源数据 key
+                    Object value = entry.getValue(); // 源数据 value
+
+                    ConfigValue result; // 最终转换为 typesafe 的 ConfigValue 类型
+                    if (value == null || value instanceof Boolean || value instanceof String || value instanceof Number) {
+                        result = ConfigValueFactory.fromAnyRef(value); // 原始数据类型
+                    } else if (value instanceof Iterator) {
+                        result = ConfigValueFactory.fromIterable((Iterable<?>) value);
+                    } else if (value instanceof Map) {
+                        //noinspection unchecked
+                        result = ConfigValueFactory.fromMap((Map<String, ?>) value);
+                    } else {
+                        result = ConfigValueFactory.fromAnyRef(String.valueOf(value));
+                    }
+                    List<String> headerComments = HOCONSource.this.getHeaderComments(key); // 获取其注释
+                    result = result.withOrigin(result.origin().withComments(headerComments)); // 赋予其注释
+                    return cfg.withValue(key, result); // 将其添加到根 config 中
+                },
+                Config::withFallback
+        );
+        return config.root().render(
+                ConfigRenderOptions.defaults()
+                        .setJson(false)
+                        .setOriginComments(false)
+        );
    }

    @Override
    public void save() throws Exception {
-
+        this.fileWriter(w -> w.write(HOCONSource.this.saveToString()));
    }

    @Override
    protected void onReload() throws Exception {
-
+        this.rootSection = this.fileReadString(this::loadFromString);
    }

+    protected @NotNull SourcedSection loadFromString(@NotNull String data) {
+        ConfigObject config = ConfigFactory.parseString(data).root();
+        return SourcedSection.root(this, config.unwrapped());
+    }
+
+    public @Nullable List<String> getHeaderComments(@Nullable String key) {
+        return Commentable.getHeaderComments(holder(), key);
+    }
 }
@@ -1,18 +0,0 @@
-package online.flowerinsnow.test.easyconfiguration;
-
-public class HOCONTest {
-//    @Test
-//    public void onTest() {
-//        HOCONFileConfigProvider provider = EasyConfiguration.from(new File("target/hocon.conf"));
-//
-//        ConfigurationTest.testDemo(provider);
-//        ConfigurationTest.testInner(provider);
-//
-//        try {
-//            provider.save();
-//            provider.reload();
-//        } catch (Exception e) {
-//            e.printStackTrace();
-//        }
-//    }
-}
@@ -0,0 +1,38 @@
+package sample;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.configuration.value.standard.ConfiguredList;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+
+import java.util.UUID;
+
+@ConfigPath(root = true)
+@HeaderComments("Configurations for sample")
+public interface SampleConfig extends Configuration {
+    ConfiguredValue<Boolean> ENABLED = ConfiguredValue.of(true);
+
+    @HeaderComments("Server configurations") // Header comment
+    ConfiguredValue<Integer> PORT = ConfiguredValue.of(Integer.class);
+
+    @HeaderComments({"[ UUID >-----------------------------------", "A lot of UUIDs"})
+    ConfiguredList<UUID> UUIDS = ConfiguredList.builderOf(UUID.class).fromString()
+            .parse(UUID::fromString).serialize(UUID::toString)
+            .defaults(
+                    UUID.fromString("00000000-0000-0000-0000-000000000000"),
+                    UUID.fromString("00000000-0000-0000-0000-000000000001")
+            ).build();
+
+    @ConfigPath("info") // Custom path
+    interface INFO extends Configuration {
+
+        @HeaderComments("Configure your name!") // Header comment
+        ConfiguredValue<String> NAME = ConfiguredValue.of("Joker");
+
+        @ConfigPath("how-old-are-you") // Custom path
+        ConfiguredValue<Integer> AGE = ConfiguredValue.of(24);
+
+    }
+
+}
@@ -0,0 +1,27 @@
+package sample;
+
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.source.hocon.HOCONConfigFactory;
+import org.junit.Test;
+
+public class  SampleTest {
+
+    @Test
+    public void test() {
+        // 1. Make a configuration provider from a file.
+        ConfigurationHolder<?> holder = HOCONConfigFactory.from("target/config.conf")
+                .resourcePath("configs/sample.conf")
+                .build();
+
+        // 2. Initialize the configuration classes or instances.
+        holder.initialize(SampleConfig.class);
+        // 3. Enjoy using the configuration!
+        System.out.println("Enabled? -> " + SampleConfig.ENABLED.resolve());
+        SampleConfig.ENABLED.set(false);
+        System.out.println("And now? -> " + SampleConfig.ENABLED.resolve());
+        // p.s. Changes not save so enable value will still be true in the next run.
+
+        System.out.println("Your name is " + SampleConfig.INFO.NAME.resolve() + " (age=" + SampleConfig.INFO.AGE.resolve() + ")!");
+    }
+
+}
@@ -0,0 +1,2 @@
+version = 1.0
+test-save = false
@@ -3,9 +3,9 @@
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.0</version>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -15,22 +15,23 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>

+        <deps.mongodb.version>5.3.1</deps.mongodb.version>
        <log4j.version>2.24.3</log4j.version>
    </properties>
-    <artifactId>easyconfiguration-mongodb</artifactId>
+    <artifactId>configured-mongodb</artifactId>

    <dependencies>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-gson</artifactId>
+            <artifactId>configured-feature-section</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
@@ -38,14 +39,7 @@
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-sync</artifactId>
-            <version>5.3.1</version>
-        </dependency>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-demo</artifactId>
-            <version>${project.parent.version}</version>
-            <scope>test</scope>
+            <version>${deps.mongodb.version}</version>
        </dependency>

        <dependency>
@@ -69,6 +63,20 @@
            <scope>test</scope>
        </dependency>

+        <dependency>
+            <groupId>${project.parent.groupId}</groupId>
+            <artifactId>configured-demo</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>${project.parent.groupId}</groupId>
+            <artifactId>configured-gson</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>test</scope>
+        </dependency>
+
    </dependencies>

    <build>
@@ -0,0 +1,75 @@
+package cc.carm.lib.configuration.source.mongodb;
+
+import cc.carm.lib.configuration.source.ConfigurationFactory;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.MongoDatabase;
+import org.bson.Document;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.function.Supplier;
+
+public class MongoConfigFactory extends ConfigurationFactory<MongoSource, ConfigurationHolder<MongoSource>, MongoConfigFactory> {
+
+    public static MongoConfigFactory from(@NotNull Supplier<MongoCollection<Document>> collectionSupplier) {
+        return new MongoConfigFactory(collectionSupplier);
+    }
+
+    public static MongoConfigFactory from(@NotNull MongoCollection<Document> collection) {
+        return from(() -> collection);
+    }
+
+    public static MongoConfigFactory from(@NotNull MongoDatabase database, @NotNull String collectionName) {
+        return from(() -> database.getCollection(collectionName));
+    }
+
+    protected @NotNull Supplier<MongoCollection<Document>> collectionSupplier;
+    protected @NotNull String namespace = "config";
+
+    public MongoConfigFactory(@NotNull Supplier<MongoCollection<Document>> collectionSupplier) {
+        super();
+        this.collectionSupplier = collectionSupplier;
+    }
+
+    public MongoConfigFactory collection(@NotNull Supplier<MongoCollection<Document>> collectionSupplier) {
+        this.collectionSupplier = collectionSupplier;
+        return this;
+    }
+
+    public MongoConfigFactory collection(@NotNull MongoCollection<Document> collection) {
+        return collection(() -> collection);
+    }
+
+    public MongoConfigFactory namespace(@NotNull String namespace) {
+        this.namespace = namespace;
+        return this;
+    }
+
+    public MongoConfigFactory namespace(@NotNull Supplier<String> namespace) {
+        return namespace(namespace.get());
+    }
+
+
+    @Override
+    protected MongoConfigFactory self() {
+        return this;
+    }
+
+    @Override
+    public @NotNull ConfigurationHolder<MongoSource> build() {
+        MongoCollection<Document> collection = this.collectionSupplier.get();
+        if (collection == null) {
+            throw new IllegalStateException("Failed to get MongoCollection<Document> from supplier");
+        }
+
+        return new ConfigurationHolder<MongoSource>(this.adapters, this.options, this.metadata, this.initializer) {
+            final @NotNull MongoSource source = new MongoSource(this, System.currentTimeMillis(), collection, namespace);
+
+            @Override
+            public @NotNull MongoSource config() {
+                return this.source;
+            }
+        };
+    }
+
+}
@@ -1,4 +1,76 @@
 package cc.carm.lib.configuration.source.mongodb;

-public class MongoSource {
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.source.section.ConfigureSource;
+import cc.carm.lib.configuration.source.section.SourcedSection;
+import com.mongodb.client.MongoCollection;
+import com.mongodb.client.model.ReplaceOptions;
+import org.bson.Document;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Map;
+import java.util.Objects;
+
+public class MongoSource extends ConfigureSource<SourcedSection, Map<String, Object>, MongoSource> {
+
+    protected final @NotNull MongoCollection<Document> collection;
+    protected final @NotNull String namespace;
+
+    protected SourcedSection rootSection;
+
+    protected MongoSource(@NotNull ConfigurationHolder<? extends MongoSource> holder, long lastUpdateMillis,
+                          @NotNull MongoCollection<Document> collection, @NotNull String namespace) {
+        super(holder, lastUpdateMillis);
+        this.collection = collection;
+        this.namespace = namespace;
+        try {
+            onReload();
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+
+    @Override
+    protected @NotNull MongoSource self() {
+        return this;
+    }
+
+    @Override
+    public @NotNull Map<String, Object> original() {
+        return section().data();
+    }
+
+    @Override
+    public @NotNull SourcedSection section() {
+        return Objects.requireNonNull(rootSection, "RootSection is not initialized");
+    }
+
+    public @NotNull String namespace() {
+        return this.namespace;
+    }
+
+    public @NotNull MongoCollection<Document> collection() {
+        return this.collection;
+    }
+
+    @Override
+    public void save() throws Exception {
+        Map<String, Object> data = this.rootSection.asMap();
+        if (data.isEmpty()) return; // Skip saving if empty
+        if (data.containsKey("_id") && data.size() == 1) return; // Skip saving if only contains _id
+
+        ReplaceOptions options = new ReplaceOptions().upsert(true);
+        Document storage = new Document(data).append("_id", this.namespace);
+        this.collection.replaceOne(new Document("_id", this.namespace), storage, options);
+    }
+
+    @Override
+    protected void onReload() throws Exception {
+        Document storage = this.collection.find(new Document("_id", this.namespace)).first();
+        if (storage == null) storage = new Document();
+        else storage.remove("_id"); // Remove _id
+        this.rootSection = SourcedSection.root(this, storage);
+    }
+
+
 }
@@ -0,0 +1,12 @@
+package config;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+
+interface MongoConfig extends Configuration {
+    ConfiguredValue<String> HOST = ConfiguredValue.of("127.0.0.1");
+    ConfiguredValue<Integer> PORT = ConfiguredValue.of(27017);
+    ConfiguredValue<String> USERNAME = ConfiguredValue.of("minecraft");
+    ConfiguredValue<String> PASSWORD = ConfiguredValue.of("minecraft");
+    ConfiguredValue<String> DATABASE = ConfiguredValue.of("minecraft");
+}
@@ -0,0 +1,57 @@
+package config;
+
+import cc.carm.lib.configuration.demo.tests.ConfigurationTest;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.source.json.JSONConfigFactory;
+import cc.carm.lib.configuration.source.mongodb.MongoConfigFactory;
+import com.mongodb.ConnectionString;
+import com.mongodb.MongoClientSettings;
+import com.mongodb.MongoCredential;
+import com.mongodb.client.MongoClient;
+import com.mongodb.client.MongoClients;
+import com.mongodb.client.MongoDatabase;
+import org.bson.UuidRepresentation;
+import org.junit.Test;
+
+import java.io.File;
+
+public class MongoTest {
+
+    boolean local = false;
+
+    @Test
+    public void test() {
+
+        if (!local) return;
+
+        ConfigurationHolder<?> gsonHolder = JSONConfigFactory.from(new File("target/mongo.json")).build();
+        gsonHolder.initialize(MongoConfig.class);
+
+        MongoClientSettings settings = MongoClientSettings.builder()
+                .applyConnectionString(new ConnectionString(
+                        "mongodb://" + MongoConfig.HOST.resolve() + ":" + MongoConfig.PORT.resolve()
+                ))
+                .credential(MongoCredential.createCredential(
+                        MongoConfig.USERNAME.resolve(), MongoConfig.DATABASE.resolve(),
+                        MongoConfig.PASSWORD.resolve().toCharArray()
+                ))
+                .uuidRepresentation(UuidRepresentation.STANDARD)
+                .build();
+        MongoClient mongoClient = MongoClients.create(settings);
+        MongoDatabase mongoDatabase = mongoClient.getDatabase(MongoConfig.DATABASE.resolve());
+
+        ConfigurationHolder<?> mongoHolder = MongoConfigFactory
+                .from(mongoDatabase, "configs")
+                .namespace("my_plugin")
+                .build();
+
+        // Test the configuration
+        ConfigurationTest.testDemo(mongoHolder);
+        ConfigurationTest.testInner(mongoHolder);
+
+        ConfigurationTest.save(mongoHolder);
+
+    }
+
+
+}
@@ -1,4 +1,4 @@
-# EasyConfiguration-SQL
+# configured-SQL

 SQL database implementation, support for MySQL or MariaDB.

@@ -6,16 +6,16 @@ SQL database implementation, support for MySQL or MariaDB.
 ```mysql
 CREATE TABLE IF NOT EXISTS conf
 (
-    `namespace`      VARCHAR(32)      NOT NULL,                           # 命名空间 (代表其属于谁，类似于单个配置文件地址的概念)
-    `path`           VARCHAR(96)      NOT NULL,                           # 配置路径 (ConfigPath)
-    `type`           TINYINT UNSIGNED NOT NULL DEFAULT 0,                 # 数据类型 (Integer/Byte/List/Map/...)
-    `value`          MEDIUMTEXT,                                          # 配置项的值 (可能为JSON格式)
-    `inline_comment` TEXT,                                                # 配置项的用法，本质是行内注释
-    `header_comment` MEDIUMTEXT,                                          # 配置项的描述，本质是顶部注释
-    `footer_comment` MEDIUMTEXT,                                          # 配置项的描述，本质是顶部注释
-    `version`        INT UNSIGNED     NOT NULL DEFAULT 0,                 # 配置项的版本
-    `create_time`    DATETIME         NOT NULL DEFAULT CURRENT_TIMESTAMP, # 创建时间
-    `update_time`    DATETIME         NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    `namespace`      VARCHAR(32)        NOT NULL,                           # 命名空间 (代表其属于谁，类似于单个配置文件地址的概念)
+    `path`           VARCHAR(96)        NOT NULL,                           # 配置路径 (ConfigPath)
+    `type`           TINYINT UNSIGNED   NOT NULL DEFAULT 0,                 # 数据类型 (Integer/Byte/List/Map/...)
+    `value`          MEDIUMTEXT,                                            # 配置项的值 (可能为JSON格式)
+    `inline_comment` TEXT comment 'usage',                                  # 配置项的用法，本质是行内注释
+    `header_comment` MEDIUMTEXT comment 'description',                      # 配置项的描述，本质是顶部注释
+    `footer_comment` MEDIUMTEXT comment 'example',                          # 配置项的参考，本质是底部注释
+    `version`        MEDIUMINT UNSIGNED NOT NULL DEFAULT 0,                 # 配置项的版本
+    `create_time`    DATETIME           NOT NULL DEFAULT CURRENT_TIMESTAMP, # 创建时间
+    `update_time`    DATETIME           NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    PRIMARY KEY (`namespace`, `path`)
 ) ENGINE = InnoDB
  DEFAULT CHARSET = utf8mb4;
@@ -39,9 +39,9 @@ CREATE TABLE IF NOT EXISTS conf

        <repository>
            <!-- Using GitHub dependencies for real-time updates, configuration required (recommended). -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

    </repositories>
@@ -54,7 +54,7 @@ CREATE TABLE IF NOT EXISTS conf
    <dependencies>
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-sql</artifactId>
+            <artifactId>configured-sql</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -71,13 +71,13 @@ repositories {
    mavenCentral()

    // Using GitHub dependencies for real-time updates, configuration required (recommended).
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

 }
 ```

 ```groovy
 dependencies {
-    api "cc.carm.lib:easyconfiguration-sql:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-sql:[LATEST RELEASE]"
 }
 ```
@@ -4,9 +4,9 @@
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.0</version>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -15,35 +15,36 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>

-        <log4j.version>2.24.3</log4j.version>
+        <deps.mysql-driver.version>8.0.33</deps.mysql-driver.version>
+        <deps.log4j.version>2.24.3</deps.log4j.version>
    </properties>
-    <artifactId>easyconfiguration-sql</artifactId>
+    <artifactId>configured-sql</artifactId>

    <dependencies>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-commentable</artifactId>
+            <artifactId>configured-feature-commentable</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-section</artifactId>
+            <artifactId>configured-feature-section</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-versioned</artifactId>
+            <artifactId>configured-feature-versioned</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
@@ -69,7 +70,7 @@

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-demo</artifactId>
+            <artifactId>configured-demo</artifactId>
            <version>${project.parent.version}</version>
            <scope>test</scope>
        </dependency>
@@ -77,21 +78,35 @@
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-api</artifactId>
-            <version>${log4j.version}</version>
+            <version>${deps.log4j.version}</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
-            <version>${log4j.version}</version>
+            <version>${deps.log4j.version}</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-slf4j-impl</artifactId>
-            <version>${log4j.version}</version>
+            <version>${deps.log4j.version}</version>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>${project.parent.groupId}</groupId>
+            <artifactId>configured-gson</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>mysql</groupId>
+            <artifactId>mysql-connector-java</artifactId>
+            <version>${deps.mysql-driver.version}</version>
            <scope>test</scope>
        </dependency>

@@ -0,0 +1,178 @@
+package cc.carm.lib.configuration.source.sql;
+
+import cc.carm.lib.configuration.adapter.ValueType;
+import cc.carm.lib.configuration.commentable.Commentable;
+import cc.carm.lib.configuration.function.DataFunction;
+import cc.carm.lib.configuration.source.ConfigurationFactory;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.versioned.VersionedMetaTypes;
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.api.SQLTable;
+import cc.carm.lib.easysql.api.builder.TableCreateBuilder;
+import cc.carm.lib.easysql.api.enums.IndexType;
+import cc.carm.lib.easysql.api.function.SQLHandler;
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Range;
+
+import java.util.HashMap;
+import java.util.function.BiConsumer;
+import java.util.function.Consumer;
+import java.util.function.Supplier;
+
+public class SQLConfigFactory extends ConfigurationFactory<SQLSource, ConfigurationHolder<SQLSource>, SQLConfigFactory> {
+
+    public static SQLConfigFactory from(@NotNull Supplier<@NotNull SQLManager> managerSupplier) {
+        return new SQLConfigFactory(managerSupplier);
+    }
+
+    public static SQLConfigFactory from(@NotNull SQLManager manager) {
+        return from(() -> manager);
+    }
+
+    protected static final @NotNull Gson DEFAULT_GSON = new GsonBuilder()
+            .serializeNulls().disableHtmlEscaping().create();
+
+    protected static final @NotNull BiConsumer<String, TableCreateBuilder> DEFAULT_TABLE_SCHEMA = (tableName, builder) -> {
+        builder.addColumn("namespace", "VARCHAR(32) NOT NULL");
+        builder.addColumn("path", "VARCHAR(96) NOT NULL");
+
+        builder.addColumn("value", "TEXT");
+
+        builder.addColumn("inline_comment", "TEXT");
+        builder.addColumn("header_comments", "MEDIUMTEXT");
+        builder.addColumn("footer_comments", "MEDIUMTEXT");
+
+        builder.addColumn("type", "TINYINT NOT NULL DEFAULT 0");
+        builder.addColumn("version", "MEDIUMINT UNSIGNED NOT NULL DEFAULT 0");
+
+        builder.addColumn(
+                "create_time",
+                "TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP"
+        );
+        builder.addColumn(
+                "update_time",
+                "TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP"
+        );
+
+        builder.setIndex(
+                IndexType.PRIMARY_KEY, "pk_" + tableName.toLowerCase(),
+                "namespace", "path"
+        );
+        builder.setTableSettings("ENGINE=InnoDB DEFAULT CHARSET=utf8mb4");
+    };
+
+    protected @NotNull Supplier<SQLManager> managerSupplier;
+    protected Supplier<Gson> gsonSupplier = () -> DEFAULT_GSON;
+
+    protected HashMap<Integer, SQLValueResolver<?>> resolvers = new HashMap<>(SQLValueResolver.STANDARD_RESOLVERS);
+    protected SQLTable tableName = SQLTable.of("config", (table) -> DEFAULT_TABLE_SCHEMA.accept("config", table));
+    protected String namespace = "default";
+
+    public SQLConfigFactory(@NotNull Supplier<SQLManager> managerSupplier) {
+        this.managerSupplier = managerSupplier;
+    }
+
+    @Override
+    protected SQLConfigFactory self() {
+        return this;
+    }
+
+    public SQLConfigFactory manager(@NotNull Supplier<SQLManager> managerSupplier) {
+        this.managerSupplier = managerSupplier;
+        return self();
+    }
+
+    public SQLConfigFactory manager(@NotNull SQLManager manager) {
+        return manager(() -> manager);
+    }
+
+    public SQLConfigFactory gson(@NotNull Supplier<Gson> gsonSupplier) {
+        this.gsonSupplier = gsonSupplier;
+        return self();
+    }
+
+    public SQLConfigFactory gson(@NotNull Consumer<GsonBuilder> builder) {
+        return gson(() -> {
+            GsonBuilder gsonBuilder = new GsonBuilder();
+            builder.accept(gsonBuilder);
+            return gsonBuilder.create();
+        });
+    }
+
+    public SQLConfigFactory gson(@NotNull Gson gson) {
+        return gson(() -> gson);
+    }
+
+    public SQLConfigFactory resolver(@Range(from = 0, to = 255) int type, @NotNull SQLValueResolver<?> resolver) {
+        this.resolvers.put(type, resolver);
+        return self();
+    }
+
+    public <T> SQLConfigFactory resolver(@Range(from = 0, to = 255) int id, @NotNull Class<T> clazz,
+                                         @NotNull DataFunction<String, T> parser) {
+        return resolver(id, ValueType.of(clazz), parser);
+    }
+
+    public <T> SQLConfigFactory resolver(@Range(from = 0, to = 255) int id, @NotNull ValueType<T> type,
+                                         @NotNull DataFunction<String, T> parser) {
+        return resolver(id, SQLValueResolver.of(type, parser));
+    }
+
+    public <T> SQLConfigFactory resolver(@Range(from = 0, to = 255) int id, @NotNull Class<T> clazz,
+                                         @NotNull DataFunction<String, T> parser,
+                                         @NotNull DataFunction<T, String> serializer) {
+        return resolver(id, ValueType.of(clazz), parser, serializer);
+    }
+
+    public <T> SQLConfigFactory resolver(@Range(from = 0, to = 255) int id, @NotNull ValueType<T> type,
+                                         @NotNull DataFunction<String, T> parser,
+                                         @NotNull DataFunction<T, String> serializer) {
+        return resolver(id, SQLValueResolver.of(type, parser, serializer));
+    }
+
+    public SQLConfigFactory table(@NotNull SQLTable table) {
+        this.tableName = table;
+        return self();
+    }
+
+    public SQLConfigFactory table(@NotNull String tableName, @NotNull SQLHandler<TableCreateBuilder> builder) {
+        return table(SQLTable.of(tableName, builder));
+    }
+
+    public SQLConfigFactory tableName(@NotNull String tableName) {
+        return table(tableName, table -> DEFAULT_TABLE_SCHEMA.accept(tableName, table));
+    }
+
+    public SQLConfigFactory namespace(@NotNull String namespace) {
+        this.namespace = namespace;
+        return self();
+    }
+
+    @Override
+    public @NotNull ConfigurationHolder<SQLSource> build() {
+        Gson gson = gsonSupplier.get();
+        if (gson == null) throw new NullPointerException("No Gson instance provided.");
+
+        SQLManager manager = this.managerSupplier.get();
+        if (manager == null) throw new NullPointerException("No SQLManager instance provided.");
+
+        Commentable.registerMeta(this.initializer);
+        VersionedMetaTypes.register(this.initializer);
+
+        return new ConfigurationHolder<SQLSource>(this.adapters, this.options, this.metadata, this.initializer) {
+            final SQLSource source = new SQLSource(
+                    this, System.currentTimeMillis(),
+                    gson, manager, resolvers, tableName, namespace
+            );
+
+            @Override
+            public @NotNull SQLSource config() {
+                return source;
+            }
+        };
+    }
+
+
+}
@@ -1,6 +1,12 @@
 package cc.carm.lib.configuration.source.sql;

+import cc.carm.lib.configuration.source.option.ConfigurationOption;
+
 public interface SQLOptions {

+    /**
+     * Whether to purge the configuration's in-database data when saving.
+     */
+    ConfigurationOption<Boolean> PURGE = ConfigurationOption.of( true);

 }
@@ -1,136 +1,170 @@
 package cc.carm.lib.configuration.source.sql;

+import cc.carm.lib.configuration.commentable.Commentable;
 import cc.carm.lib.configuration.source.ConfigurationHolder;
 import cc.carm.lib.configuration.source.section.ConfigureSource;
-import cc.carm.lib.configuration.source.section.MemorySection;
+import cc.carm.lib.configuration.source.section.SourcedSection;
+import cc.carm.lib.configuration.value.ConfigValue;
+import cc.carm.lib.configuration.versioned.VersionedMetaTypes;
 import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.api.SQLQuery;
 import cc.carm.lib.easysql.api.SQLTable;
-import cc.carm.lib.easysql.api.enums.IndexType;
 import com.google.gson.Gson;
-import com.google.gson.GsonBuilder;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;

+import java.sql.ResultSet;
+import java.time.LocalDateTime;
 import java.util.*;

-public class SQLSource extends ConfigureSource<MemorySection, Map<?, ?>, SQLSource> {
-
-    protected static final @NotNull Gson DEFAULT_GSON = new GsonBuilder()
-            .serializeNulls().disableHtmlEscaping().setPrettyPrinting()
-            .create();
+public class SQLSource extends ConfigureSource<SourcedSection, Map<String, Object>, SQLSource> {

    protected final @NotNull Gson gson;
    protected final @NotNull SQLManager sqlManager;
    protected final @NotNull String namespace;
    protected final @NotNull SQLTable table;

-    protected final @NotNull Set<String> updated = new HashSet<>();
-    protected MemorySection rootSection;
+    protected final @NotNull Map<Integer, SQLValueResolver<?>> resolvers;
+    protected SourcedSection rootSection;

    public SQLSource(@NotNull ConfigurationHolder<? extends SQLSource> holder, long lastUpdateMillis,
-                     @NotNull Gson gson, @NotNull SQLManager sqlManager, @NotNull String tableName, @NotNull String namespace) {
+                     @NotNull Gson gson, @NotNull SQLManager sqlManager,
+                     @NotNull Map<Integer, SQLValueResolver<?>> resolvers,
+                     @NotNull SQLTable table, @NotNull String namespace) {
        super(holder, lastUpdateMillis);
        this.gson = gson;
        this.sqlManager = sqlManager;
+        this.resolvers = resolvers;
        this.namespace = namespace;
-        this.table = SQLTable.of(tableName, builder -> {
+        this.table = table;

-            builder.addColumn("namespace", "VARCHAR(32) NOT NULL");
-            builder.addColumn("path", "VARCHAR(96) NOT NULL");
-
-            builder.addColumn("type", "TINYINT NOT NULL DEFAULT 0");
-            builder.addColumn("value", "TEXT");
-
-            builder.addColumn("inline_comment", "TEXT");
-            builder.addColumn("header_comments", "MEDIUMTEXT");
-            builder.addColumn("footer_comments", "MEDIUMTEXT");
-
-            builder.addColumn("version", "MEDIUMINT UNSIGNED NOT NULL DEFAULT 0");
-
-            builder.addColumn("create_time", "TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP");
-            builder.addColumn("update_time", "TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP");
-
-            builder.setIndex(
-                    IndexType.PRIMARY_KEY, "pk_" + tableName.toLowerCase(),
-                    "namespace", "path"
-            );
-            builder.setTableSettings("ENGINE=InnoDB DEFAULT CHARSET=utf8mb4");
-        });
+        try {
+            this.table.create(this.sqlManager);
+            onReload();
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
    }

    @Override
-    protected SQLSource self() {
+    protected @NotNull SQLSource self() {
        return this;
    }

+    public @NotNull Gson gson() {
+        return gson;
+    }
+
    @Override
-    public @NotNull Map<?, ?> original() {
+    public @NotNull Map<String, Object> original() {
        return section().data();
    }

    @Override
-    public @NotNull MemorySection section() {
+    public @NotNull SourcedSection section() {
        return Objects.requireNonNull(this.rootSection, "Root section is not initialized.");
    }

+    public int purge() throws Exception {
+        return this.table.createDelete().addCondition("namespace", namespace).build().execute();
+    }
+
    @Override
    public void save() throws Exception {
-        if (this.updated.isEmpty()) return; // Nothing to save
+        LocalDateTime time = LocalDateTime.now(); // Update time
+        List<Object[]> dataValues = new ArrayList<>();

-        Date date = new Date(); // Update time
-        List<Object[]> values = new ArrayList<>();
+        SourcedSection section = section();
+        Map<String, ConfigValue<?>> values = holder().registeredValues();
+        for (Map.Entry<String, ConfigValue<?>> entry : values.entrySet()) {
+            @NotNull String path = entry.getKey();
+            @NotNull ConfigValue<?> config = entry.getValue();
+            @Nullable Object value = section.get(path);

-        for (String path : this.updated) {
-            Object value = get(path);
+            if (value instanceof SourcedSection) {
+                value = ((SourcedSection) value).asMap();
+            } else if (value instanceof List<?>) {
+                List<Object> list = new ArrayList<>();
+                for (Object obj : (List<?>) value) {
+                    if (obj instanceof SourcedSection) {
+                        list.add(((SourcedSection) obj).asMap());
+                    } else {
+                        list.add(obj);
+                    }
+                }
+                value = list;
+            }

-//            if (value instanceof SQLConfigWrapper) {
-//                value = getSourceMap(((SQLConfigWrapper) value).getSource());
-//            }
-//
-//            SQLValueResolver<?> type = SQLValueTypes.get(value.getClass());
-//            if (type != null) {
-//                values.add(new Object[]{
-//                        this.namespace, path, date,
-//                        type.getID(), type.serializeObject(value),
-//                        getComments().getInlineComment(path),
-//                        GSON.toJson(getComments().getHeaderComment(path))
-//                });
-//            }
+            if (value == null) continue;
+
+            try {
+                int typeID = typeIdOf(value);
+                String data = serialize(typeID, value);
+                if (data == null) continue;
+
+                int version = holder().metadata(path).get(VersionedMetaTypes.VERSION, 0);
+                dataValues.add(new Object[]{
+                        namespace, path, time, version, typeID, data,
+                        Commentable.getInlineComment(holder(), path),
+                        gson.toJson(Commentable.getHeaderComments(holder(), path)),
+                        gson.toJson(Commentable.getFooterComments(holder(), path))
+                });
+            } catch (Exception ex) {
+                ex.printStackTrace();
+            }
        }

-        this.updated.clear();
-
+        if (holder.option(SQLOptions.PURGE)) {
+            purge();
+        }
        this.table.createReplaceBatch()
-                .setColumnNames("namespace", "path", "update_time", "type", "value", "inline_comment", "header_comments")
-                .setAllParams(values)
-                .execute();
+                .setColumnNames(
+                        "namespace", "path", "update_time", "version", "type", "value",
+                        "inline_comment", "header_comments", "footer_comments"
+                ).setAllParams(dataValues).execute();
    }

    @Override
    protected void onReload() throws Exception {
-        LinkedHashMap<String, Object> values = new LinkedHashMap<>();
-
-//        try (SQLQuery query = this.table.createQuery()
-//                .addCondition("namespace", namespace)
-//                .build().execute()) {
-//            ResultSet rs = query.getResultSet();
-//            while (rs.next()) {
-//                String path = rs.getString("path");
-//                int type = rs.getInt("type");
-//                try {
-//                    SQLValueResolver<?> resolver = SQLValueTypes.get(type);
-//                    if (resolver == null) throw new IllegalStateException("No resolver for type #" + type);
-//                    String value = rs.getString("value");
-//                    values.put(path, resolver.resolve(value));
-//
-//                    loadInlineComment(path, rs.getString("inline_comment"));
-//                    loadHeaderComment(path, rs.getString("header_comments"));
-//                } catch (Exception ex) {
-//                    ex.printStackTrace();
-//                }
-//            }
-//        }
-//
-//        this.rootConfiguration = new SQLConfigWrapper(this, values);
+        Map<String, Object> loaded = new LinkedHashMap<>();
+        try (SQLQuery query = this.table.createQuery()
+                .addCondition("namespace", namespace)
+                .build().execute()) {
+            ResultSet rs = query.getResultSet();
+            while (rs.next()) {
+                String path = rs.getString("path");
+                if (path == null) continue; // Path should be not null
+                int ver = rs.getInt("version");
+                try {
+                    loaded.put(path, parse(rs.getInt("type"), rs.getString("value")));
+                    if (ver != 0) holder().metadata(path).set(VersionedMetaTypes.VERSION, ver);
+                } catch (Exception e) {
+                    e.printStackTrace();
+                }
+            }
+        }
+        this.rootSection = SourcedSection.root(this, loaded);
    }

+
+    protected @Nullable Object parse(int type, String value) throws Exception {
+        SQLValueResolver<?> function = this.resolvers.get(type);
+        if (function == null) throw new IllegalStateException("No resolvers for type #" + type);
+        return function.resolve(this, value);
+    }
+
+    protected @Nullable String serialize(int type, @NotNull Object value) throws Exception {
+        SQLValueResolver<?> function = this.resolvers.get(type);
+        if (function == null) throw new IllegalStateException("No resolvers for type #" + type);
+        return function.serialize(this, value);
+    }
+
+    protected int typeIdOf(@NotNull Object value) {
+        return this.resolvers.entrySet().stream()
+                .filter(entry -> entry.getValue().isInstance(value))
+                .findFirst().map(Map.Entry::getKey)
+                .orElseThrow(() -> new IllegalStateException("No resolvers for value " + value.getClass().getName()));
+    }
+
+
 }
@@ -0,0 +1,115 @@
+package cc.carm.lib.configuration.source.sql;
+
+import cc.carm.lib.configuration.adapter.ValueType;
+import cc.carm.lib.configuration.function.DataFunction;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public abstract class SQLValueResolver<T> {
+
+    public static final @NotNull SQLValueResolver<String> STRING = SQLValueResolver.of(ValueType.STRING, s -> s);
+    public static final @NotNull SQLValueResolver<Byte> BYTE = SQLValueResolver.of(ValueType.BYTE, Byte::parseByte);
+    public static final @NotNull SQLValueResolver<Short> SHORT = SQLValueResolver.of(ValueType.SHORT, Short::parseShort);
+    public static final @NotNull SQLValueResolver<Integer> INTEGER = SQLValueResolver.of(ValueType.INTEGER, Integer::parseInt);
+    public static final @NotNull SQLValueResolver<Long> LONG = SQLValueResolver.of(ValueType.LONG, Long::parseLong);
+    public static final @NotNull SQLValueResolver<Float> FLOAT = SQLValueResolver.of(ValueType.FLOAT, Float::parseFloat);
+    public static final @NotNull SQLValueResolver<Double> DOUBLE = SQLValueResolver.of(ValueType.DOUBLE, Double::parseDouble);
+    public static final @NotNull SQLValueResolver<Boolean> BOOLEAN = SQLValueResolver.of(ValueType.BOOLEAN, Boolean::parseBoolean);
+    public static final @NotNull SQLValueResolver<Character> CHAR = SQLValueResolver.of(ValueType.CHAR, s -> s.charAt(0));
+
+    public static final @NotNull SQLValueResolver<List<?>> LIST = new SQLValueResolver<List<?>>(new ValueType<List<?>>() {
+    }) {
+        @Override
+        public @Nullable List<?> resolve(@NotNull SQLSource source, String data) throws Exception {
+            return source.gson().fromJson(data, List.class);
+        }
+
+        @Override
+        public @Nullable String serialize(@NotNull SQLSource source, Object value) {
+            return source.gson().toJson(value);
+        }
+    };
+
+    public static final @NotNull SQLValueResolver<Map<?, ?>> MAP = new SQLValueResolver<Map<?, ?>>(new ValueType<Map<?, ?>>() {
+    }) {
+        @Override
+        public @Nullable Map<?, ?> resolve(@NotNull SQLSource source, String data) throws Exception {
+            return source.gson().fromJson(data, LinkedHashMap.class);
+        }
+
+        @Override
+        public @Nullable String serialize(@NotNull SQLSource source, Object value) {
+            return source.gson().toJson(value);
+        }
+    };
+
+    public static final @NotNull Map<Integer, SQLValueResolver<?>> STANDARD_RESOLVERS = Collections.unmodifiableMap(standards());
+
+    static Map<Integer, SQLValueResolver<?>> standards() {
+        Map<Integer, SQLValueResolver<?>> map = new LinkedHashMap<>();
+        map.put(0, STRING);
+        map.put(1, BYTE);
+        map.put(2, SHORT);
+        map.put(3, INTEGER);
+        map.put(4, LONG);
+        map.put(5, FLOAT);
+        map.put(6, DOUBLE);
+        map.put(7, BOOLEAN);
+        map.put(8, CHAR);
+        map.put(10, LIST);
+        map.put(11, MAP);
+        return map;
+    }
+
+    public static <V> SQLValueResolver<V> of(@NotNull ValueType<V> type, @NotNull DataFunction<String, V> resolver) {
+        return new SQLValueResolver<V>(type) {
+            @Override
+            public @NotNull V resolve(@NotNull SQLSource source, String data) throws Exception {
+                return resolver.handle(data);
+            }
+        };
+    }
+
+    public static <V> SQLValueResolver<V> of(@NotNull ValueType<V> type,
+                                             @NotNull DataFunction<String, V> resolver,
+                                             @NotNull DataFunction<V, String> serializer) {
+        return new SQLValueResolver<V>(type) {
+            @Override
+            public @NotNull V resolve(@NotNull SQLSource source, String data) throws Exception {
+                return resolver.handle(data);
+            }
+
+            @Override
+            public @NotNull String serialize(@NotNull SQLSource source, Object value) throws Exception {
+                return serializer.handle(type.cast(value));
+            }
+        };
+    }
+
+
+    protected final @NotNull ValueType<T> type;
+
+    protected SQLValueResolver(@NotNull ValueType<T> type) {
+        this.type = type;
+    }
+
+    public @NotNull ValueType<T> getType() {
+        return type;
+    }
+
+    public boolean isInstance(@NotNull Object obj) {
+        return getType().isInstance(obj);
+    }
+
+    public abstract @Nullable T resolve(@NotNull SQLSource source, String data) throws Exception;
+
+    public @Nullable String serialize(@NotNull SQLSource source, Object value) throws Exception {
+        return String.valueOf(value);
+    }
+
+}
@@ -1,27 +1,48 @@
 package config;

+import cc.carm.lib.configuration.demo.DatabaseConfiguration;
+import cc.carm.lib.configuration.demo.tests.ConfigurationTest;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.configuration.source.json.JSONConfigFactory;
+import cc.carm.lib.configuration.source.sql.SQLConfigFactory;
 import cc.carm.lib.easysql.EasySQL;
 import cc.carm.lib.easysql.api.SQLManager;
 import cc.carm.lib.easysql.beecp.BeeDataSourceConfig;
+import org.junit.Test;
+
+import java.io.File;

 public class SQLConfigTest {

+    boolean local = false;

+    @Test
    public void test() {
+        if (!local) return;
+
+        ConfigurationHolder<?> gsonHolder = JSONConfigFactory.from(new File("target/sql.json")).build();
+        gsonHolder.initialize(DatabaseConfiguration.class);
+
        BeeDataSourceConfig config = new BeeDataSourceConfig();
-        config.setDriverClassName("org.h2.Driver");
-        config.setJdbcUrl("jdbc:h2:file:target/test;DB_CLOSE_DELAY=-1;MODE=MySQL;");
+        config.setDriverClassName(DatabaseConfiguration.DRIVER_NAME.resolve());
+        config.setJdbcUrl(DatabaseConfiguration.buildJDBC());
+        config.setUsername(DatabaseConfiguration.USERNAME.resolve());
+        config.setPassword(DatabaseConfiguration.PASSWORD.resolve());
+
        SQLManager manager = EasySQL.createManager(config);
        manager.setDebugMode(true);

-//        SQLConfigProvider provider = EasyConfiguration.from(manager, "conf_test", "TESTING");
-//
-//        ConfigurationTest.testDemo(provider);
-//        ConfigurationTest.testInner(provider);
-//
-//        ConfigurationTest.save(provider);
-//
-//        EasySQL.shutdownManager(manager);
+        ConfigurationHolder<?> holder = SQLConfigFactory.from(manager)
+                .tableName("test_configs")
+                .namespace("testing")
+                .build();
+
+        ConfigurationTest.testDemo(holder);
+        ConfigurationTest.testInner(holder);
+
+        ConfigurationTest.save(holder);
+
+        EasySQL.shutdownManager(manager);
    }

 }
@@ -1,4 +1,4 @@
-# EasyConfiguration-YAML
+# configured-YAML

 YAML file-based implementation, compatible with all Java environments.

@@ -20,9 +20,9 @@ YAML file-based implementation, compatible with all Java environments.

        <repository>
            <!-- Using GitHub dependencies for real-time updates, configuration required (recommended). -->
-            <id>EasyConfiguration</id>
+            <id>configured</id>
            <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/EasyConfiguration</url>
+            <url>https://maven.pkg.github.com/CarmJos/configured</url>
        </repository>

    </repositories>
@@ -35,7 +35,7 @@ YAML file-based implementation, compatible with all Java environments.
    <dependencies>
        <dependency>
            <groupId>cc.carm.lib</groupId>
-            <artifactId>easyconfiguration-yaml</artifactId>
+            <artifactId>configured-yaml</artifactId>
            <version>[LATEST RELEASE]</version>
            <scope>compile</scope>
        </dependency>
@@ -52,13 +52,13 @@ repositories {
    mavenCentral()

    // Using GitHub dependencies for real-time updates, configuration required (recommended).
-    maven { url 'https://maven.pkg.github.com/CarmJos/EasyConfiguration' }
+    maven { url 'https://maven.pkg.github.com/CarmJos/configured' }

 }
 ```

 ```groovy
 dependencies {
-    api "cc.carm.lib:easyconfiguration-yaml:[LATEST RELEASE]"
+    api "cc.carm.lib:configured-yaml:[LATEST RELEASE]"
 }
 ```
@@ -4,9 +4,9 @@
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
-        <artifactId>easyconfiguration-parent</artifactId>
+        <artifactId>configured-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>4.0.7</version>
+        <version>4.1.0</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <properties>
@@ -14,38 +14,38 @@
        <maven.compiler.target>${project.jdk.version}</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
-        <deps.yamlcommentwriter.version>1.2.0</deps.yamlcommentwriter.version>
+        <deps.yamlcommentwriter.version>1.2.1</deps.yamlcommentwriter.version>
    </properties>

-    <artifactId>easyconfiguration-yaml</artifactId>
+    <artifactId>configured-yaml</artifactId>
    <packaging>jar</packaging>

    <dependencies>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
+            <artifactId>configured-core</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-file</artifactId>
+            <artifactId>configured-feature-file</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-section</artifactId>
+            <artifactId>configured-feature-section</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-feature-commentable</artifactId>
+            <artifactId>configured-feature-commentable</artifactId>
            <version>${project.parent.version}</version>
            <scope>compile</scope>
        </dependency>
@@ -66,7 +66,7 @@

        <dependency>
            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-demo</artifactId>
+            <artifactId>configured-demo</artifactId>
            <version>${project.parent.version}</version>
            <scope>test</scope>
        </dependency>
@@ -1,5 +1,6 @@
 package yaml.test;

+import cc.carm.lib.configuration.commentable.Commentable;
 import cc.carm.lib.configuration.commentable.CommentableMeta;
 import cc.carm.lib.configuration.demo.tests.ConfigurationTest;
 import cc.carm.lib.configuration.source.ConfigurationHolder;
@@ -21,7 +22,6 @@ public class YamlTests {
        ConfigurationTest.testDemo(holder);
        ConfigurationTest.testInner(holder);

-
        Map<String, List<String>> headers = holder.extractMetadata(CommentableMeta.HEADER);
        System.out.println("Header comments: ");
        headers.forEach((k, v) -> {
Author	SHA1	Message	Date
carm	854e3df49f	feat: Upgrade configured to v4.1.0	2025-03-15 01:52:52 +08:00
carm	f6167c3b5e	docs: Update license [skip ci]	2025-03-15 01:51:07 +08:00
carm	ffe3e88b3b	docs: Translated to English	2025-03-14 19:34:06 +08:00
carm	caa3077f48	chore: Add missing @Nullable	2025-03-14 19:33:30 +08:00
carm	05dbf0b504	docs: Redesign readme	2025-03-14 19:20:31 +08:00
carm	810e95198e	docs: Redesign readme	2025-03-14 19:17:26 +08:00
carm	10004f16b4	docs(logo): Add project banner & logo	2025-03-14 19:09:43 +08:00
carm	8e19748c7c	feat(map): Add more builder functions	2025-03-12 04:04:00 +08:00
carm	17762a2e70	refactor(proj): Change project name to "configured"	2025-03-12 03:27:35 +08:00
carm	7dbd607a3f	refactor(proj): Change project name to "configured"	2025-03-12 03:22:40 +08:00
carm	035e8a227e	test(parse): Add more tests	2025-03-06 20:12:33 +08:00
carm	04eaf6606d	feat: Jump to 4.0.11	2025-03-06 18:19:25 +08:00
carm	e558e93410	feat(sql): Support custom sql table schema	2025-03-06 18:19:06 +08:00
flowerinsnow	e55fe3a8d5	feat: hocon supported	2025-03-06 18:03:27 +08:00
carm	8f075b99b5	chore(deps): use parent dependencies' version	2025-03-04 11:58:01 +08:00
carm	09a0b3c373	chore(deps): use parent dependencies' version	2025-03-04 11:34:16 +08:00
carm	4df4977733	feat(msg): add enhanced text support	2025-03-04 04:21:58 +08:00
carm	6434feb980	fix(sql): Fixed sql table format	2025-03-04 01:57:04 +08:00
carm	bc3e4b3e6f	fix(comment): Fixed yaml comments	2025-03-04 01:24:12 +08:00
carm	c2a9e2254c	feat(section): Add ConfigureSection#asMap function	2025-03-04 01:06:21 +08:00
carm	251dd208af	feat(sql): Support SQL sources	2025-03-03 19:00:28 +08:00
carm	afd1bbfc0f	feat(sql): Support SQL sources	2025-03-03 18:52:41 +08:00
carm	a699f6c164	feat(sql): Support SQL sources	2025-03-03 18:51:21 +08:00
carm	844cbfab53	feat(sql): Try to implement sql source	2025-02-27 13:32:12 +08:00
carm	f74d5d29f9	feat(mongo): Finished source for MongoDB #105	2025-02-27 00:46:44 +08:00