Apache POI 是创建和维护操作各种符合Office Open XML（OOXML）标准和微软的OLE 2复合文档格式（OLE2）的Java API。用它可以使用Java读取和创建,修改MS Excel文件.而且,还可以使用Java读取和创建MS Word和MSPowerPoint文件。Apache POI 提供Java操作Excel解决方案（适用于Excel97-2008）。
前言：依赖或下载
<!-- poi 依赖 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.16</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.16</version>
</dependency>
或者在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<rowNum;r++)
{
Row row=sheet.getRow(r);
//其他处理
}
但是，在下一层即遍历Cell单元格的时候如果还使用类似的getPhysicalNumberOfCells来获取数量遍历则可能出现错误，因为获取到的数量是去除了空格的单元格数量，而单元格的内容很可能是空的，所以这里就要使用一种可以遍历全部单元格的遍历方式：
// 循环取出每行的列数，其实是最后一列的列数
int cellNum=row.getLastCellNum();
// 遍历
for(int c=0;c<cellNum;c++)
{
// 取出每列值
Cell cell=row.getCell(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<String,LinkedHashMap<String,Object>> resolveExcel(File excelFile,String patternKey,Set<String> pattern,Map<String,String> columnMap) throws Exception
{
//记录结果
Map<String,LinkedHashMap<String,Object>> result=new HashMap<>();
//载入文件
Workbook workbook=WorkbookFactory.create(excelFile);
//记录当前标题与列位置的映射
Map<String,String> titleMap=new LinkedHashMap<>();
//遍历所有Sheet页
int pageNum=workbook.getNumberOfSheets();
for(int page=0;page<pageNum;page++)
{
//获取Sheet
Sheet sheet=workbook.getSheetAt(page);
//遍历全部非空行
Iterator<Row> rowItr=sheet.rowIterator();
int rowNum=0;
while(rowItr.hasNext())
{
//获取行
Row row=rowItr.next();
//记录数据
LinkedHashMap<String,Object> map=new LinkedHashMap<>();
//遍历本行全部列（包括空列）
int colNum=row.getLastCellNum();
for(int index=0;index<colNum;index++)
{
//获取单元格
Cell cell=row.getCell(index);
//获取单元格内容
Object value=getCellValue(cell);
//第一行为标题行，记录标题和位置索引的映射
if(rowNum==0)
{
String title=value+"";
if(columnMap.containsKey(title))
titleMap.put(index+"",title);
}
//非标题行，根据指定columnMap和PatternKey查找记录
else
{
//需要的内容
if(!titleMap.containsKey(index+"")) continue;
map.put(columnMap.get(titleMap.get(index+"")),value);
}
}
//验证是否记录此行
if(pattern.contains(map.get(patternKey)+""))
{
result.put(map.get(patternKey)+"",map);
}
rowNum++;
}
}
return result;
}
/**
* 依据Excel中Cell类型读取不同的值
*
* @param cell
* @return String/Double/Date/boolean/null
*/
public static Object getCellValue(Cell cell)
{
Object result=null;
//获取类型
int type=cell.getCellType();
//根据不同类型处理
switch(type)
{
//字符串
case Cell.CELL_TYPE_STRING:
{
result=cell.getRichStringCellValue().toString().trim();
break;
}
//数字(Double)
case Cell.CELL_TYPE_NUMERIC:
//公式(Double)
case Cell.CELL_TYPE_FORMULA:
{
//日期类型判断
//日期类型
if(org.apache.poi.ss.usermodel.DateUtil.isCellDateFormatted(cell))
{
result=cell.getDateCellValue();
}
//普通数字
else
{
result=new Double(cell.getNumericCellValue());
}
break;
}
//布尔
case Cell.CELL_TYPE_BOOLEAN:
{
result=cell.getBooleanCellValue();
break;
}
//其他
default:
}
return result;
}
}
网友评论