Java 通过 POI 读取 Excel 文件数据

目录

术语

目的

技术

实现过程

实现的代码

验证程序

---

术语

术语	说明
工作簿	Excel 文件
工作表	Excel 文件中的 Sheet 表格
xls	xls 格式的Excel 文件，Excel 2003及以前使用的 Excel 文件格式
xlsx	xlsx 格式的 Excel 文件，Excel 2007 及以后使用的 Excel 文件格式

目的

根据 Excel 文件的路径获取到 Excel 文件中的数据。

技术

使用 Apache 组织下 POI 项目对 Excel 文件进行读取操作，本次主要使用到的接口和类如下表所示：

名称	类型	说明
WorkBookFactory	类	创建合适的工作簿（HSSFWorkBook或XSSFWorkBook），根据文件输入流自动检测。
HSSFWorkBook	类	创建xls 格式的工作簿，Excel 2003 及其以前使用的格式。
XSSFWorkBook	类	创建 xlsx 格式的工作簿，Excel 2007 及其以后使用的格式。
WorkBook	接口	工作簿接口
Sheet	接口	工作表接口
Row	接口	行接口
Cell	接口	单元格接口

如需更多关于 POI 项目下的接口和类的详细文档，请参考官方文档：http://poi.apache.org/apidocs/index.html?overview-summary.html

读取 xls 格式文件需要用到的 jar 包：

读取 xls 格式文件时需要的 jar 文件

读取 xlsx 格式文件需要用到的 jar 包：

读取 xlsx 格式文件时需要的 jar 文件

POI 项目使用到的 jar 包官方下载地址：http://poi.apache.org/download.html

实现过程

1. 如果指定的工作表位置小于1，则默认设置为1；
2. 判断文件路径是否正确或是不是 Excel 文件（以 .xls 或 .xlsx 结尾的文件），如果判断失败，程序结束；
3. 如果判断成功，创建工作簿，根据文件输入流自动检测创建工作簿类型；
4. 判断是否为指定工作表，如果是只读取指定工作表的数据，如果不是读取工作簿中所有工作表数据；
5. 判断指定工作表位置在工作簿中是否存在，存在读取指定工作表的数据，不存在则读取工作簿最后一张工作表的数据；
6. 工作表中添加工作表的名称；

如果工作表不止一行数据，工作表的总列数取第一行和第二行中最大的列数，注意：工作表中第一行或第二行的列数必须和工作表的总列数相同。

实现的代码

package cn.bc.util;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.ss.usermodel.WorkbookFactory;

/**
 * 
 * @ClassName: cn.bc.util.ExcelUtil
 * 
 * @Description: 读取 Excel 工作表数据
 * xls 格式是 Excel 2003及其以前版本使用的格式
 * xlsx 格式是 Excel 2007及其以后版本使用的格式
 * 工作簿表示整个 Excel 文件，工作表表示 Excel 文件中的 Sheet 表
 * 注意：   1、Excel 文件中工作表的第一行不能为空；
 * 		2、如果 Excel 文件中工作表除第一行外还有其它数据时，第二行也不能为空；
 * 		3、Excel 文件中工作表的第一行或第二行的列数必须是整个工作表的总列数
 *
 * @author 17bc8
 * @date: 2019年8月10日
 *
 * @Copyright: 2019 www.17bc8.cn
 */
public class ExcelUtil {

	private static Log log = LogFactory.getLog(ExcelUtil.class);
	
	/**
	 * 
	 * @Title: validExxel
	 * 
	 * @Description: 验证文件是不是 Excel 文件
	 * 
	 * @param path 文件的路径
	 * @return 是：true；不是：false
	 */
	private static Boolean validExxel (String path) {
		String xls = "^.+\\.(?i)(xls)$";	// 正则表达式判断是不是以 .xls 结尾的文件
		String xlsx = "^.+\\.(?i)(xlsx)$";	// 正则表达式判断是不是以 .xlsx 结尾的文件
		if (path == null || !(path.matches(xls) || path.matches(xlsx))) {
			log.error("@!--------------------不是Excel文件！");
			return false;
		}
		return true;
	}
	
	/**
	 * 
	 * @Title: readExcel
	 * 
	 * @Description: 读取 Excel 文件的数据
	 * 
	 * @param path 文件的路径
	 * @param isSheetIndex 是否指定工作表（Sheet)
	 * @param sheetIndex 指定工作表在工作簿中的位置
	 *  1、如果 isSheetIndex 为 true 时，sheetIndex 为大于0的整数
	 *  	1.1、如果 sheetIndex 小于等于 0，默认读取工作簿中的第一张工作表；
	 *  	1.2、如果 sheetIndex 大于工作簿中工作表的总数，默认读取工作簿中最后一张工作表；
	 *  2、如果 isSheetIndex 为 false 时，sheetIndex 可以是任何整数，此时读取工作簿中所有工作表的数据
	 * @return Excel Excel 文件的数据集
	 */
	public static List