feat: Optimized comments & sections behavior

demo/src/main/java/cc/carm/lib/configuration/demo/DatabaseConfiguration.java

@@ -2,15 +2,15 @@ package cc.carm.lib.configuration.demo;
 
 import cc.carm.lib.configuration.Configuration;
 import cc.carm.lib.configuration.annotation.ConfigPath;
-import cc.carm.lib.configuration.annotation.HeaderComment;
+import cc.carm.lib.configuration.annotation.HeaderComments;
 import cc.carm.lib.configuration.value.ConfigValue;
 import cc.carm.lib.configuration.value.standard.ConfiguredValue;
 
-@HeaderComment({"", "数据库配置", "  用于提供数据库连接，进行数据库操作。"})
+@HeaderComments({"", "数据库配置", "  用于提供数据库连接，进行数据库操作。"})
 public class DatabaseConfiguration implements Configuration {
 
     @ConfigPath("driver")
-    @HeaderComment({
+    @HeaderComments({
             "数据库驱动配置，请根据数据库类型设置。",
             "- MySQL(旧): com.mysql.jdbc.Driver",
             "- MySQL(新): com.mysql.cj.jdbc.Driver",

demo/src/main/java/cc/carm/lib/configuration/demo/tests/conf/DemoConfiguration.java

@@ -2,7 +2,8 @@ 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.HeaderComment;
+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.demo.tests.model.UserRecord;
@@ -14,16 +15,20 @@ import java.time.temporal.ChronoUnit;
 import java.util.Objects;
 import java.util.UUID;
 
-
-@HeaderComment({"此处内容将显示在配置文件的最上方"})
+@ConfigPath(root = true)
+@HeaderComments({"此处内容将显示在配置文件的最上方"})
+@FooterComments({"此处内容将显示在配置文件的最下方", "可用于显示版权信息等"})
 public interface DemoConfiguration extends Configuration {
 
     @ConfigPath(root = true)
     ConfigValue<Double> VERSION = ConfiguredValue.of(Double.class, 1.0D);
 
     @ConfigPath(root = true)
+    @FooterComments({"此处内容将显示在配置条目的下方", "可用于补充说明，但一般不建议使用"})
     ConfigValue<Long> TEST_NUMBER = ConfiguredValue.of(1000000L);
 
+    @HeaderComments({"枚举类型测试"})
+    @FooterComments({"上述的枚举内容本质上是通过STRING解析的"})
     ConfigValue<ChronoUnit> TEST_ENUM = ConfiguredValue.of(ChronoUnit.class, ChronoUnit.DAYS);
 
     // 支持通过 Class<?> 变量标注子配置，一并注册。
@@ -31,8 +36,10 @@ public interface DemoConfiguration extends Configuration {
     Class<?> DATABASE = DatabaseConfiguration.class;
 
     @ConfigPath("registered_users") // 通过注解规定配置文件中的路径，若不进行注解则以变量名自动生成。
-    @HeaderComment({"Section类型数据测试"}) // 通过注解给配置添加注释。
-    @InlineComment("Section数据也支持InlineComment注释")
+    @HeaderComments({"Section类型数据测试"}) // 通过注解给配置添加注释。
+    @InlineComment("默认地注释会加到Section的首行末尾") // 通过注解给配置添加注释。
+    @InlineComment(value = "用户名(匹配注释)", regex = "name") // 通过注解给配置添加注释。
+    @InlineComment(value = "信息", regex = "info.*") // 通过注解给配置添加注释。
     ConfiguredList<UserRecord> USERS = ConfiguredList.builderOf(UserRecord.class).fromSection()
             .parse(UserRecord::deserialize).serialize(UserRecord::serialize)
             .defaults(UserRecord.CARM).build();
@@ -52,15 +59,15 @@ public interface DemoConfiguration extends Configuration {
     class SUB implements Configuration {
 
         @ConfigPath(value = "uuid-value", root = true)
-        @InlineComment("This is an inline comment")
         public static final ConfigValue<UUID> UUID_CONFIG_VALUE = ConfiguredValue
                 .builderOf(UUID.class).fromString()
                 .parse((holder, data) -> UUID.fromString(data))
                 .build();
 
-        public static class That implements Configuration {
+        @HeaderComments({"内部类的内部类测试", "通过这种方式，您可以轻易实现多层次的配置文件结构"})
+        public interface That extends Configuration {
 
-            public static final ConfiguredList<UUID> OPERATORS = ConfiguredList
+            ConfiguredList<UUID> OPERATORS = ConfiguredList
                     .builderOf(UUID.class).fromString()
                     .parse(s -> Objects.requireNonNull(UUID.fromString(s)))
                     .build();

demo/src/main/java/cc/carm/lib/configuration/demo/tests/conf/InstanceConfig.java

@@ -1,11 +1,11 @@
 package cc.carm.lib.configuration.demo.tests.conf;
 
 import cc.carm.lib.configuration.Configuration;
-import cc.carm.lib.configuration.annotation.HeaderComment;
+import cc.carm.lib.configuration.annotation.HeaderComments;
 import cc.carm.lib.configuration.value.ConfigValue;
 import cc.carm.lib.configuration.value.standard.ConfiguredValue;
 
-@HeaderComment("Inner Test")
+@HeaderComments("Inner Test")
 public class InstanceConfig implements Configuration {
 
     public final ConfigValue<Double> INNER_VALUE = ConfiguredValue.of(1.0D);

demo/src/main/java/cc/carm/lib/configuration/demo/tests/conf/RegistryConfig.java

@@ -2,7 +2,8 @@ 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.HeaderComment;
+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.tests.model.UserRecord;
 import cc.carm.lib.configuration.value.ConfigValue;
@@ -12,12 +13,11 @@ import java.util.UUID;
 
 public class RegistryConfig implements Configuration {
 
-    @HeaderComment("Support for configurations as instances")
+    @HeaderComments("Support for configurations as instances")
     public final InstanceConfig INSTANCE = new InstanceConfig();
 
     @ConfigPath("test.user") // 通过注解规定配置文件中的路径，若不进行注解则以变量名自动生成。
-    @HeaderComment({"Section类型数据测试"}) // 通过注解给配置添加注释。
-    @InlineComment("Section数据也支持InlineComment注释")
+    @FooterComments({"12313213212"})
     public final ConfigValue<UserRecord> TEST_MODEL = ConfiguredValue.builderOf(UserRecord.class).fromSection()
             .defaults(new UserRecord("Carm", UUID.randomUUID()))
             .parse((holder, section) -> UserRecord.deserialize(section))