使用Easy-POI导入复杂表头的Excel报表（含源码级分析）

本文旨在解决使用Easy-POI导入复杂表头（导出）时，遇上的EXCEL文件中的字段无法正常映射到Bean的问题,官方的示例和其他的CSDN文章基本上没有很详细的教程，于是自己写一个

这是需要导入的表结构：

这是结构中需要在ImportParams中声明的术语：

在导入的时候，必须通过ImportParams params = new ImportParams()对象设置表的基本结构，如果有标题，就要params.setTitleRows(1)设置忽略的行，标题占1行就设置1，占n行就设置n，这个很容易

需要特别注意的是headRows，这里需要设置的是表头行的行数，默认情况下为1，但如果使用的是复杂表头，则表头占的行数就不是1了，比如示例中的表头一样，b分组下有c和d，e分组下也有c和d（严格上来说是b分组下只有c，e分组下也只有c，下面我会说原因）,表头显然占了2行（别纠结a字段貌似只占了一行！实际肯定是要以最大为主。而且最左边列的数字也能看出占了2行，以最左边的数字为准就行了！），最后params.setHeadRows(2)搞定！

然后Excel的数据导入就能正确解析了，看看解析成什么样子？

下面要讲解Bean的解析了，要让Excel正确生成Bean，显然Excel上是没法下功夫的，因为Excel都是客户给的需求，已经是硬性规定了，只能在Bean上下功夫，来看看Bean是怎样的

这是第一版的Bean

这里有人会问我为什么不给d属性和g属性加groupName属性吗？这里我有必要加吗？groupName属性的作用就是把Bean中的c变成b_c，e_c，使之上面的titleMap的字段相对应，上面的d字段并没有被解析成b_d,e_d，加了反而映射不上。因为easypoi认为，虽然b字段占了1,2两列，但他在归属上任然只算列数1，所以解析的时候只会处理同为列数1的c字段并合并为b_c，列数2的d字段已经是独立的字段了，并不会处理成b_d，e字段也是同理。然后看看结果如何。。。

看看Bean中解析出的属性有没有问题

原理：

大致过程如下：
遍历真实数据行备用；
遍历Excel中解析出的字段集合titleMap并获得对应的列数与字段名 ------> 根据集合中的字段名称获取Bean中解析出的ExcelImportEntity对象 ------> 拿出ExcelImportEntity对象中早以准备好的set方法对象，然后new出来的bean，依据titleMap中的列数和真实数据行获取的真实数据--------->填充Bean的其中一个属性

也就是说，案例中Bean的属性G会通过ExcelImportEntity中的setG方法重复设置2次，由于属性G对应的d字段是最后一个字段，属性G也是@Excel中name为d的最后一个属性（这点可以保证，因为生成ExcelImportEntity集合的excelParams也是通过循环的方式，所以不会出现4个ExcelImportEntity对象中setG方法的对象被setD方法覆盖），所以覆盖到最后，值总是对的

分析完原因之后，解决的方案很简单，通过fixIndex解决@Excel中name重名问题：

看看加完以后bean的属性集合变成什么样。。。

bean的映射集中原来缺失的d属性的映射集多了一个FIXED_2

接下来就容易多了，只要读取要字段开头为“FIX_”开头的Bean属性映射集，直接获取列数，通过列数(titleMap中的key）获取对应的真实数据即可，不需在通过Excel中的列名（titleMap中的value）获取，完成！

深入

这个更复杂的表现在应该会了吧

先在导入参数中设置好标题行数和表头行数，上表中标题占了1行，表头占了3行

然后配置好Bean类中的注解，需要注意一下，像f属性所映射的c字段这种有多个复杂表头匹配的项x2和b字段同时重合，直接a字段_b字段_…就行

最后结果：

如果复杂表头下的子字段名称都是不一样的怎么办？那更简单，连fixIndex都可以省略了。
如果需要单独一个实体类映射复杂表头直接@ExcelEntity就行，毕竟举例中出现字段名相同的情况才是最难的情况，其他的都是简单情况