e.g. a value named "foo" without default value will be put as: + *
+ */ + OptionType+ * # Value comments + * # foo: + *
{ +public abstract class ValueAdapter
+ implements ValueSerializer {
return valueType;
}
- public abstract B serialize(@NotNull P provider, @NotNull V value) throws Exception;
-
- public abstract V deserialize(@NotNull P provider, @NotNull Class clazz, @NotNull B data) throws Exception;
-
public boolean isAdaptedFrom(Class clazz) {
return clazz.isAssignableFrom(valueType);
}
@@ -41,7 +37,7 @@ public abstract class ValueAdapter {
}
public boolean isAdapterOf(Class clazz) {
- return valueType.isAssignableFrom(clazz);
+ return clazz == valueType;
}
@SuppressWarnings("unchecked")
diff --git a/core/src/main/java/cc/carm/lib/configuration/adapter/ValueAdapterRegistry.java b/core/src/main/java/cc/carm/lib/configuration/adapter/ValueAdapterRegistry.java
index 607aa0b..460e4ca 100644
--- a/core/src/main/java/cc/carm/lib/configuration/adapter/ValueAdapterRegistry.java
+++ b/core/src/main/java/cc/carm/lib/configuration/adapter/ValueAdapterRegistry.java
@@ -3,20 +3,17 @@ package cc.carm.lib.configuration.adapter;
import cc.carm.lib.configuration.adapter.strandard.PrimitiveAdapters;
import cc.carm.lib.configuration.core.function.ConfigDataFunction;
import cc.carm.lib.configuration.source.ConfigurationProvider;
+import org.jetbrains.annotations.Contract;
import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
import java.util.HashMap;
import java.util.Map;
public class ValueAdapterRegistry {
- protected final @NotNull P provider;
protected final Map {
}
@SuppressWarnings("unchecked")
- public {
}
// Otherwise, we need to serialize one by one.
- return serialize(adapter.serializeObject(provider, value));
+ return serialize(provider, adapter.serializeObject(provider, value));
}
public ValueAdapter Configuration provider
+ * @param The type of base data
+ * @param {
+
+ V deserialize(@NotNull P provider, @NotNull Class clazz, @NotNull B data) throws Exception;
+
+}
diff --git a/core/src/main/java/cc/carm/lib/configuration/adapter/ValueSerializer.java b/core/src/main/java/cc/carm/lib/configuration/adapter/ValueSerializer.java
new file mode 100644
index 0000000..3161bf2
--- /dev/null
+++ b/core/src/main/java/cc/carm/lib/configuration/adapter/ValueSerializer.java
@@ -0,0 +1,18 @@
+package cc.carm.lib.configuration.adapter;
+
+import cc.carm.lib.configuration.source.ConfigurationProvider;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Value serializer, convert target value to base data.
+ *
+ * @param Configuration provider
+ * @param The type of base data
+ * @param {
+
+ B serialize(@NotNull P provider, @NotNull V value) throws Exception;
+
+}
diff --git a/core/src/main/java/cc/carm/lib/configuration/adapter/strandard/EnumAdapter.java b/core/src/main/java/cc/carm/lib/configuration/adapter/strandard/EnumAdapter.java
index 40bd3c4..6f53595 100644
--- a/core/src/main/java/cc/carm/lib/configuration/adapter/strandard/EnumAdapter.java
+++ b/core/src/main/java/cc/carm/lib/configuration/adapter/strandard/EnumAdapter.java
@@ -21,4 +21,9 @@ public class EnumAdapter extends ValueAdapter clazz) {
+ return clazz.isEnum();
+ }
+
}
diff --git a/core/src/main/java/cc/carm/lib/configuration/annotation/ConfigPath.java b/core/src/main/java/cc/carm/lib/configuration/annotation/ConfigPath.java
index 01061e3..252e6a4 100644
--- a/core/src/main/java/cc/carm/lib/configuration/annotation/ConfigPath.java
+++ b/core/src/main/java/cc/carm/lib/configuration/annotation/ConfigPath.java
@@ -1,7 +1,5 @@
package cc.carm.lib.configuration.annotation;
-import cc.carm.lib.configuration.core.ConfigInitializer;
-
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@@ -16,7 +14,7 @@ public @interface ConfigPath {
/**
* The path value of the current configuration.
- * If not set,will generate the path by {@link ConfigInitializer#getPathFromName(String)}.
+ * If not set,will generate the path by {@link cc.carm.lib.configuration.source.path.PathGenerator}.
*
* @return The path value of the current configuration
*/
diff --git a/core/src/main/java/cc/carm/lib/configuration/core/ConfigInitializer.java b/core/src/main/java/cc/carm/lib/configuration/core/ConfigInitializer.java
deleted file mode 100644
index 286b35e..0000000
--- a/core/src/main/java/cc/carm/lib/configuration/core/ConfigInitializer.java
+++ /dev/null
@@ -1,275 +0,0 @@
-package cc.carm.lib.configuration.core;
-
-import cc.carm.lib.configuration.annotation.ConfigPath;
-import cc.carm.lib.configuration.annotation.HeaderComment;
-import cc.carm.lib.configuration.annotation.InlineComment;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.value.ConfigValue;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.lang.reflect.Field;
-import java.util.Arrays;
-import java.util.List;
-
-/**
- * 配置文件类初始化方法
- * 用于初始化 {@link Configuration} 中的每个 {@link ConfigValue} 对象
- *
- * @param {
+import java.util.function.Consumer;
+import java.util.function.Function;
- protected ConfigurationLoader loader;
- protected ValueAdapterRegistry processors;
+public abstract class ConfigurationBuilder , C> {
+ protected Function adapters = new ValueAdapterRegistry<>();
+ protected OptionHolder options = new OptionHolder();
+
+ public abstract C getThis();
+
+ public C loader(Function loader) {
+ return loader(p -> loader);
+ }
+
+ public C loader(Consumer pathGenerator) {
+ return loader(loader -> {
+ loader.setPathGenerator(pathGenerator);
+ });
+ }
+
+ public C adapters(ValueAdapterRegistry adapters) {
+ this.adapters = adapters;
+ return getThis();
+ }
+
+ public C adapter(Consumer > {
+
+ protected final P provider;
+ protected PathGenerator pathGenerator;
+
+ public ConfigurationLoader(P provider) {
+ this(provider, StandardPathGenerator.of(provider));
+ }
+
+ public ConfigurationLoader(P provider, PathGenerator pathGenerator) {
+ this.provider = provider;
+ this.pathGenerator = pathGenerator;
+ }
+
+ public void setPathGenerator(PathGenerator pathGenerator) {
+ this.pathGenerator = pathGenerator;
+ }
+
+ public PathGenerator getPathGenerator() {
+ return pathGenerator;
+ }
+
+ /**
+ * 初始化指定类以及其子类的所有 {@link ConfigValue} 对象。
+ *
+ * @param clazz 配置文件类，须继承于 {@link Configuration} 。
+ */
+ public void initialize(@NotNull P provider, @NotNull Class clazz) {
+ initialize(clazz, saveDefaults, true);
+ }
+
+ /**
+ * 初始化指定类的所有 {@link ConfigValue} 对象。
+ *
+ * @param clazz 配置文件类，须继承于 {@link Configuration} 。
+ * @param saveDefaults 是否写入默认值(默认为 true)。
+ * @param loadSubClasses 是否加载内部子类(默认为 true)。
+ */
+ public void initialize(@NotNull Class clazz) {
+ initializeStaticClass(
+ clazz, null, null,
+ null, null, null,
+ saveDefaults, loadSubClasses
+ );
+ if (saveDefaults) {
+ try {
+ provider.save();
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
+ }
+ }
+
+ /**
+ * 初始化指定实例的所有 {@link ConfigValue} 与内部 {@link Configuration} 对象。
+ *
+ * @param config 配置文件实例类，须实现 {@link Configuration} 。
+ */
+ public void initialize(@NotNull Configuration config) {
+ initialize(config, true);
+ }
+
+ /**
+ * 初始化指定实例的所有 {@link ConfigValue} 与内部 {@link Configuration} 对象。
+ *
+ * @param config 配置文件实例类，须实现 {@link Configuration} 。
+ * @param saveDefaults 是否写入默认值(默认为 true)。
+ */
+ public void initialize(@NotNull Configuration config, boolean saveDefaults) {
+ initializeInstance(
+ config, null, null,
+ null, null, null,
+ saveDefaults
+ );
+ if (saveDefaults) {
+ try {
+ provider.save();
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
+ }
+ }
+
+
+ // 针对实例类的初始化方法
+ private void initializeInstance(@NotNull Configuration root,
+ @Nullable String parentPath, @Nullable String fieldName,
+ @Nullable ConfigPath fieldPath,
+ @Nullable HeaderComment fieldHeaderComments,
+ @Nullable InlineComment fieldInlineComments,
+ boolean saveDefaults) {
+ String path = getClassPath(root.getClass(), parentPath, fieldName, fieldPath);
+ this.provider.setHeaderComment(path, getClassHeaderComments(root.getClass(), fieldHeaderComments));
+ if (path != null) this.provider.setInlineComment(path, readInlineComments(fieldInlineComments));
+
+ for (Field field : root.getClass().getDeclaredFields()) {
+ initializeField(root, field, path, saveDefaults, false);
+ }
+ }
+
+ // 针对静态类的初始化方法
+ private void initializeStaticClass(@NotNull Class clazz,
+ @Nullable String parentPath, @Nullable String fieldName,
+ @Nullable ConfigPath fieldPath,
+ @Nullable HeaderComment fieldHeaderComments,
+ @Nullable InlineComment fieldInlineComments,
+ boolean saveDefaults, boolean loadSubClasses) {
+ if (!Configuration.class.isAssignableFrom(clazz)) return; // 只解析继承了 ConfigurationRoot 的类
+ String path = getClassPath(clazz, parentPath, fieldName, fieldPath);
+ this.provider.setHeaderComment(path, getClassHeaderComments(clazz, fieldHeaderComments));
+ if (path != null) this.provider.setInlineComment(path, readInlineComments(fieldInlineComments));
+
+ for (Field field : clazz.getDeclaredFields()) {
+ initializeField(clazz, field, path, saveDefaults, loadSubClasses);
+ }
+
+ if (!loadSubClasses) return;
+ Class[] classes = clazz.getDeclaredClasses();
+ for (int i = classes.length - 1; i >= 0; i--) { // 逆向加载，保持顺序。
+ initializeStaticClass(
+ classes[i], path, classes[i].getSimpleName(),
+ null, null, null,
+ saveDefaults, true
+ );
+ }
+ }
+
+ private void initializeField(@NotNull Object source, @NotNull Field field,
+ @Nullable String parent, boolean saveDefaults, boolean loadSubClasses) {
+ try {
+ field.setAccessible(true);
+ Object object = field.get(source);
+
+ if (object instanceof ConfigValue) {
+ initializeValue(
+ (ConfigValue) object, getFieldPath(field, parent),
+ field.getAnnotation(HeaderComment.class),
+ field.getAnnotation(InlineComment.class),
+ saveDefaults
+ );
+ } else if (source instanceof Configuration && object instanceof Configuration) {
+ // 当且仅当 源字段与字段 均为ConfigurationRoot实例时，才对目标字段进行下一步初始化加载。
+ initializeInstance(
+ (Configuration) object, parent, field.getName(),
+ field.getAnnotation(ConfigPath.class),
+ field.getAnnotation(HeaderComment.class),
+ field.getAnnotation(InlineComment.class),
+ saveDefaults
+ );
+ } else if (source instanceof Class && object instanceof Class) {
+ // 当且仅当 源字段与字段 均为静态类时，才对目标字段进行下一步初始化加载。
+ initializeStaticClass(
+ (Class) object, parent, field.getName(),
+ field.getAnnotation(ConfigPath.class),
+ field.getAnnotation(HeaderComment.class),
+ field.getAnnotation(InlineComment.class),
+ saveDefaults, loadSubClasses
+ );
+ }
+
+ // 以上判断实现以下规范：
+ // - 实例类中仅加载 ConfigValue实例 与 ConfigurationRoot实例
+ // - 静态类中仅加载 静态ConfigValue实例 与 静态ConfigurationRoot类
+
+ } catch (IllegalAccessException ignored) {
+ }
+ }
+
+ protected void initializeValue(@NotNull ConfigValue value, @NotNull String path,
+ @Nullable HeaderComment fieldHeaderComment,
+ @Nullable InlineComment fieldInlineComment,
+ boolean saveDefaults) {
+ value.initialize(
+ provider, saveDefaults, path,
+ readHeaderComments(fieldHeaderComment),
+ readInlineComments(fieldInlineComment)
+ );
+ }
+
}
diff --git a/core/src/main/java/cc/carm/lib/configuration/source/ConfigurationProvider.java b/core/src/main/java/cc/carm/lib/configuration/source/ConfigurationProvider.java
index 89354f3..fb662ed 100644
--- a/core/src/main/java/cc/carm/lib/configuration/source/ConfigurationProvider.java
+++ b/core/src/main/java/cc/carm/lib/configuration/source/ConfigurationProvider.java
@@ -1,6 +1,37 @@
package cc.carm.lib.configuration.source;
-public class ConfigurationProvider {
+import cc.carm.lib.configuration.adapter.ValueAdapterRegistry;
+import cc.carm.lib.configuration.core.Configuration;
+import cc.carm.lib.easyoptions.OptionHolder;
+import cc.carm.lib.easyoptions.OptionType;
+import org.jetbrains.annotations.NotNull;
+
+public abstract class ConfigurationProvider > {
+
+ protected @NotNull ConfigurationLoader loader = new ConfigurationLoader<>();
+ protected @NotNull ValueAdapterRegistry adapters = new ValueAdapterRegistry<>();
+ protected @NotNull OptionHolder options = new OptionHolder();
+
+
+ public OptionHolder options() {
+ return options;
+ }
+
+ public loader() {
+ return loader;
+ }
+
+ public void load(Configuration configuration) {
+ loader().load(configuration);
+ }
}
diff --git a/core/src/main/java/cc/carm/lib/configuration/source/path/PathGenerator.java b/core/src/main/java/cc/carm/lib/configuration/source/path/PathGenerator.java
new file mode 100644
index 0000000..19d0a6d
--- /dev/null
+++ b/core/src/main/java/cc/carm/lib/configuration/source/path/PathGenerator.java
@@ -0,0 +1,33 @@
+package cc.carm.lib.configuration.source.path;
+
+import cc.carm.lib.configuration.source.ConfigurationProvider;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.lang.reflect.Field;
+
+public interface PathGenerator > {
+
+ @Nullable String getFieldPath(@Nullable String parentPath, @NotNull Field field);
+
+ @Nullable String getClassPath(@Nullable String parentPath,
+ @NotNull Class clazz, @Nullable Field clazzField);
+
+ /**
+ * Get the configuration name of the specified element.
+ * Use the naming convention of all lowercase and "-" links.
+ *
+ * @param name source name
+ * @return the final path
+ */
+ static String covertPathName(String name) {
+ return name.replaceAll("[A-Z]", "-$0") // 将驼峰形转换为蛇形;
+ .replaceAll("-(.*)", "$1") // 若首字母也为大写，则也会被转换，需要去掉第一个横线
+ .replaceAll("_-([A-Z])", "_$1") // 因为命名中可能包含 _，因此需要被特殊处理一下
+ .replaceAll("([a-z])-([A-Z])", "$1_$2") // 然后将非全大写命名的内容进行转换
+ .replace("-", "") // 移除掉多余的横线
+ .replace("_", "-") // 将下划线替换为横线
+ .toLowerCase(); // 最后转为全小写
+ }
+
+}
diff --git a/core/src/main/java/cc/carm/lib/configuration/source/path/StandardPathGenerator.java b/core/src/main/java/cc/carm/lib/configuration/source/path/StandardPathGenerator.java
new file mode 100644
index 0000000..824db53
--- /dev/null
+++ b/core/src/main/java/cc/carm/lib/configuration/source/path/StandardPathGenerator.java
@@ -0,0 +1,74 @@
+package cc.carm.lib.configuration.source.path;
+
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.source.ConfigurationProvider;
+import cc.carm.lib.configuration.source.standard.ConfigurationOptions;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.lang.reflect.Field;
+import java.util.function.UnaryOperator;
+
+public class StandardPathGenerator > implements PathGenerator {
+
+ public static