java poi--实现Excel数据导出
java实现Excel数据导出:
目前,比较常用的实现Java导入、导出Excel的技术有两种Jakarta POI和Java Excel
Jakarta POI 是一套用于访问微软格式文档的Java API。Jakarta POI有很多组件组成,其中有用于操作Excel格式文件的HSSF和用于操作Word的HWPF,在各种组件中目前只有用于操作Excel的HSSF相对成熟。
官方主页:http://poi.apache.org/index.html
API文档:http://poi.apache.org/apidocs/index.html
Poi HSSF API组件
HSSF(用于操作Excel的组件)提供给用户使用的对象在rg.apache.poi.hssf.usermodel包中,主要部分包括Excel对象,样式和格式,还有辅助操作。有以下几种对象:
基本操作步骤
首先,理解一下一个Excel的文件的组织形式,一个Excel文件对应于一个workbook(HSSFWorkbook),一个workbook可以有多个sheet(HSSFSheet)组成,一个sheet是由多个row(HSSFRow)组成,一个row是由多个cell(HSSFCell)组成。
下面来看一个动态生成Excel文件的例子:
1 //创建HSSFWorkbook对象
2 HSSFWorkbook wb = new HSSFWorkbook();
3 //创建HSSFSheet对象
4 HSSFSheet sheet = wb.createSheet("sheet0");
5 //创建HSSFRow对象
6 HSSFRow row = sheet.createRow(0);
7 //创建HSSFCell对象
8 HSSFCell cell=row.createCell(0);
9 //设置单元格的值
10 cell.setCellValue("单元格中的中文");
11 //输出Excel文件
12 FileOutputStream output=new FileOutputStream("d:\\workbook.xls");
13 wkb.write(output);
14 output.flush();
HSSF读取文件同样还是使用这几个对象,只是把相应的createXXX方法变成了getXXX方法即可。可见只要理解了其中原理,不管是读还是写亦或是特定格式都可以轻松实现,正所谓知其然更要知其所以然。
导出Excel应用实例:
<!--导出文件-->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.17</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.17</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
导出表格的工具类
ExcelExportUtil:
/**
* @Author dw
* @Description 导出excel util
* @Date 2020/1/17 10:03
* @Param
* @return
*/
public class ExcelExportUtil {
/**
* Workbook对象
*/
private Workbook workbook;
/**
* 工作表对象
*/
private Sheet sheet;
/**
* 表大标题
*/
private String title;
/**
* sheet各个列的表头
*/
private String[] headList;
/**
* 各个列的表头对应的key值
*/
private String[] headKey;
/**
* sheet需要填充的数据信息
*/
private List<Map> data;
/**
* 工作表列宽
*/
private Integer columnWidth = 20;
/**
* 工作表行高
*/
private Integer rowHeight = 10;
/**
* 字体大小
*/
private int fontSize = 14;
public int getFontSize() {
return fontSize;
}
public void setFontSize(int fontSize) {
this.fontSize = fontSize;
}
public Integer getColumnWidth() {
return columnWidth;
}
public void setColumnWidth(Integer columnWidth) {
this.columnWidth = columnWidth;
}
public Integer getRowHeight() {
return rowHeight;
}
public void setRowHeight(Integer rowHeight) {
this.rowHeight = rowHeight;
}
public Workbook getWorkbook() {
return workbook;
}
public void setWorkbook(Workbook workbook) {
this.workbook = workbook;
}
public Sheet getSheet() {
return sheet;
}
public void setSheet(Sheet sheet) {
this.sheet = sheet;
}
public String[] getHeadKey() {
return headKey;
}
public void setHeadKey(String[] headKey) {
this.headKey = headKey;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String[] getHeadList() {
return headList;
}
public void setHeadList(String[] headList) {
this.headList = headList;
}
public List<Map> getData() {
return data;
}
public void setData(List<Map> data) {
this.data = data;
}
/**
* 插入数据到表格(body)
* @param startRow 开始行
*/
public void writeMainData(Integer startRow) {
//开始写入实体数据信息
if (CollectionUtils.isNotEmpty(data)) {
for (int i = 0; i < data.size(); i++) {
Row row = this.sheet.createRow(startRow);
Map map = data.get(i);
for (int j = 0; j < headKey.length; j++) {
Cell cell = row.createCell(j);
//设置单个单元格的字体颜色
Object value = map.get(headKey[j]);
if (null == value) {
String valueN = "";
cell.setCellValue(valueN);
} else if (value instanceof Integer) {
Integer valueInt = Integer.valueOf(value.toString());
cell.setCellValue(valueInt);
} else if (value instanceof String) {
String valueStr = String.valueOf(value);
cell.setCellValue(valueStr);
}
}
startRow++;
}
}
}
/**
* 写入表格大标题
* @throws IOException
*/
public void writeTitle() throws IOException {
checkConfig();
// 设置默认行宽
this.sheet.setDefaultColumnWidth(20);
// 在第0行创建rows (表标题)
Row title = this.sheet.createRow(0);
// 设置行高
title.setHeightInPoints(this.rowHeight);
Cell cell = title.createCell(0);
cell.setCellValue(this.title);
CellStyle cellStyle = ExcelStyleUtilFor2003.getTitleStyle(this.workbook, true, 16);
cell.setCellStyle(cellStyle);
ExcelStyleUtilFor2003.mergeCell(sheet, 0, 0, 0, (this.headList.length - 1));
}
/**
* 添加表头
* @param head 表头字段[]
* @param cellStyle 表头样式
* @param headRowNum 表头开始行
*/
public void writeTableHead(String[] head, CellStyle cellStyle, Integer headRowNum) {
Row row = this.sheet.createRow(headRowNum);
if (head.length > 0) {
for (int i = 0; i < head.length; i++) {
Cell cell = row.createCell(i);
cell.setCellValue(head[i]);
cell.setCellStyle(cellStyle);
}
}
}
/**
* 检查数据配置问题
* @throws IOException 抛出数据异常类
*/
protected void checkConfig() throws IOException {
if (headKey == null || headList.length == 0) {
throw new IOException("列名数组不能为空或者为NULL");
}
if (fontSize < 0) {
throw new IOException("字体不能为负值");
}
}
/**
* 写入拼接好的数据,不需要通过表头key值来对应
* @param dataLists 数据
* @param startRow 开始行
*/
public void writeMainData(List<List<String>> dataLists, Integer startRow) {
if (CollectionUtils.isNotEmpty(dataLists)) {
for (List<String> data : dataLists) {
Row row = this.sheet.createRow(startRow);
for (int i = 0; i < data.size(); i++) {
Cell cell = row.createCell(i);
cell.setCellValue(data.get(i));
CellStyle cellStyle = ExcelStyleUtilFor2003.setCellBorder(this.workbook);
cell.setCellStyle(cellStyle);
}
startRow++;
}
}
}
/**
* 创建工作簿
*/
public static Workbook creatWorkBook(ExcelEnum excelEnum){
Workbook workbook = null;
if (excelEnum.equals("XLS")) {
// 2003
workbook = new HSSFWorkbook();
} else if (excelEnum.equals("XLSX")) {
// 2007 及2007以上
workbook = new XSSFWorkbook();
}
return workbook;
}
}
Excel 样式抽取:
/**
* @Author
* @ClassName ExcelStyleUtilFor2003
* @Description excel样式
* @Date 2019/7/26 14:16
* @Version 1.0
*/
public class ExcelStyleUtilFor2003 {
/**
* 样式居中
* @param cellStyle
*/
public static void center(CellStyle cellStyle) {
// 水平居中
cellStyle.setAlignment(HorizontalAlignment.CENTER);
// 垂直居中
cellStyle.setVerticalAlignment(VerticalAlignment.CENTER);
}
/**
* 单元格合并
* @param wbSheet 工作表对象
* @param firstRow 合并的开始行
* @param lastRow 合并的结束行
* @param firstCol 合并的开始列
* @param lastCol 合并的结束列
*/
public static void mergeCell(Sheet wbSheet, int firstRow, int lastRow, int firstCol, int lastCol) {
wbSheet.addMergedRegion(new CellRangeAddress(firstRow, lastRow, firstCol, lastCol));
}
/**
* 加粗,垂直居中
* @param wb
* @param isBold
* @param FontSize
* @return
*/
public static CellStyle getTitleStyle(Workbook wb, Boolean isBold, int FontSize) {
// 标题样式(加粗,垂直居中)
CellStyle cellStyle = wb.createCellStyle();
center(cellStyle);
Font font = wb.createFont();
// 加粗
font.setBold(isBold);
// 设置标题字体大小
font.setFontHeightInPoints((short) FontSize);
cellStyle.setFont(font);
return cellStyle;
}
/**
* 表头样式
* @param wb
* @param fontSize
* @return
*/
public static CellStyle getHeadStyle(Workbook wb, int fontSize) {
CellStyle cellStyle = wb.createCellStyle();
// 设置表头的背景颜色
cellStyle.setFillForegroundColor(IndexedColors.BLUE.getIndex());
cellStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);
// 设置表头的背景颜色
cellStyle.setFillBackgroundColor(IndexedColors.BLUE.getIndex());
center(cellStyle);
//设置字体
Font font = setFont(wb, fontSize);
cellStyle.setFont(font);
return cellStyle;
}
/**
* body通用样式: 居中,设置字体大小
* @param wb
* @param fontSize
* @return
*/
public static CellStyle getBodyStyle(Workbook wb, int fontSize) {
CellStyle cellStyle = wb.createCellStyle();
//设置单元格样式
center(cellStyle);
Font font = setFont(wb, fontSize);
cellStyle.setFont(font);
return cellStyle;
}
/**
* 自动换行样式
* @param wb
* @return
*/
public static CellStyle getAutoWrapStyle(Workbook wb) {
CellStyle cellStyle = wb.createCellStyle();
cellStyle.setWrapText(true);
return cellStyle;
}
/**
* 设置单元格字体居中、并设置字体颜色
* @param wb
* @param fontSize
* @param color
* @return
*/
public static CellStyle getFontStyle(Workbook wb, int fontSize, short color) {
CellStyle cellStyle = wb.createCellStyle();
Font font = setFont(wb, fontSize, color);
center(cellStyle);
cellStyle.setFont(font);
return cellStyle;
}
/**
* 设置单元格字体
* @param wb
* @param fontSize
* @param color
* @return
*/
public static Font setFont(Workbook wb, int fontSize, short color) {
//设置字体
Font font = wb.createFont();
font.setColor(color);
font.setFontHeightInPoints((short) fontSize);
return font;
}
public static Font setFont(Workbook wb, int fontSize) {
//设置字体
Font font = wb.createFont();
font.setFontHeightInPoints((short) fontSize);
return font;
}
/**
* 设置cell边框
* @param workbook
* @return
*/
public static CellStyle setCellBorder(Workbook workbook){
CellStyle cellStyle = workbook.createCellStyle();
// 设置了边框属性
// 下边框
cellStyle.setBorderBottom(BorderStyle.THIN);
// 左边框
cellStyle.setBorderLeft(BorderStyle.THIN);
// 上边框
cellStyle.setBorderTop(BorderStyle.THIN);
// 右边框
cellStyle.setBorderRight(BorderStyle.THIN);
//设置边框颜色黑色
cellStyle.setTopBorderColor(IndexedColors.BLACK.index);
cellStyle.setBottomBorderColor(IndexedColors.BLACK.index);
cellStyle.setLeftBorderColor(IndexedColors.BLACK.index);
cellStyle.setRightBorderColor(IndexedColors.BLACK.index);
return cellStyle;
}
}
HSSFworkbook、XSSFworkbook、SXSSFworkbook区别总结
用JavaPOI导出Excel时,我们需要考虑到Excel版本及数据量的问题。针对不同的Excel版本,要采用不同的工具类,如果使用错了,会出现错误信息。JavaPOI导出Excel有三种形式,他们分别是1.HSSFWorkbook 2.XSSFWorkbook 3.SXSSFWorkbook。
- HSSFWorkbook: 是操作Excel2003以前(包括2003)的版本,扩展名是.xls;
- XSSFWorkbook: 是操作Excel2007后的版本,扩展名是.xlsx;
- SXSSFWorkbook: 是操作Excel2007后的版本,扩展名是.xlsx;
第一种:HSSFWorkbook
poi导出excel最常用的方式;但是此种方式的局限就是导出的行数至多为65535行,超出65536条后系统就会报错。此方式因为行数不足七万行所以一般不会发生内存不足的情况(OOM)。
第二种:XSSFWorkbook
这种形式的出现是为了突破HSSFWorkbook的65535行局限。其对应的是excel2007(1048576行,16384列)扩展名为“.xlsx”,最多可以导出104万行,不过这样就伴随着一个问题---OOM内存溢出,原因是你所创建的book sheet row cell等此时是存在内存的并没有持久化。
第三种:SXSSFWorkbook
从POI 3.8版本开始,提供了一种基于XSSF的低内存占用的SXSSF方式。对于大型excel文件的创建,一个关键问题就是,要确保不会内存溢出。其实,就算生成很小的excel(比如几Mb),它用掉的内存是远大于excel文件实际的size的。如果单元格还有各种格式(比如,加粗,背景标红之类的),那它占用的内存就更多了。对于大型excel的创建且不会内存溢出的,就只有SXSSFWorkbook了。它的原理很简单,用硬盘空间换内存(就像hash map用空间换时间一样)。
SXSSFWorkbook是streaming版本的XSSFWorkbook,它只会保存最新的excel rows在内存里供查看,在此之前的excel rows都会被写入到硬盘里(Windows电脑的话,是写入到C盘根目录下的temp文件夹)。被写入到硬盘里的rows是不可见的/不可访问的。只有还保存在内存里的才可以被访问到。
SXSSF与XSSF的对比:
a. 在一个时间点上,只可以访问一定数量的数据
b. 不再支持Sheet.clone()
c. 不再支持公式的求值
d. 在使用Excel模板下载数据时将不能动态改变表头,因为这种方式已经提前把excel写到硬盘的了就不能再改了
当数据量超出65536条后,在使用HSSFWorkbook或XSSFWorkbook,程序会报OutOfMemoryError:Javaheap space;内存溢出错误。这时应该用SXSSFworkbook。
如果需要使用模板来导出excel可以使用 jxls:
官网:http://jxls.sourceforge.net/
可以参考博客:
https://www.cnblogs.com/foxlee1024/p/7616987.html
https://blog.csdn.net/sinat_15769727/article/details/78898894