A-I列的数据可以定义相应个数、类型实体类字段进行获取，I列之后的动态栏位无法在同一个实体类内部定义获取。按原有4.1版本，直接使用List<String>获取动态表头，再根据动态表头List的长度使用List<Double>遍历获取表头对应列下的数据，在根据顺序将固定列数据、动态表头数据和表头列下数据组装起来即可。

按前面4.1版本的方法，代码量有点多，而且产生了二次遍历。于是新增了4.2版本，增加了获取动态栏位功能。

三、新增功能说明

1. @DynamicRank

/**
 * excel取值时，获取动态表头及本行（/列）对应表头栏位
 * 1. 注解作用于List类型字段
 * 2. titleRank表示表头所在行（/列），必填（横向表格代表行序，纵向表格表示列序）
 * 3. 从当前一直获取到最后一个表头及对应数据栏位
 * 4. 作用于实体类的最后一个字段，该字段后的其他字段将不会赋值
 * 5. enableDuplicateCheck复性检查：
 *      （1）依赖于实体类的equals方法的实现
 *      （2）会一定程度影响取值效率（看数据量），非必要不开启
 */
@Target(value = ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface DynamicRank {
    int titleRank();
    boolean enableDuplicateCheck() default false;
}

@DynamicRank注解用于获取固定栏位之后的动态栏位，兼容横向和纵向表格。该注解作用于实体类中List类型的字段上，使用该注解的字段将认为是实体类的最后一个赋值字段。为确保成功获取动态栏位的值，务必保证用于取值的字段类型为List<DTO>。

@DynamicRank包含两个参数，titleRank和enableDuplicateCheck：

（1）titleRank为数字类型，表示表头所在栏（行/列，数字序号）。被@DynamicRank注解的字段将默认获取动态表头加表头对应栏位值，需要正确提供表头所在栏。被注解List<DTO>中DTO通常只包含两个字段，表头和栏位值。在给该DTO内字段赋值时，将忽略@DynamicRank注解。

（2）enableDuplicateCheck为boolean类型，表示是否开启数据重复性检测。值为true时，如果当前获取的DTO数据与其余已获取的DTO重复时，将抛出DataDuplicationException异常。判断重复规则将在后面说明。

接收Excel数据实体：

@Data
public class Test1DTO {
    ... ...
    @DynamicRank(titleRank = 2, enableDuplicateCheck = true)
    private List<Test2DTO> dataList;
    ... ...
}

接收动态栏位实体：

@Data
public class Test2DTO {
    @ExcelDateFormat(message = "日期格式必须为yyyy/MM/dd！")
    private String arriveDate;

    @ExcelNumberFormat(format = "#", message = "数量必须为正整数！")
    private Integer arriveQty;

    // 根据业务需要自定义equals
    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj instanceof Test2DTO) {
            Test2DTO another = (Test2DTO) obj;
            return this.arriveDate.equals(another.getArriveDate());
        }
        return false;
    }
}

2. 重复性检测

4.1版本的取值方法是这样的：

4.2版本是这样的：

对比可以发现4.2版本增加了一个boolean类型参数：

加了一个默认不进行重复性检测的方法：

根据业务需要，对equals方法的重写（@Override是可以省略的，但建议保留，规范，防止拼写错误）：

@Data
public class Test1DTO {
    @NotNull(message = "A不能为空！")
    private String a;
    @NotNull(message = "B不能为空！")
    private String b;
    @NotNull(message = "C不能为空！")
    private String c;
    @NotNull(message = "D不能为空！")
    private String d;
    @NotNull(message = "E不能为空！")
    private String e;
    @NotNull(message = "F不能为空！")
    private String f;
    @ValueLimit(limit = {"value1", "value2"}, message = "G只能为value1、value2")
    @Transform(expressions = {"value1 -> 1", "value2 -> 2"})
    private Integer g;
    private String h;
    private Integer i;
    @DynamicRank(titleRank = 2, enableDuplicateCheck = true)
    private List<Test2DTO> dataList;

    // 根据业务需要自定义equals
    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj instanceof Test1DTO) {
            Test1DTO another = (Test1DTO) obj;
            return this.a.equals(another.getA())
                    && this.b.equals(another.getB())
                    && this.c.equals(another.getC())
                    && this.d.equals(another.getD())
                    && this.e.equals(another.getE())
                    && this.f.equals(another.getF())
                    && this.g.equals(another.getG());
        }
        return false;
    }
}

补充一点，由图可以看出，4.2版本将方法中的栏位数量参数cellNum拿掉了，取值个数以实体类字段数为准，所以在定DTO字段时，需明确需要获取的栏位。

3. @Transform

为满足栏位获取的值转换的需求，4.2版本新增了@Transform注解功能：

/**
 * excel取值时，指定值变化成另一个值
 * 表达式：a->b
 */
@Target(value = ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface Transform {
    String[] expressions();
}

@Transform的使用示例：

@Data
public class Test1DTO {
    ... ...
    @ValueLimit(limit = {"value1", "value2"}, message = "G只能为value1、value2")
    @Transform(expressions = {"value1 -> 1", "value2 -> 2"})
    private Integer g;
    ... ...
}