支持重复注解（如@FieldMapping）可为同一字段绑定多组Excel列映射规则，解析时按strategy优先或column匹配，适配多种表头结构。
在表格批量导入时，用可重复注解（如 Java 中的 @FieldMapping）绑定多个字段映射规则，核心在于让注解支持多次声明，并在解析时按顺序或条件匹配对应列。这比单次注解更灵活，适合同一实体类需适配多种 Excel 表头结构的场景。
确保注解声明为可重复
Java 8+ 支持重复注解，需两步配置：
- 定义容器注解（如
@FieldMappings），其value()返回目标注解数组 - 为目标注解添加
@Repeatable(FieldMappings.class)
示例：
@Repeatable(FieldMappings.class)
public @interface FieldMapping {
String column(); // Excel 列名或序号，如 "姓名" 或 "A"
String strategy() default "default"; // 可选策略标识，用于区分规则
boolean required() default false;
}
public @interface FieldMappings {
FieldMapping[] value();
}
在实体字段上声明多组映射规则
一个字段可标注多个 @FieldMapping，覆盖不同导入模板的需求：
public class User {
@FieldMapping(column = "姓名", strategy = "chinese_v1")
@FieldMapping(column = "name", strategy = "english_v2")
@FieldMapping(column = "real_name", strategy = "db_export")
private String name;
@FieldMapping(column = "注册时间")
@FieldMapping(column = "create_time", strategy = "timestamp")
private LocalDateTime createTime;
}
这样，解析器可根据当前 Excel 的表头或导入策略（如通过文件名、元数据识别模板版本），选择匹配的那条规则。
解析器按需匹配并绑定字段
读取 Excel 后，遍历每列标题，对每个实体字段检查其所有 @FieldMapping 注解：
- 若指定了
strategy，优先匹配该策略下的规则 - 否则，逐个比对
column值是否与当前列名/列索引一致 - 找到第一个匹配项即停止，避免歧义（也可设计为“最精确匹配”，如支持通配符或正则）
关键逻辑片段（伪代码）：
for (CellHeader header : sheetHeaders) {
for (Field field : entityClass.getDeclaredFields()) {
FieldMapping[] mappings = field.getAnnotationsByType(FieldMapping.class);
for (FieldMapping mapping : mappings) {
if (matchesStrategy(mapping, currentStrategy)
&& header.equals(mapping.column())) {
bind(header, field, rowValue);
break;
}
}
}
}
扩展建议：结合模板标识动态加载规则
实际项目中，可将策略名（strategy）与 Excel 模板 ID 关联，例如：
- 模板 A（v1.0）→ 使用
strategy = "v1"的规则 - 模板 B（v2.0）→ 使用
strategy = "v2"的规则
导入前先读取 Excel 元数据（如自定义属性、sheet 名称、首行备注），确定模板类型，再统一应用对应策略。这样既保持代码简洁，又支持长期演进的字段兼容性。
