DataAssembler通过反射实现通用数据动态组装：先扫描标记字段，按@DataRef/@DataField优先级注入值，经宽容型类型转换器适配后安全赋值，支持SPI数据源、可注册转换器和后置处理器链扩展。
要用反射解析注解实现一个通用的数据动态组装器，核心是把“字段标记 → 运行时读取 → 类型适配 → 值注入”这四个环节串起来，而不是堆砌框架逻辑。低代码平台最怕硬编码和强约定，所以组装器必须做到：不依赖具体类结构、支持任意 POJO、可扩展类型转换、失败有明确提示。
一、定义面向低代码的轻量注解
注解要简洁、语义清晰，避免 Spring 风格的复杂属性。例如：
@DataField 用于标记需动态填充的字段；@DataRef 用于标记需关联外部数据源的字段（如从配置中心、API 或缓存查值）。
示例定义：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface DataField {
String key() default ""; // 对应配置项 key，如 "user.name"
String defaultValue() default ""; // 默认值，支持空字符串、"null"、"true" 等
boolean required() default false;
}
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface DataRef {
String source() default "config"; // 来源：config / api / cache
String path() default ""; // 路径表达式，如 "auth.token" 或 "/user/profile"
}
关键点：只保留运行时必需的元信息；不强制 value() 方法，避免使用时语法歧义；用 source 和 path 解耦数据来源与路径，方便后续插拔不同数据源。
二、组装器主逻辑：反射驱动的三步注入
组装器命名为 DataAssembler，接收任意目标对象实例，完成字段赋值。它不创建对象，只做“填空”——符合低代码场景中对象已由表单/流程引擎构造好的前提。
-
扫描字段：用
clazz.getDeclaredFields()获取全部字段（含 private），跳过 static/final 字段 -
识别策略：按优先级处理 —— 先找
@DataRef（需远程获取），再找@DataField（查本地配置或默认值），两者都不匹配则跳过 -
安全赋值：对每个匹配字段调用
field.setAccessible(true)，再调用field.set(target, value)；异常统一包装为DataAssemblyException，附带字段名、注解类型、原始异常原因
三、类型转换：面向低代码的宽容型转换器
低代码用户不写 Java 类型，输入多为字符串。转换器需覆盖常见类型，并主动处理边界情况：
- String → String：原样返回（支持空串）
- String → Boolean：识别
"true"/"false"、"1"/"0"、"yes"/"no"（忽略大小写） - String → Number：先尝试
Long.parseLong()，失败再试Double.parseDouble()，最后 fallback 到BigDecimal - String → Date：支持 ISO8601（
"2025-04-12T10:30:00Z"）、常见中文格式（"2025年04月12日"）、时间戳（13 位毫秒数） - String → Enum：按枚举类的
name()或toString()匹配，不区分大小写 - 未覆盖类型：记录 warn 日志，保留 null，不中断整体组装
转换逻辑封装为独立方法 convert(String raw, Class<?> targetType)，便于单元测试和替换。
四、扩展性设计：让平台能“长出新能力”
低代码平台演进快，组装器不能写死逻辑。预留三个扩展点：
-
数据源 SPI：定义
DataSource接口，含fetch(String path)方法；内置ConfigDataSource（读 properties/yaml）、ApiDataSource（HTTP 调用）、CacheDataSource（查本地缓存）；平台可通过 SPI 加载自定义实现 -
转换器注册表：用
Map<Class<?>, Converter>存储类型转换器，支持运行时register(Class<T> type, Converter<T> converter) -
后置处理器链：组装完成后触发
PostProcessor列表，可用于审计日志、敏感字段脱敏、业务校验等，按 order 排序执行
这样，当平台新增“从数据库查用户角色”需求时，只需实现一个 DbRoleDataSource 并注册，无需修改组装器主逻辑。
