Apache POI 之一：Excel文档的读取

Apache POI 是创建和维护操作各种符合Office Open XML（OOXML）标准和微软的OLE 2复合文档格式（OLE2）的Java API。用它可以使用Java读取和创建,修改MS Excel文件.而且,还可以使用Java读取和创建MS Word和MSPowerPoint文件。Apache POI 提供Java操作Excel解决方案（适用于Excel97-2008）。

前言：依赖或下载

   org.apache.poi
   poi
   3.16



    org.apache.poi
    poi-ooxml
    3.16

或者在poi.apache.org下载jar包

本篇文章主要是演示Excel文档的读取处理。
使用POI解析Excel有两个需要注意的关键点：

• 遍历方式的区别（PhysicalNumber和Number）
• 单元格不同格式的读取

下面单独说明一下。

POI遍历方式的区别（PhysicalNumber和Number）

Excel文档结构分为整个文档（Workbook）、分页（Sheet）、行（Row）、单元格（Cell）四个类来描述，而遍历整个Excel也是通过层层遍历到单元格的方式，但是方式略有不同。如POI提供了获取行数的方法为getPhysicalNumberOfRows，而这里physical的含义就是去除了空行的数量，因此只有保证没有空行的情况下才能使用这个数量来遍历全部行。去除空行的遍历：

//行数
int rowNum=sheet.getPhysicalNumberOfRows();
if(rowNum<1) continue;

// 从第2(r=1)行取出，第一行默认为标题行
rowNum+=1;

//遍历
for(int r=1;r

但是，在下一层即遍历Cell单元格的时候如果还使用类似的getPhysicalNumberOfCells来获取数量遍历则可能出现错误，因为获取到的数量是去除了空格的单元格数量，而单元格的内容很可能是空的，所以这里就要使用一种可以遍历全部单元格的遍历方式：

// 循环取出每行的列数，其实是最后一列的列数
int cellNum=row.getLastCellNum();
// 遍历
for(int c=0;c

单元格不同格式的读取

POI解析Cell的类型分为了字符串、数字、公式以及布尔四种类型：

• 其中，字符串通过getRechStringCellValue().toString()来获取即可；
• 而数字和公式在Excel中实际储存的都是Double类型；
• 布尔类型直接通过getBooleanCellValue()获取。
• 比较特殊是日期类型，日期类型实际cellType是数字，但是直接读取数字则不是想要的格式。为此，POI提供了一个方法（org.apache.poi.ss.usermodel.DateUtil.isCellDateFormatted（cell））来判断是否为日期，如果为日期格式则使用cell的getDateCellValue方法获取就可以得到Excel里格式化后的日期内容。

工具使用代码示例

（我这里的业务要求是只取部分需要的列里的值，而非全部列里的值导入。）

package pb.utils;

import org.apache.poi.ss.usermodel.*;

import java.io.File;
import java.util.*;

/**
 * Excel导入读取
 */
public class ExcelUtils
{
    /**
     * 动态解析Excel文件，并返回指定的对象列表
     *
     * @param excelFile
     * @param patternKey 匹配使用的主键名
     * @param pattern    全部匹配值
     * @param columnMap  需要获取的标题与字段名的对应，如显示名称->name；包含主键列
     * @return
     */
    public static Map> resolveExcel(File excelFile,String patternKey,Set pattern,Map columnMap) throws Exception
    {
        //记录结果
        Map> result=new HashMap<>();
        //载入文件
        Workbook workbook=WorkbookFactory.create(excelFile);

        //记录当前标题与列位置的映射
        Map titleMap=new LinkedHashMap<>();

        //遍历所有Sheet页
        int pageNum=workbook.getNumberOfSheets();
        for(int page=0;page rowItr=sheet.rowIterator();
            int rowNum=0;
            while(rowItr.hasNext())
            {
                //获取行
                Row row=rowItr.next();
                //记录数据
                LinkedHashMap map=new LinkedHashMap<>();

                //遍历本行全部列（包括空列）
                int colNum=row.getLastCellNum();
                for(int index=0;index