v15 D3 ConfigValidator SPI: Module/Severity/ValidationError/ConfigValidator/Factory + DacliValidation 加载 validation-rules.json + 37 tests (298 total)

This commit is contained in:
ssw committed 2026-06-12 10:43:42 +08:00
1 parent 309c16c716
commit 10bf91b011
11 files changed
+751

No files matched your search

@@ -0,0 +1,57 @@
package ssw.dacli.validation;
import java.util.List;
/**
* v15 L2 配置提交校验器接口.
*
* <p>每个 module (di/dm/dict/workflow) 实现 1 个 {@code ConfigValidator},
* 校验该 module 提交到 JNPF API 之前的 config 完整性和业务约束.
*
* <p>实现类要求:
* <ul>
* <li>public 无参构造 (SPI 反射调用)
* <li>{@link #module()} 返回所属 module
* <li>{@link #validate(Object)} 返回所有发现的错误 (空 List 表示校验通过)
* <li>类路径下注册到 META-INF/services/ssw.dacli.validation.ConfigValidator
* </ul>
*
* <p>调用方模式 (dacli CLI):
* <pre>{@code
* List<ValidationError> errors = ConfigValidatorFactory
* .get(Module.DM)
* .validate(dmConfig);
* if (!errors.isEmpty()) {
* errors.forEach(System.err::println);
* System.exit(2);
* }
* }</pre>
*
* <p>对照文档: {@code docs/dacli/v15-validation-schema.md} (60+ 条规则详表)
*
* @param <T> 模块配置类型 (e.g. {@code DmConfig} / {@code DiConfig} / {@code DictConfig} / {@code WorkflowConfig})
*/
public interface ConfigValidator<T> {
/** 返回所属 module (供工厂按 module 查找) */
Module module();
/**
* 校验给定配置.
*
* <p>实现要点:
* <ul>
* <li><b>必填</b> 检查 → {@link Severity#ERROR}
* <li><b>格式</b> (正则/数字范围) → {@link Severity#ERROR}
* <li><b>去重</b> (字段名/编码) → {@link Severity#ERROR}
* <li><b>引用</b> (父节点/分类) → {@link Severity#WARNING} (后端会校验)
* <li><b>拓扑</b> (BPMN 节点/连线) → {@link Severity#ERROR}
* <li><b>类型联动</b> (formType 决定 formId) → {@link Severity#ERROR}
* </ul>
*
* <p>应尽量<b>穷尽所有错误</b> (而不是发现第一个就返回), 让用户一次性看到全部.
*
* @param config 待校验配置 (非 null)
* @return 错误列表 (空 = 校验通过)
*/
List<ValidationError> validate(T config);
}
@@ -0,0 +1,66 @@
package ssw.dacli.validation;
import java.util.EnumMap;
import java.util.Map;
import java.util.ServiceLoader;
/**
* v15 ConfigValidator 工厂 (SPI 机制).
*
* <p>仿照 {@code FieldBuilderFactory} 模式: 自动扫描 classpath 下所有
* {@link ConfigValidator} 实现 (META-INF/services), 按 {@link Module} 索引.
*
* <p>反向调试器支持:
* <ul>
* <li>{@link #get(Module)} 找不到时抛 {@link UnsupportedOperationException}
* <li>{@link #isSupported(Module)} 返回是否已注册
* <li>{@link #registeredModules()} 返回所有已注册的 module (供 {@code dacli validation list} 输出)
* </ul>
*
* <p>调用示例:
* <pre>{@code
* ConfigValidator<DmConfig> v = (ConfigValidator<DmConfig>) ConfigValidatorFactory.get(Module.DM);
* List<ValidationError> errs = v.validate(dmConfig);
* }</pre>
*/
public final class ConfigValidatorFactory {
private static final Map<Module, ConfigValidator<?>> registry = new EnumMap<>(Module.class);
static {
// SPI 机制: 自动扫描 META-INF/services/ssw.dacli.validation.ConfigValidator
for (ConfigValidator<?> v : ServiceLoader.load(ConfigValidator.class)) {
registry.put(v.module(), v);
}
}
private ConfigValidatorFactory() {} // 静态工具类, 禁止实例化
/**
* 拿 module 对应的 validator.
*
* @param module 校验范围
* @return 对应 validator
* @throws UnsupportedOperationException 当 module 未注册时
*/
@SuppressWarnings("unchecked")
public static <T> ConfigValidator<T> get(Module module) {
ConfigValidator<?> v = registry.get(module);
if (v == null) {
throw new UnsupportedOperationException(
"module '" + module.code() + "' 未注册 ConfigValidator (no ConfigValidator registered). " +
"需在 validation/" + module.code() + "/" + module.code().substring(0, 1).toUpperCase() + module.code().substring(1) + "ConfigValidator.java 添加实现, " +
"并 META-INF/services/ssw.dacli.validation.ConfigValidator 追加 1 行.");
}
return (ConfigValidator<T>) v;
}
/** 是否已注册 (供反向调试用) */
public static boolean isSupported(Module module) {
return registry.containsKey(module);
}
/** 返回所有已注册的 module (供 {@code dacli validation list} 输出) */
public static java.util.List<Module> registeredModules() {
return java.util.List.copyOf(registry.keySet());
}
}
@@ -0,0 +1,175 @@
package ssw.dacli.validation;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import java.util.regex.Pattern;
import java.util.regex.PatternSyntaxException;
/**
* v15 L1 用户填写校验正则库加载器.
*
* <p>从 classpath 资源 {@code dacli/validation-rules.json} 加载 14 条 formValidate 正则
* (enCode/fullName/field/email/iphone/...) + 4 module 字段绑定, 提供静态方法
* 供 dacli 子命令 {@code @Parameters} 注解引用.
*
* <p>用法 1 (单条正则):
* <pre>{@code
* DacliValidation.PatternRule rule = DacliValidation.getRule("enCode");
* if (!rule.pattern().matcher(input).matches()) {
* throw new IllegalArgumentException(rule.message());
* }
* }</pre>
*
* <p>用法 2 (字段→正则 映射):
* <pre>{@code
* DacliValidation.PatternRule rule = DacliValidation.ruleForField("fullName");
* // 或 dm 专用
* DacliValidation.PatternRule rule = DacliValidation.ruleForDmField("newTable");
* }</pre>
*
* <p>资源路径: {@code boot/ssw-dacli/src/main/resources/dacli/validation-rules.json}
* (从 {@code web/packages/jnpf/utils/src/helpers/formValidate.ts} 抄录, 2026-06-12)
*/
public final class DacliValidation {
private static final String RESOURCE = "/dacli/validation-rules.json";
private static final Map<String, PatternRule> RULES = new HashMap<>();
private static final Map<String, PatternRule> MODULE_BINDINGS = new HashMap<>();
private static final Map<String, String> FIELD_TO_RULE = new HashMap<>();
static {
try (InputStream is = DacliValidation.class.getResourceAsStream(RESOURCE)) {
if (is == null) {
throw new IllegalStateException("资源不存在: " + RESOURCE);
}
JsonNode root = new ObjectMapper().readTree(is);
// 1. 加载 regularList
JsonNode regularList = root.path("regularList");
for (String key : iterableFieldNames(regularList)) {
JsonNode node = regularList.get(key);
String rule = node.path("rule").asText();
String msg = node.path("msg").asText();
boolean ci = node.path("caseInsensitive").asBoolean(false);
int flags = ci ? Pattern.CASE_INSENSITIVE : 0;
try {
Pattern p = Pattern.compile(rule, flags);
RULES.put(key, new PatternRule(key, p, msg, ci));
} catch (PatternSyntaxException e) {
throw new IllegalStateException("正则编译失败 " + key + ": " + rule, e);
}
}
// 2. 加载 moduleBindings (dm.table, dm.fields, workflow.templateJsonField, ...)
JsonNode bindings = root.path("moduleBindings");
for (String module : iterableFieldNames(bindings)) {
JsonNode modNode = bindings.get(module);
for (String field : iterableFieldNames(modNode)) {
JsonNode fNode = modNode.get(field);
if (fNode.isTextual()) {
// 引用 regularList 中的 key (e.g. dict.fullName = "fullName")
PatternRule ref = RULES.get(fNode.asText());
if (ref != null) {
MODULE_BINDINGS.put(module + "." + field, ref);
}
} else if (fNode.isObject()) {
// 独立定义 (e.g. dm.table 的 javaPattern/msg/useCases)
String rule = fNode.path("javaPattern").asText();
String msg = fNode.path("msg").asText();
boolean ci = fNode.path("caseInsensitive").asBoolean(false);
int flags = ci ? Pattern.CASE_INSENSITIVE : 0;
Pattern p = Pattern.compile(rule, flags);
MODULE_BINDINGS.put(module + "." + field, new PatternRule(field, p, msg, ci));
}
}
}
// 3. 加载 fieldToRegexMap (字段→正则 key 简表)
JsonNode fieldMap = root.path("fieldToRegexMap");
for (String field : iterableFieldNames(fieldMap)) {
FIELD_TO_RULE.put(field, fieldMap.get(field).asText());
}
} catch (IOException e) {
throw new IllegalStateException("Failed to load " + RESOURCE, e);
}
}
private DacliValidation() {} // 静态工具类, 禁止实例化
/** 取 regularList 中的规则 (e.g. "enCode" / "iphone") */
public static PatternRule getRule(String key) {
PatternRule r = RULES.get(key);
if (r == null) {
throw new IllegalArgumentException("Unknown validation rule: " + key);
}
return r;
}
/** 取 module 字段绑定的规则 (e.g. "dm.table" / "workflow.templateJsonField") */
public static PatternRule getModuleBinding(String module, String field) {
PatternRule r = MODULE_BINDINGS.get(module + "." + field);
if (r == null) {
throw new IllegalArgumentException("Unknown module binding: " + module + "." + field);
}
return r;
}
/** 通用字段→正则 映射 (e.g. "fullName" → "fullName", "newTable" → "dm.table") */
public static PatternRule ruleForField(String fieldName) {
String key = FIELD_TO_RULE.get(fieldName);
if (key == null) {
throw new IllegalArgumentException("Unknown field: " + fieldName);
}
// key 可能是 regularList key (e.g. "fullName") 或 module binding (e.g. "dm.table")
PatternRule r = RULES.get(key);
if (r == null && key.contains(".")) {
String[] parts = key.split("\\.", 2);
r = MODULE_BINDINGS.get(key);
}
if (r == null) {
throw new IllegalArgumentException("Field '" + fieldName + "' mapped to '" + key + "' but rule not found");
}
return r;
}
/** 校验单个值, 不匹配时抛 {@link IllegalArgumentException} */
public static void validate(String ruleKey, String value) {
PatternRule r = getRule(ruleKey);
if (value == null || value.isEmpty()) {
return; // 必填是 L2 校验, L1 不查空
}
if (!r.pattern().matcher(value).matches()) {
throw new IllegalArgumentException(r.message());
}
}
/** 返回已加载的规则数 (供测试验证) */
public static int ruleCount() {
return RULES.size();
}
/** 返回已加载的 module 绑定数 (供测试验证) */
public static int moduleBindingCount() {
return MODULE_BINDINGS.size();
}
private static Iterable<String> iterableFieldNames(JsonNode obj) {
java.util.List<String> names = new java.util.ArrayList<>();
obj.fieldNames().forEachRemaining(names::add);
return names;
}
/**
* 单条正则规则不可变记录.
*/
public record PatternRule(String key, Pattern pattern, String message, boolean caseInsensitive) {
public boolean matches(String value) {
return value != null && pattern.matcher(value).matches();
}
}
}
@@ -0,0 +1,41 @@
package ssw.dacli.validation;
/**
* v15 4 module 校验范围 (di/dm/dict/workflow).
*
* <p>每个 module 对应 1 个 {@link ConfigValidator} 实现.
*
* @see ConfigValidator#module()
*/
public enum Module {
/** 数据接口 (JNPF /api/visualdev/DataInterface) */
DI("di"),
/** 数据模型 (JNPF /api/system/DataModel) */
DM("dm"),
/** 字典 (JNPF /api/system/DictionaryType + DictionaryData) */
DICT("dict"),
/** 工作流 (JNPF /api/workflow/Engine) */
WORKFLOW("workflow");
private final String code;
Module(String code) {
this.code = code;
}
/** 模块短码, 供命令行 / JSON 序列化使用 (e.g. "di" / "dm") */
public String code() {
return code;
}
/** 从短码反查枚举 (大小写不敏感) */
public static Module fromCode(String code) {
if (code == null) {
throw new IllegalArgumentException("module code 不能为 null");
}
for (Module m : values()) {
if (m.code.equalsIgnoreCase(code)) return m;
}
throw new IllegalArgumentException("Unknown module code: " + code);
}
}
@@ -0,0 +1,12 @@
package ssw.dacli.validation;
/**
* v15 校验错误严重度.
*
* <p>ERROR — 必填/必传缺失, 必须修才能提交 (后端 API 必返 400)
* <p>WARNING — 业务约束, 可提交但可能功能异常 (e.g. enCode 唯一性)
*/
public enum Severity {
ERROR,
WARNING
}
@@ -0,0 +1,53 @@
package ssw.dacli.validation;
/**
* v15 单条校验错误的不可变记录.
*
* <p>由 {@link ConfigValidator#validate} 返回. dacli CLI 在调用 JNPF API 之前
* 收集所有错误, 一并打印给用户 (而不是提交后才发现).
*
* <p>字段对应 {@code docs/dacli/v15-validation-schema.md} §1-§5 表格的 5 列:
* <ul>
* <li>{@code code} — 规则编号 (e.g. "dm-L2-1", "wf-L2-37")
* <li>{@code message} — 人类可读错误消息 (中文, 跟 web 端 createMessage.error 输出一致)
* <li>{@code field} — 字段路径 (e.g. "fields[0].dataLength", "nodes[3].formId")
* <li>{@code severity} — 严重度
* <li>{@code module} — 所属 module (di/dm/dict/workflow)
* </ul>
*
* <p>示例:
* <pre>{@code
* new ValidationError("dm-L2-1", Module.DM, "请至少添加一个字段", "fields", Severity.ERROR)
* }</pre>
*/
public record ValidationError(
String code,
Module module,
String message,
String field,
Severity severity
) {
/** 简化构造 (module 自动从 code 前缀推断) */
public ValidationError(String code, String message, String field, Severity severity) {
this(code, inferModule(code), message, field, severity);
}
/** 从 code 前缀 (e.g. "dm-L2-3") 推断 module (dm) */
private static Module inferModule(String code) {
if (code == null) return null;
String prefix = code.split("-")[0].toLowerCase();
return switch (prefix) {
case "di" -> Module.DI;
case "dm" -> Module.DM;
case "dict" -> Module.DICT;
case "wf" -> Module.WORKFLOW;
default -> null;
};
}
@Override
public String toString() {
return String.format("[%s] %s.%s: %s (%s)",
severity, module.code(), field, message, code);
}
}
@@ -0,0 +1,41 @@
package ssw.dacli.validation;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
/**
* v15 D3 — ConfigValidatorFactory SPI 注册测试.
*
* <p>v15 启动时 (D3 阶段) 4 module 都没有注册 validator, 工厂应抛
* {@link UnsupportedOperationException} 并提示需在指定路径添加实现.
*/
public class ConfigValidatorFactoryTest {
@Test
public void testRegisteredModules_emptyAtD3() {
// D3 阶段 4 module 都未注册 (D4-D7 才会实现)
// 此断言反映"未实现"现状, D4 实现 DmConfigValidator 后此断言需更新
assertEquals(0, ConfigValidatorFactory.registeredModules().size(),
"D3 阶段 4 module 都未注册, D4+ 才会逐个实现");
}
@Test
public void testGet_unregistered_throwsHelpfulError() {
UnsupportedOperationException ex = assertThrows(UnsupportedOperationException.class,
() -> ConfigValidatorFactory.get(Module.DM));
// 错误消息应提示开发者如何实现
assertTrue(ex.getMessage().contains("dm"), "错误消息应包含 module 短码");
assertTrue(ex.getMessage().contains("ConfigValidator"), "错误消息应提示需注册 ConfigValidator");
assertTrue(ex.getMessage().contains("META-INF/services"),
"错误消息应提示 SPI 注册路径");
}
@Test
public void testIsSupported_unregistered() {
assertFalse(ConfigValidatorFactory.isSupported(Module.DI));
assertFalse(ConfigValidatorFactory.isSupported(Module.DM));
assertFalse(ConfigValidatorFactory.isSupported(Module.DICT));
assertFalse(ConfigValidatorFactory.isSupported(Module.WORKFLOW));
}
}
@@ -0,0 +1,213 @@
package ssw.dacli.validation;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
/**
* v15 D3 — DacliValidation 单元测试 (验证 validation-rules.json 加载与正则应用).
*
* <p>覆盖 14 条 regularList + 4 module 字段绑定 + 字段映射表.
*/
public class DacliValidationTest {
@Test
public void testRulesLoaded_14() {
// 14 条 formValidate 正则全部加载
assertEquals(14, DacliValidation.ruleCount(),
"期望 14 条 regularList, 实际 " + DacliValidation.ruleCount());
}
@Test
public void testEnCode_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("enCode");
assertTrue(r.matches("userInfo")); // camelCase 允许
assertTrue(r.matches("orderInfo2024")); // 含数字允许
assertTrue(r.matches("sys.dept")); // 允许小数点
assertTrue(r.matches("DataX")); // 大小写不敏感
assertTrue(r.matches("a.b.c.d")); // 多段小数点
}
@Test
public void testEnCode_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("enCode");
assertFalse(r.matches(".user"), "首尾不能是小数点");
assertFalse(r.matches("user."), "首尾不能是小数点");
assertFalse(r.matches("用户"), "不允许中文");
assertFalse(r.matches("user_info"), "不允许下划线 (formValidate 严格模式)");
assertFalse(r.matches("user-info"), "不允许连字符");
}
@Test
public void testFullName_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("fullName");
assertTrue(r.matches("用户管理"));
assertTrue(r.matches("OrderInfo2024"));
assertTrue(r.matches("数据字典1"));
}
@Test
public void testFullName_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("fullName");
assertFalse(r.matches("user-info"), "连字符不允许");
assertFalse(r.matches("订单 管理"), "空格不允许");
}
@Test
public void testIphone_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("iphone");
assertTrue(r.matches("13800138000"));
assertTrue(r.matches("19912345678"));
}
@Test
public void testIphone_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("iphone");
assertFalse(r.matches("12800138000"), "12x 开头不允许");
assertFalse(r.matches("1380013800"), "11 位");
assertFalse(r.matches("138001380000"), "12 位");
}
@Test
public void testEmail_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("email");
assertTrue(r.matches("[email protected]"));
assertTrue(r.matches("[email protected]")); // 多个小数点 (local + domain)
}
@Test
public void testEmail_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("email");
assertFalse(r.matches("[email protected]"), "+ 不允许 (formValidate 严格模式)");
assertFalse(r.matches("plainaddress"));
}
@Test
public void testBigInt_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("bigInt");
assertTrue(r.matches("1"));
assertTrue(r.matches("99999"));
}
@Test
public void testBigInt_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("bigInt");
assertFalse(r.matches("0"), "0 不是正整数");
assertFalse(r.matches("-1"), "负数不允许");
assertFalse(r.matches("1.5"), "小数不允许");
}
@Test
public void testIdCard_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("idCard");
assertTrue(r.matches("11010119900307891X")); // 18 位 + X 结尾
assertTrue(r.matches("110101199003078910"));
}
@Test
public void testPlateNumber_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("plateNumber");
assertTrue(r.matches("京A12345"));
assertTrue(r.matches("沪B5678挂"));
}
@Test
public void testField_valid() {
DacliValidation.PatternRule r = DacliValidation.getRule("field");
assertTrue(r.matches("f_name"));
assertTrue(r.matches("f_order_id_2024"));
}
@Test
public void testField_invalid() {
DacliValidation.PatternRule r = DacliValidation.getRule("field");
assertFalse(r.matches("1abc"), "数字开头不允许");
assertFalse(r.matches("_abc"), "下划线开头不允许");
}
@Test
public void testValidate_method() {
// 正常情况
DacliValidation.validate("enCode", "userInfo"); // 不抛 (camelCase)
DacliValidation.validate("iphone", "13800138000"); // 不抛
// 失败情况
assertThrows(IllegalArgumentException.class,
() -> DacliValidation.validate("enCode", ".bad"));
}
@Test
public void testModuleBindings_loaded() {
// 4 module × 多字段
assertTrue(DacliValidation.moduleBindingCount() >= 7,
"期望 ≥ 7 条 module 绑定, 实际 " + DacliValidation.moduleBindingCount());
}
@Test
public void testDmTable_moduleBinding() {
// dm.table 走独立定义 (大写+下划线+字母开头)
DacliValidation.PatternRule r = DacliValidation.getModuleBinding("dm", "table");
assertTrue(r.matches("TDS_X"));
assertTrue(r.matches("TDS_ORDER_2024"));
assertFalse(r.matches("tds_x"), "小写不允许");
assertFalse(r.matches("1TDS"), "数字开头不允许");
}
@Test
public void testDmFields_moduleBinding() {
// dm.fields (字段名) 走 formValidate 'field' (小写+下划线+字母开头)
DacliValidation.PatternRule r = DacliValidation.getModuleBinding("dm", "fields");
assertTrue(r.matches("f_name"));
assertFalse(r.matches("F_NAME"), "大写不允许");
}
@Test
public void testDmDataLengthDecimal_moduleBinding() {
// decimal 类型的 dataLength (数字+逗号)
DacliValidation.PatternRule r = DacliValidation.getModuleBinding("dm", "dataLengthDecimal");
assertTrue(r.matches("10"));
assertTrue(r.matches("10,2"));
assertTrue(r.matches("18,4"));
assertFalse(r.matches("10.2"), "点不允许");
assertFalse(r.matches("abc"), "字母不允许");
}
@Test
public void testWorkflowTemplateJsonField_moduleBinding() {
// workflow.templateJsonField (BPMN 字段 key, 字母数字下划线+字母开头)
DacliValidation.PatternRule r = DacliValidation.getModuleBinding("workflow", "templateJsonField");
assertTrue(r.matches("f_name"));
assertTrue(r.matches("OrderId"));
assertFalse(r.matches("1abc"), "数字开头不允许");
assertFalse(r.matches("user-info"), "连字符不允许");
}
@Test
public void testFieldToRuleMap_fullName() {
// 通用字段映射: "fullName" → "fullName" (regularList)
DacliValidation.PatternRule r = DacliValidation.ruleForField("fullName");
assertTrue(r.matches("用户管理"));
}
@Test
public void testFieldToRuleMap_newTable() {
// 通用字段映射: "newTable" → "dm.table" (module binding)
DacliValidation.PatternRule r = DacliValidation.ruleForField("newTable");
assertTrue(r.matches("TDS_X"));
}
@Test
public void testFieldToRuleMap_unknown() {
assertThrows(IllegalArgumentException.class,
() -> DacliValidation.ruleForField("nonExistentField"));
}
@Test
public void testCaseInsensitive_enCode() {
// enCode 应大小写不敏感 (caseInsensitive=true)
DacliValidation.PatternRule r = DacliValidation.getRule("enCode");
assertTrue(r.caseInsensitive());
assertTrue(r.matches("USERINFO"));
assertTrue(r.matches("Sys.Dept"));
}
}
@@ -0,0 +1,44 @@
package ssw.dacli.validation;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
/**
* v15 D3 — Module enum 单元测试.
*/
public class ModuleTest {
@Test
public void testModuleCount_4() {
assertEquals(4, Module.values().length, "4 module: di/dm/dict/workflow");
}
@Test
public void testModuleCode() {
assertEquals("di", Module.DI.code());
assertEquals("dm", Module.DM.code());
assertEquals("dict", Module.DICT.code());
assertEquals("workflow", Module.WORKFLOW.code());
}
@Test
public void testFromCode_valid() {
assertEquals(Module.DI, Module.fromCode("di"));
assertEquals(Module.DM, Module.fromCode("dm"));
assertEquals(Module.DICT, Module.fromCode("dict"));
assertEquals(Module.WORKFLOW, Module.fromCode("workflow"));
}
@Test
public void testFromCode_caseInsensitive() {
assertEquals(Module.DI, Module.fromCode("DI"));
assertEquals(Module.WORKFLOW, Module.fromCode("WORKFLOW"));
}
@Test
public void testFromCode_invalid() {
assertThrows(IllegalArgumentException.class, () -> Module.fromCode("unknown"));
assertThrows(IllegalArgumentException.class, () -> Module.fromCode(null));
}
}
@@ -0,0 +1,49 @@
package ssw.dacli.validation;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
/**
* v15 D3 — ValidationError 记录单元测试.
*/
public class ValidationErrorTest {
@Test
public void testRecord_basic() {
ValidationError e = new ValidationError("dm-L2-1", Module.DM,
"请至少添加一个字段", "fields", Severity.ERROR);
assertEquals("dm-L2-1", e.code());
assertEquals(Module.DM, e.module());
assertEquals("请至少添加一个字段", e.message());
assertEquals("fields", e.field());
assertEquals(Severity.ERROR, e.severity());
}
@Test
public void testRecord_autoInferModule() {
// 不传 module, 从 code 前缀推断
ValidationError e = new ValidationError("wf-L2-37", "选择分支节点至少设置2条分支",
"nodes[0].outgoing", Severity.ERROR);
assertEquals(Module.WORKFLOW, e.module());
}
@Test
public void testRecord_toString() {
ValidationError e = new ValidationError("dm-L2-3", Module.DM,
"第1行列名不能为空", "fields[0].field", Severity.ERROR);
String str = e.toString();
assertTrue(str.contains("dm-L2-3"));
assertTrue(str.contains("第1行列名不能为空"));
assertTrue(str.contains("ERROR"));
}
@Test
public void testRecord_inferAllModules() {
// 4 module 全部推断
assertEquals(Module.DI, new ValidationError("di-L2-1", "x", "y", Severity.ERROR).module());
assertEquals(Module.DM, new ValidationError("dm-L2-1", "x", "y", Severity.ERROR).module());
assertEquals(Module.DICT, new ValidationError("dict-L2-1", "x", "y", Severity.ERROR).module());
assertEquals(Module.WORKFLOW, new ValidationError("wf-L2-1", "x", "y", Severity.ERROR).module());
}
}