轻松完成excel读写操作- 基于POI的框架BingExcel的使用(2)

在进行 类转换时候，系统默认注册了一些转换器，当然你也可以自定局部或者全局的转换器。下面进行具体使用说明 

1. java类说明 对应的java实体类，其属性必须要有__@CellConfig__注解，此注解必须的值为index属性，起始值是0；如果你要限定实体类的某一个属性必须有值的话，可以这样定义：

@CellConfig(index = 0,readRequired=true)
private String a;

一旦你加上了 readRequired 这个属性，当你的excel对应属性不存在时候，就会抛出异常illegalValueException ；如果你想在属性不存在时候做一些其他业务逻辑，那你不应该加上 readRequired 这个属性，而是自己去定义一个这个属性的转换器（在后面会讲到转化器的定义）。
当然你也会有需求，比如我确实需要定义一个属性，他在excel中确实不存在。那么你可以把这个属性定义为transient 的：

//与excel不对应的属性。
private transient String test;

另外关键的操作类是 BingExcel ,这个类必须由 BingExcelBuilder 来构建（补充一点：因为不可能在转换中将一个百万级的数据直接转换到内存中list对象，这里也提供了 BingExcelEvent 来进行大数据的读取）

2. 自定义转化器

属性的转换是靠默认的转化器（ FieldValueConverter ）来进行的，默认的转换器包括数组，列表（List）,枚举等。如下面例子： 

员工表-salary.xlsx（可以从 这里下载）,里面有个字段-部门，在java中是个枚举对象；另外里面还有一些日期字段（入职时间等），但是是用字符串形式存储的日期，这样自定义的转换器就不能去处理了。

public class Salary {

        @CellConfig(index = 1)
        private String employNum;

        @CellConfig(index = 0)
        private String id;

                //默认的boolean类型只支持"TRUE", "FALSE"字符的转换，但是它自带了传参数的构造方法，具体可以参考源码，
        @CellConfig(index = 8)
        @BingConvertor(value = BooleanFieldConverter.class, strings = { "1","0" }, booleans = { false })
        private boolean allDay;

        @CellConfig(index=7)
        private Department department;//枚举类型

                @CellConfig(index = 13)
        @BingConvertor(DateTestConverter.class)
        // 自定义转换器
        private Date atypiaDate;

        @CellConfig(index = 14)
        private Date entryTime;//用默认的转换器

        // 与excel无对应关系的属性定义
        private transient String test;

        public String toString() {
            return MoreObjects.toStringHelper(this.getClass()).omitNullValues()
                    .add("id", id).add("employNum", employNum)
                    .add("allDay", allDay)
                    .add("atypiaDate", atypiaDate)
                    .add("department", department)
                    .add("entryTime", entryTime).toString();
        }
        //省略了 getter与setter方法。
    }

部门枚举的定义：当然你可以把他定义到 Salary 中，作为一个内部类

enum Department {
        develop, personnel, product;
    }

定义自己的日期转换器，可以通过实现 FieldValueConverter 或者继承 AbstractFieldConvertor

public class DateTestConverter extends AbstractFieldConvertor {

        @Override
        public boolean canConvert(Class<?> clz) {
            return clz.equals(Date.class);
        }
        @Override
        public Object fromString(String cell, ConverterHandler converterHandler,Type type)       {

            if (StringUtils.isBlank(cell)) {
                return null;
            }
            try {

                SimpleDateFormat format=new SimpleDateFormat("yyyy.MM.dd");
                Date date = format.parse(cell);
                return date;
            } catch (ParseException e) {
                throw new RuntimeException(e);
            }
        }

    }

然后，你就可以进行读入了：

 URL url = Salary.class.getResource("/salary.xlsx");
        File f = new File(url.toURI());

        BingExcel bing = BingExcelBuilder.toBuilder().builder();
        try {
            SheetVo<Salary> vo = bing.readFile(f, Salary.class, 1);
            System.out.println(vo.getSheetIndex());
            System.out.println(vo.getSheetName());
            List<Salary> objectList = vo.getObjectList();
            for (Salary salary : objectList) {
                System.out.println(salary);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

对于 BingExcel 类，它有多个方法：具体可以查相关api或者代码。

 /**
      * 读取所condition 对应 sheet表格，到SheetVo

     */

<T> SheetVo<T> readFile(File file, ReaderCondition<T> condition) throws Exception ;
 /**
      * 读取所condition 对应 sheet表格，到list
     * @param file
     * @param conditions 每个表格对应的condition，注：对于返回的条数，取conditions中 endNum的最小值
     * @return sheetVo的list对象，如果没有符合conditions的结果，返回empetyList对象
     * @throws Exception
     */
 List<SheetVo> readFileToList(File file,ReaderCondition[] conditions) throws Exception ;

其中 ReaderCondition 提供了更为精细的读取控制。

更多内容可以关注：项目地址https://git.oschina.net/bingyulei007/bingExcel，也可以去项目页留言。提出宝贵的改进意见