package com.battery.device.neware;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import com.battery.device.api.DeviceAdapter;
import com.battery.device.api.DeviceAdapterException;
import com.battery.device.api.model.AdapterCapabilities;
import com.battery.device.api.registry.AdapterInstanceConfig;
import com.battery.device.api.registry.DeviceAdapterFactory;
/**
* 按存储形态 {@code NEWARE_MYSQL} 构造直连厂商库的只读适配器实例。
*
*
连接口令只从环境变量或启动参数读取(变量名由实例配置的 {@code passwordEnv} 指定,
* 缺省为 {@link NewareMysqlAdapter#DEFAULT_PASSWORD_ENV}),不进数据库也不进仓库。
* 账号固定为现场取得的服务端只读账号,全权限账号不进入配置。
*/
public final class NewareMysqlAdapterFactory implements DeviceAdapterFactory
{
public static final String DATABASE_OPTION = "database";
public static final String USER_OPTION = "user";
public static final String PASSWORD_ENV_OPTION = "passwordEnv";
private static final String DEFAULT_DATABASE = "bts63";
private static final String READ_ONLY_USER = "visitor";
/** 现场已知的全权限账号;写进交付配置就等于把误写风险带进现场。 */
private static final List FULL_PRIVILEGE_USERS = List.of("btsserver", "root");
@Override
public String adapterType()
{
return NewareMysqlAdapter.ADAPTER_TYPE;
}
@Override
public DeviceAdapter create(AdapterInstanceConfig config)
{
String database = option(config.sourceConfig(), DATABASE_OPTION, DEFAULT_DATABASE);
String user = readOnlyUser(config.sourceConfig());
String password = credential(option(config.sourceConfig(), PASSWORD_ENV_OPTION,
NewareMysqlAdapter.DEFAULT_PASSWORD_ENV));
SingleConnectionVendorDataSource source = new SingleConnectionVendorDataSource(
jdbcUrl(config.host(), config.port(), database), user, password);
return NewareMysqlAdapter.create(config, source);
}
/**
* 解析厂商库账号:默认取现场取得的服务端只读账号,已知的全权限账号一律拒绝。
*
* 准入只按账号名拦已知的全权限账号(那不是"写一次就回不去"的能力),
* 真正的只读边界仍是服务端授权与语句白名单两层;这一层只是不把误配写进交付配置。
*/
static String readOnlyUser(Map sourceConfig)
{
String user = option(sourceConfig, USER_OPTION, READ_ONLY_USER);
if (FULL_PRIVILEGE_USERS.contains(user.toLowerCase(Locale.ROOT)))
throw new DeviceAdapterException("厂商数据源只允许只读账号,拒绝全权限账号:" + user);
return user;
}
/** 只读账号口令;启动参数优先于环境变量,便于本机排查而不必改环境。 */
static String credential(String variableName)
{
if (variableName == null || variableName.isBlank())
throw new DeviceAdapterException("未配置厂商库口令的取值变量名");
String value = System.getenv(variableName);
if (value == null || value.isBlank()) value = System.getProperty(variableName);
if (value == null || value.isBlank())
throw new DeviceAdapterException("缺少厂商库连接口令:请设置环境变量 " + variableName);
return value;
}
/**
* MySQL 5.5 那台不支持任何会话级只读机制,因此 URL 中不得出现 transaction_read_only
* (ADR-0062);只读由服务端账号与语句白名单两层保证。
*/
static String jdbcUrl(String host, int port, String database)
{
return "jdbc:mysql://" + host + ":" + port + "/" + database
+ "?connectTimeout=5000&socketTimeout=10000&useSSL=false&allowPublicKeyRetrieval=true"
+ "&zeroDateTimeBehavior=convertToNull&connectionTimeZone=Asia/Hong_Kong"
+ "&forceConnectionTimeZoneToSession=false";
}
private static String option(Map sourceConfig, String key, String fallback)
{
String value = sourceConfig.get(key);
return value == null || value.isBlank() ? fallback : value.trim();
}
/** 供装配层声明该形态的运行时能力:可发现、可观测实时值、只读。 */
public static AdapterCapabilities capabilities()
{
return AdapterCapabilities.observeOnly();
}
}