一.基本介绍
1.1、Apache POI介绍
Apache POI是一个可以进行微软的文档进行开源库，可以操作的文档类型包括word、ppt、excel、visio、outlook....
本文主要针对Apache POI对excel的操作进行介绍，主要包括如何创建一个excel、录入数据、读取excel数据的方式。
参考官方文档：
1.2、HSSF和XSSF
在POI中，如果要操作Excel，可以有两种操作“模式”，分别是HSSF和XSSF，其中HSSF可以处理win97以及低于的excel，而XSSF可以用于处理以及更高的版本excel，所以我们一般都会使用XSSF。
有一个很重要的术语：工作薄，其实可以理解为“文档”，excel、word，都属于工作簿，英文workbook。
1.3、引入依赖
只需要导入poi-ooxml这个库即可。
org.apache.poi
poi-ooxml
4.1.2
junit
junit
4.13
二.利用poi库创建excel
2.1、创建一个空excel
下面的代码运行后
package cn.ganlixin.poi;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.junit.Test;
import java.io.*;
public class CreateExcelTest {
/**
* 创建一个空的Excel文件
*/
@Test
public void testCreateEmptyExcel() throws IOException {
// 创建文件
BufferedOutputStream outputStream = new BufferedOutputStream(new FileOutputStream("data.xlsx"));
// 创建工作簿类(所有要写入excel的数据，都将保存在workbook中)
XSSFWorkbook workbook = new XSSFWorkbook();
// 将workbook中的数据写入到文件中。
workbook.write(outputStream);
// 关闭
workbook.close();
outputStream.close();
}
}
2.2、简单演示写入excel内容
下面演示创建一个data.xlsx，并在“my-sheet-1”sheet内的第5行第3列写入一个“hello world”：
package cn.ganlixin.poi;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.junit.Test;
import java.io.*;
public class CreateExcelTest {
/**
* 简单演示如何写入数据内容
*/
@Test
public void testCreateSimpleWorkbook() throws IOException {
// 指定创建的excel文件名称
BufferedOutputStream outputStream = new BufferedOutputStream(new FileOutputStream("data.xlsx"));
// 定义一个工作薄(所有要写入excel的数据，都将保存在workbook中)
XSSFWorkbook workbook = new XSSFWorkbook();
// 创建一个sheet
XSSFSheet sheet = workbook.createSheet("my-sheet-1");
// 开始写入数据流程，2大步：1、定位到单元格，2、写入数据；定位单元格，需要通过行、列配合指定。
// step1: 先选择第几行(0表示第一行)，下面表示在第6行
XSSFRow row = sheet.createRow(5);
// step2：选择第几列(0表示第一列)，注意，这里的第几列，是在上面指定的row基础上，也就是第6行，第3列
XSSFCell cell = row.createCell(2);
// step3：设置单元格的数据(写入数据)
cell.setCellValue("hello world");
// 执行写入操作
workbook.write(outputStream);
workbook.close();
outputStream.flush();
outputStream.close();
}
}
运行后，下面是生成的excel：
2.3、通常的写入数据流程
一般写入excel的数据都是结构化的(类似于数据库表的结构)，下面是一个示例，创建一个users.xlsx文档：
package cn.ganlixin.poi;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.junit.Test;
import java.io.BufferedOutputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class CreateExcelTest {
private static class User {
private Integer id;
private String name;
private Integer age;
private String addr;
// 避免占用篇幅，所以省略了构造方法、getter、setter
}
/**
* 写入结构化的用户信息数据
*/
@Test
public void testCreateUsersExcel() throws IOException {
List userList = new ArrayList<>();
userList.add(new User(1, "abc", 99, "北京"));
userList.add(new User(2, "lol", 77, "上海"));
userList.add(new User(3, "qaq", 88, "深圳"));
userList.add(new User(4, "owo", 66, "杭州"));
// 指定创建的excel文件名称
BufferedOutputStream outputStream = new BufferedOutputStream(new FileOutputStream("users.xlsx"));
// 定义一个工作薄(所有要写入excel的数据，都将保存在workbook中)
XSSFWorkbook workbook = new XSSFWorkbook();
// 创建一个sheet
XSSFSheet sheet = workbook.createSheet("my-sheet");
// 第一行，为表头，需要单独写入，下面是错误方式，因为在反复的创建第1行(rowNumber为0)
/*
sheet.createRow(0).createCell(0).setCellValue("编号");
sheet.createRow(0).createCell(1).setCellValue("姓名");
sheet.createRow(0).createCell(2).setCellValue("年龄");
sheet.createRow(0).createCell(3).setCellValue("城市");
*/
// 正确方式
XSSFRow head = sheet.createRow(0);
head.createCell(0).setCellValue("编号");
head.createCell(1).setCellValue("姓名");
head.createCell(2).setCellValue("年龄");
head.createCell(3).setCellValue("城市");
// 接下来遍历要录入的数据(建议使用for，并且从第2行开始，也就是rowNumber为1，因为表头占了一行)
for (int rowNumber = 1, index = 0; index < userList.size(); index++, rowNumber++) {
User user = userList.get(index);
// 写入数据流程，1、定位到单元格，2、写入数据；定位单元格，需要通过行、列配合指定。
XSSFRow row = sheet.createRow(rowNumber);
row.createCell(0).setCellValue(user.getId());
row.createCell(1).setCellValue(user.getName());
row.createCell(2).setCellValue(user.getAge());
row.createCell(3).setCellValue(user.getAddr());
}
// 执行写入操作
workbook.write(outputStream);
workbook.close();
outputStream.flush();
outputStream.close();
}
}
生成的excel如下：
三.使用POI读取Excel内容
3.1、读取excel示例
下面针对上面创建的users.xlsx进行读取并打印
package cn.ganlixin.poi;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.junit.Test;
import java.io.BufferedInputStream;
import java.io.FileInputStream;
import java.io.IOException;
public class ReadExcelTest {
@Test
public void testReadUsersExcel() throws IOException {
// 指定excel文件，创建缓存输入流
BufferedInputStream inputStream = new BufferedInputStream(new FileInputStream("users.xlsx"));
// 直接传入输入流即可，此时excel就已经解析了
XSSFWorkbook workbook = new XSSFWorkbook(inputStream);
// 选择要处理的sheet名称
XSSFSheet sheet = workbook.getSheet("my-sheet");
// 第一行表头，单独处理
// 迭代遍历sheet剩余的每一行
for (int rowNum = 0; rowNum < sheet.getPhysicalNumberOfRows(); rowNum++) {
if (rowNum == 0) { // 读取第一行(表头)
XSSFRow head = sheet.getRow(rowNum);
String headColumn_1 = head.getCell(0).getStringCellValue();
String headColumn_2 = head.getCell(1).getStringCellValue();
String headColumn_3 = head.getCell(2).getStringCellValue();
String headColumn_4 = head.getCell(3).getStringCellValue();
String headStr = String.format("%s\t%s\t%s\t%s", headColumn_1, headColumn_2, headColumn_3, headColumn_4);
System.out.println(headStr);
} else { // 非表头(注意读取的时候要注意单元格内数据的格式，要使用正确的读取方法)
XSSFRow row = sheet.getRow(rowNum);
int id = (int) row.getCell(0).getNumericCellValue();
String name = row.getCell(1).getStringCellValue();
int age = (int) row.getCell(2).getNumericCellValue();
String addr = row.getCell(3).getStringCellValue();
String rowContent = String.format("%s\t%s\t%s\t%s", id, name, age, addr);
System.out.println(rowContent);
}
}
workbook.close();
inputStream.close();
}
}
运行输出如下：
