excel 通用导入

通用的POI导入Excel解决方案
引言：在项目中，经常免不了要导入、导出Excel，导出Excel稍微简单点，制作一张模板，然后将查询之后的数据写入到模板中即可，导出程序可以做到一次写好，基本上就可以通用。

但导入Excel相对麻烦点，一般情况下，导入的程序无法通用的主要原因是：对于不同的导入模板，字段field与单元格cellRef的映射关系是不相同的，这就导致对每一个导入模板都要去写一套相似的代码；我们应该想办法解决这个问题，减少每次导入Excel时都去拷贝粘贴相同的代码。

问题的关键是解决：字段field与单元格cellRef的映射关系；

如何解决呢？将这个映射关系从程序中抽取出来。

如何抽取呢？曾经跟一些同事、朋友聊天时谈到这个话题，

有的建议将这个映射关系写在Excel单元格里面，并且设置将单元格隐藏；

有的建议用2个相似的excel模板文件，将映射关系放在A模板文件中，B模板文件提供给用户导入数据；

有的建议将映射关系单独写在xml文件中；。。。。

经过再三权衡，最终我选择使用方法3，即将映射关系写在XML配置文件中。

通常情况下，我们的导入模板是大致为这样的：


（1） 有颜色的单元格是需要被导入到后台的有用信息，且单元格中的单词即为field信息

（2） 橙色单元格为只填写/读取一次的数据。

（3） 蓝色单元格为循环填写/读取的数据，A10单元格中，End表示读取到这里时，循环结束。

所以我们字段field与单元格cellRef映射信息可以是这样子的：

<?xml version="1.0" encoding="UTF-8"?>

<excelImport>

<onceImport>

<![CDATA[

C3 = ORDER_NBR, H3 = CUST_NAME,

N3 = CUST_LINK_INFO, C4 = CUST_ID,

H4 = CUST_ADDR, N4 = ONCE_TYPE,

C5 = CONTACT_ID, H5 = CUST_FILE,

N5 = LOOP_TYPE, C6 = PRO_NAME,

H6 = OPPO_ORDER_NBR, N6 = COOPERATE_MODE,

C11 = AUD_MANGER, N11 = BM,

C12 = ORDER_COMMENT

]]>

</onceImport>

<repeatImport>

<![CDATA[

A9 = STRNUM, B9 = FRI_AREA,

C9 = OPP_A, D9 = SEC_AREA,

E9 = OPP_B, F9 = NUM,

G9 = SERV_NBR, H9 = SPEED,

I9 = FRI_ADDR, J9 = PORT_TYPE_A,

K9 = FRI_LINK_A, L9 = SEC_ADDR,

M9 = PORT_TYPE_B, N9 = FRI_LINK_B,

O9 = APPLY_INFO, P9 = ORDER_DATE,

Q9 = HIRE_TIME, R9 = DISCOUNT_MID,

S9 = BILL_DATE, T9 = OLD_BILL_DATE,

U9 = LINE_COMMENT

]]>

<endCode>End</endCode>

</repeatImport>

</excelImport>


（1） <onceImport/> 表示只需要一次导入的数据，字段field与单元格cellRef的映射关系写在CDATA区中。

（2） <repeatImport/>表示需要循环导入的数据，字段field与单元格cellRef的映射关系写在CDATA区中。<endCode/>表示循环终止的字符。

下面说一下，根据这个XML描述文件，我们需要从Excel中解析出什么样的数据格式来：

/**

* 读取导入的Excel的内容

* 模板要求：

* （1）开始重复行与End行 有且只能有 一空行

*/

public class ExcelImportUtil

{

/**

* 读取导入的Excel的文件内容

* @param xmlFile 描述被导入的Excel的格式的XML文件

* @param importExcelStream 被导入的XML文件

* @return Excel中需要导入的数据

*/

public static ExcelData readExcel(String xmlFile, InputStream importExcelStream) throws ExcelImportException

{}

}

/**

* Excel导入的信息

*/

import java.util.List;

import java.util.Map;

public class ExcelData

{

// 一次导入的数据，key就是field，一个ImportCellDesc描述了一个单元格（field,value,单元格名称）

private Map<String, ImportCellDesc> onceData;

// 重复导入的数据

private List<Map<String, ImportCellDesc>> repeatData;

// setter/getter

}

/**

* 单元格的描述信息

* （1）数据格式校验时，可以精确定位到某个单元格。

*/

public class ImportCellDesc

{

/**

* 引用的单元格；如：A3

*/

private String cellRef;

/**

* 单元格的对应数据库的字段名称；

* 如：fieldName = "username"

*/

private String fieldName;

/**

* 字段值，如：张三

*/

private String fieldValue;

// setter/getter

}


调用代码：

ExcelData excelData = ExcelImportUtil.readExcel(xmlFile, importExcelStream);

然后在这个基础上，我们可以对数据进行一些操作，如：数据校验，插入数据。。。

其中数据校验时，如果数据不合法，给用户的提示信息可以精确指定某个单元格的数据不合法。（如：提示信息为：A3单元格数据不合法!）

注：使用了如下第三方JAR包：

Jdom ：解析XML描述文件

POI3.0 : 读取Excel文件

Xml描述文件，必须放在cn.zhaoql.excelimport.xml这个包里面。