增加 BaseConfigController.java 的注释

This commit is contained in:
许轲 2023-10-11 02:07:49 +08:00
parent b9fdb14bcd
commit 2b0ffd1a22

View File

@ -16,8 +16,13 @@ import java.nio.file.Path;
import java.nio.file.Paths; import java.nio.file.Paths;
/** /**
* 基本配置文件控制器抽象类 * 抽象基本配置文件控制器类
* <p>
* 该类是基本配置文件控制器的抽象实现提供了加载持久化配置文件以及其他相关方法
* </p>
* *
* @param <T> 配置文件类型
*
* @author gewuyou * @author gewuyou
*/ */
public abstract class BaseConfigController<T> implements ConfigController<T> { public abstract class BaseConfigController<T> implements ConfigController<T> {
@ -27,48 +32,47 @@ public abstract class BaseConfigController<T> implements ConfigController<T> {
protected static final String SYSTEM_CONFIG_DIR = "system"; protected static final String SYSTEM_CONFIG_DIR = "system";
protected T config; protected T config;
Logger logger = LogUtil.getLogger(this.getClass()); private final Logger logger = LogUtil.getLogger(getClass());
/** /**
* 获取配置文件Class类 * 获取配置文件Class类
* *
* @return 配置文件Class类 * @return 配置文件Class类
*/ */
protected abstract Class<T> getConfigClass(); protected abstract Class<T> getConfigClass();
/** /**
* 获取配置文件名称 * 获取配置文件名称
* *
* @return 配置文件名称 * @return 配置文件名称
*/ */
protected abstract String getConfigName(); protected abstract String getConfigName();
/** /**
* 获取配置文件文件夹路径 * 获取配置文件文件夹路径
* *
* @return 配置文件夹路径 * @return 配置文件夹路径
*/ */
protected abstract String getConfigDir(); protected abstract String getConfigDir();
/** /**
* 获取配置文件 * 获取配置文件对象
* *
* @return 获取配置文件类 * @return 配置文件对象
*/ */
public T getConfig() { public T getConfig() {
return config; return config;
} }
/** /**
* 加载配置文件内容 * 加载配置文件内容
*/ */
@Override @Override
public void loadConfig() { public void loadConfig() {
createConfigIfNotExists(); createConfigIfNotExists();
// 存在则加载 // 存在则加载
try { try {
logger.info("正在加载配置文件:{}...", getConfigClass()); logger.info("正在加载配置文件: {}...", getConfigClass());
String configContent = Files.readString(getConfigPath()); String configContent = Files.readString(getConfigPath());
config = JsonUtil.OBJECT_MAPPER.readValue(configContent, getConfigClass()); config = JsonUtil.OBJECT_MAPPER.readValue(configContent, getConfigClass());
} catch (IOException e) { } catch (IOException e) {
@ -79,7 +83,7 @@ public abstract class BaseConfigController<T> implements ConfigController<T> {
} }
/** /**
* 配置文件持久化 * 配置文件持久化
*/ */
@Override @Override
public void writeConfig() { public void writeConfig() {
@ -88,7 +92,7 @@ public abstract class BaseConfigController<T> implements ConfigController<T> {
} }
/** /**
* 配置文件持久化 * 配置文件持久化
* *
* @param config 配置文件对象 * @param config 配置文件对象
*/ */
@ -106,7 +110,7 @@ public abstract class BaseConfigController<T> implements ConfigController<T> {
} }
/** /**
* 如果配置文件不存在则创建 * 如果配置文件不存在则创建
*/ */
@Override @Override
public void createConfigIfNotExists() { public void createConfigIfNotExists() {
@ -122,7 +126,7 @@ public abstract class BaseConfigController<T> implements ConfigController<T> {
} }
/** /**
* 获取配置文件路径 * 获取配置文件路径
* *
* @return 配置文件路径 * @return 配置文件路径
*/ */