一. POI 结构与常用类
1.POI 介绍
Apache POI 是 Apache 软件基金会的开源项目, POI 提供 API 给 Java 程序对 Microsoft Office 格式档案读和写的功能 .NET 的开发人员则可以利用 NPOI (POI for .NET) 来存取 Microsoft Office 文档的功能
2.POI 结构说明
包名称 说明
HSSF 提供读写 Microsoft Excel XLS 格式档案的功能
XSSF 提供读写 Microsoft Excel OOXML XLSX 格式档案的功能
HWPF 提供读写 Microsoft Word DOC 格式档案的功能
HSLF 提供读写 Microsoft PowerPoint 格式档案的功能
HDGF 提供读 Microsoft Visio 格式档案的功能
HPBF 提供读 Microsoft Publisher 格式档案的功能
HSMF 提供读 Microsoft Outlook 格式档案的功能
3.POI 常用类说明
类名 说明
HSSFWorkbook Excel 的文档对象
HSSFSheet Excel 的表单
HSSFRow Excel 的行
HSSFCell Excel 的格子单元
HSSFFont Excel 字体
HSSFDataFormat 格子单元的日期格式
HSSFHeader Excel 文档 Sheet 的页眉
HSSFFooter Excel 文档 Sheet 的页脚
HSSFCellStyle 格子单元样式
HSSFDateUtil 日期
HSSFPrintSetup 打印
HSSFErrorConstants 错误信息
二. 简单的实例代码
Maven 依赖
- <dependency>
- <groupId>org.apache.poi</groupId>
- <artifactId>poi</artifactId>
- <version>3.9</version>
- </dependency>
- <dependency>
- <groupId>org.apache.poi</groupId>
- <artifactId>poi-ooxml</artifactId>
- <version>3.9</version>
- </dependency>
- package com.my.utils;
- import java.io.FileOutputStream;
- import org.apache.poi.hssf.usermodel.HSSFWorkbook;
- import org.apache.poi.hssf.util.HSSFColor;
- import org.apache.poi.ss.usermodel.Cell;
- import org.apache.poi.ss.usermodel.CellStyle;
- import org.apache.poi.ss.usermodel.Row;
- import org.apache.poi.ss.usermodel.Sheet;
- import org.apache.poi.ss.usermodel.Workbook;
- public class UsePoiCreateExcle {
- public static void main(String[] args) {
- // TODO Auto-generated method stub
- String path = "D:\\java\\test\\test.xls";
- // create workbook
- Workbook workbook = new HSSFWorkbook();
- // create sheet
- Sheet sheet1 = workbook.createSheet("teacher");
- Sheet sheet2 = workbook.createSheet("student");
- // 设置为当前页面
- workbook.setActiveSheet(0);
- // 创建行
- Row row = sheet1.createRow(0);
- // 创建表格
- Cell cell1 = row.createCell(0);
- Cell cell2 = row.createCell(1);
- Cell cell3 = row.createCell(2);
- CellStyle style = workbook.createCellStyle();
- // 对齐方式
- style.setAlignment(CellStyle.ALIGN_CENTER);
- // 先设置样式再设置颜色
- style.setBorderBottom(CellStyle.BORDER_THICK);
- style.setBottomBorderColor(HSSFColor.RED.index);
- // 先设置填充样式再设置颜色
- style.setFillPattern(CellStyle.ALT_BARS);
- style.setFillForegroundColor(HSSFColor.GREEN.index);
- cell1.setCellValue("序号");
- cell1.setCellStyle(style);
- cell2.setCellValue("姓名");
- cell3.setCellValue("年龄");
- System.out.println("=============");
- try {
- FileOutputStream out = new FileOutputStream(path);
- workbook.write(out);
- out.close();
- } catch (Exception e) {
- // TODO Auto-generated catch block
- e.printStackTrace();
- }
- }
- }
三. 具体样式详解
1. 创建文档摘要信息
- workbook.createInformationProperties(); // 创建文档信息
- DocumentSummaryInformation dsi = workbook.getDocumentSummaryInformation(); // 摘要信息
- dsi.setCategory("类别: Excel 文件"); // 类别
- dsi.setManager("管理者: 李志伟"); // 管理者
- dsi.setCompany("公司:--"); // 公司
- SummaryInformation si = workbook.getSummaryInformation(); // 摘要信息
- si.setSubject("主题:--"); // 主题
- si.setTitle("标题: 测试文档"); // 标题
- si.setAuthor("作者: 李志伟"); // 作者
- si.setComments("备注: POI 测试文档"); // 备注
2. 创建批注
- HSSFSheet sheet = workbook.createSheet("Test"); // 创建工作表 (Sheet)
- HSSFPatriarch patr = sheet.createDrawingPatriarch();
- HSSFClientAnchor anchor = patr.createAnchor(0, 0, 0, 0, 5, 1, 8, 3); // 创建批注位置
- HSSFComment comment = patr.createCellComment(anchor); // 创建批注
- comment.setString(new HSSFRichTextString("这是一个批注段落!")); // 设置批注内容
- comment.setAuthor("李志伟"); // 设置批注作者
- comment.setVisible(true); // 设置批注默认显示
- HSSFCell cell = sheet.createRow(2).createCell(1);
- cell.setCellValue("测试");
- cell.setCellComment(comment); // 把批注赋值给单元格
创建批注位置 HSSFPatriarch.createAnchor(dx1, dy1, dx2, dy2, col1, row1, col2, row2) 方法参数说明:
dx1 第 1 个单元格中 x 轴的偏移量
dy1 第 1 个单元格中 y 轴的偏移量
dx2 第 2 个单元格中 x 轴的偏移量
dy2 第 2 个单元格中 y 轴的偏移量
col1 第 1 个单元格的列号
row1 第 1 个单元格的行号
col2 第 2 个单元格的列号
row2 第 2 个单元格的行号
3. 创建页眉和页脚
- HSSFSheet sheet = workbook.createSheet("Test");// 创建工作表 (Sheet)
- HSSFHeader header =sheet.getHeader();// 得到页眉
- header.setLeft("页眉左边");
- header.setRight("页眉右边");
- header.setCenter("页眉中间");
- HSSFFooter footer =sheet.getFooter();// 得到页脚
- footer.setLeft("页脚左边");
- footer.setRight("页脚右边");
- footer.setCenter("页脚中间");
也可以使用 Office 自带的标签定义, 你可以通过 HSSFHeader 或 HSSFFooter 访问到它们, 都是静态属性, 列表如下:
HSSFHeader.tab &A 表名
HSSFHeader.file &F 文件名
HSSFHeader.startBold &B 粗体开始
HSSFHeader.endBold &B 粗体结束
HSSFHeader.startUnderline &U 下划线开始
HSSFHeader.endUnderline &U 下划线结束
HSSFHeader.startDoubleUnderline &E 双下划线开始
HSSFHeader.endDoubleUnderline &E 双下划线结束
HSSFHeader.time &T 时间
HSSFHeader.date &D 日期
HSSFHeader.numPages &N 总页面数
HSSFHeader.page &P 当前页号
4. 设置数据格式
- HSSFSheet sheet = workbook.createSheet("Test");// 创建工作表 (Sheet)
- HSSFRow row=sheet.createRow(0);
- // 设置日期格式 -- 使用 Excel 内嵌的格式
- HSSFCell cell=row.createCell(0);
- cell.setCellValue(new Date());
- HSSFCellStyle style=workbook.createCellStyle();
- style.setDataFormat(HSSFDataFormat.getBuiltinFormat("m/d/yy h:mm"));
- cell.setCellStyle(style);
- // 设置保留 2 位小数 -- 使用 Excel 内嵌的格式
- cell=row.createCell(1);
- cell.setCellValue(12.3456789);
- style=workbook.createCellStyle();
- style.setDataFormat(HSSFDataFormat.getBuiltinFormat("0.00"));
- cell.setCellStyle(style);
- // 设置货币格式 -- 使用自定义的格式
- cell=row.createCell(2);
- cell.setCellValue(12345.6789);
- style=workbook.createCellStyle();
- style.setDataFormat(workbook.createDataFormat().getFormat("#,##0"));
- cell.setCellStyle(style);
- // 设置百分比格式 -- 使用自定义的格式
- cell=row.createCell(3);
- cell.setCellValue(0.123456789);
- style=workbook.createCellStyle();
- style.setDataFormat(workbook.createDataFormat().getFormat("0.00%"));
- cell.setCellStyle(style);
- // 设置中文大写格式 -- 使用自定义的格式
- cell=row.createCell(4);
- cell.setCellValue(12345);
- style=workbook.createCellStyle();
- style.setDataFormat(workbook.createDataFormat().getFormat("[DbNum2][$-804]0"));
- cell.setCellStyle(style);
- // 设置科学计数法格式 -- 使用自定义的格式
- cell=row.createCell(5);
- cell.setCellValue(12345);
- style=workbook.createCellStyle();
- style.setDataFormat(workbook.createDataFormat().getFormat("0.00E+00"));
- cell.setCellStyle(style);
HSSFDataFormat.getFormat 和 HSSFDataFormat.getBuiltinFormat 的区别: 当使用 Excel 内嵌的 (或者说预定义) 的格式时, 直接用 HSSFDataFormat.getBuiltinFormat 静态方法即可当使用自己定义的格式时, 必须先调用 HSSFWorkbook.createDataFormat(), 因为这时在底层会先找有没有匹配的内嵌 FormatRecord, 如果没有就会新建一个 FormatRecord, 所以必须先调用这个方法, 然后你就可以用获得的 HSSFDataFormat 实例的 getFormat 方法了, 当然相对而言这种方式比较麻烦, 所以内嵌格式还是用 HSSFDataFormat.getBuiltinFormat 静态方法更加直接一些
5. 合并单元格
- HSSFSheet sheet = workbook.createSheet("Test");// 创建工作表 (Sheet)
- HSSFRow row=sheet.createRow(0);
- // 合并列
- HSSFCell cell=row.createCell(0);
- cell.setCellValue("合并列");
- CellRangeAddress region=new CellRangeAddress(0, 0, 0, 5);
- sheet.addMergedRegion(region);
- // 合并行
- cell=row.createCell(6);
- cell.setCellValue("合并行");
- region=new CellRangeAddress(0, 5, 6, 6);
- sheet.addMergedRegion(region);
CellRangeAddress 对象其实就是表示一个区域, 其构造方法如下: CellRangeAddress(firstRow, lastRow, firstCol, lastCol), 参数的说明:
firstRow 区域中第一个单元格的行号
lastRow 区域中最后一个单元格的行号
firstCol 区域中第一个单元格的列号
lastCol 区域中最后一个单元格的列号
6. 单元格对齐
- HSSFCell cell=row.createCell(0);
- cell.setCellValue("单元格对齐");
- HSSFCellStyle style=workbook.createCellStyle();
- style.setAlignment(HSSFCellStyle.ALIGN_CENTER);// 水平居中
- style.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER);// 垂直居中
- style.setWrapText(true);// 自动换行
- style.setIndention((short)5);// 缩进
- style.setRotation((short)60);// 文本旋转, 这里的取值是从 - 90 到 90, 而不是 0-180 度
- cell.setCellStyle(style);
水平对齐相关参数
如果是左侧对齐就是 HSSFCellStyle.ALIGN_FILL;
如果是居中对齐就是 HSSFCellStyle.ALIGN_CENTER;
如果是右侧对齐就是 HSSFCellStyle.ALIGN_RIGHT;
如果是跨列举中就是 HSSFCellStyle.ALIGN_CENTER_SELECTION;
如果是两端对齐就是 HSSFCellStyle.ALIGN_JUSTIFY;
如果是填充就是 HSSFCellStyle.ALIGN_FILL;
垂直对齐相关参数
如果是靠上就是 HSSFCellStyle.VERTICAL_TOP;
如果是居中就是 HSSFCellStyle.VERTICAL_CENTER;
如果是靠下就是 HSSFCellStyle.VERTICAL_BOTTOM;
如果是两端对齐就是 HSSFCellStyle.VERTICAL_JUSTIFY;
7. 使用边框
边框和其他单元格设置一样也是调用 CellStyle 接口, CellStyle 有 2 种和边框相关的属性, 分别是:
边框相关属性 | 说明 | 范例 |
Border + 方向 | 边框类型 | BorderLeft, BorderRight 等 |
方向 + BorderColor | 边框颜色 | TopBorderColor,BottomBorderColor 等 |
- HSSFCell cell=row.createCell(1);
- cell.setCellValue("设置边框");
- HSSFCellStyle style=workbook.createCellStyle();
- style.setBorderTop(HSSFCellStyle.BORDER_DOTTED);// 上边框
- style.setBorderBottom(HSSFCellStyle.BORDER_THICK);// 下边框
- style.setBorderLeft(HSSFCellStyle.BORDER_DOUBLE);// 左边框
- style.setBorderRight(HSSFCellStyle.BORDER_SLANTED_DASH_DOT);// 右边框
- style.setTopBorderColor(HSSFColor.RED.index);// 上边框颜色
- style.setBottomBorderColor(HSSFColor.BLUE.index);// 下边框颜色
- style.setLeftBorderColor(HSSFColor.GREEN.index);// 左边框颜色
- style.setRightBorderColor(HSSFColor.PINK.index);// 右边框颜色
- cell.setCellStyle(style);
其中边框类型分为以下几种:
边框范例图 | 对应的静态值 |
HSSFCellStyle. BORDER_DOTTED | |
HSSFCellStyle. BORDER_HAIR | |
HSSFCellStyle. BORDER_DASH_DOT_DOT | |
HSSFCellStyle. BORDER_DASH_DOT | |
HSSFCellStyle. BORDER_DASHED | |
HSSFCellStyle. BORDER_THIN | |
HSSFCellStyle. BORDER_MEDIUM_DASH_DOT_DOT | |
HSSFCellStyle. BORDER_SLANTED_DASH_DOT | |
HSSFCellStyle. BORDER_MEDIUM_DASH_DOT | |
HSSFCellStyle. BORDER_MEDIUM_DASHED | |
HSSFCellStyle. BORDER_MEDIUM | |
HSSFCellStyle. BORDER_THICK | |
HSSFCellStyle. BORDER_DOUBLE |
8. 设置字体
- HSSFCell cell = row.createCell(1);
- cell.setCellValue("设置字体");
- HSSFCellStyle style = workbook.createCellStyle();
- HSSFFont font = workbook.createFont();
- font.setFontName("华文行楷");// 设置字体名称
- font.setFontHeightInPoints((short)28);// 设置字号
- font.setColor(HSSFColor.RED.index);// 设置字体颜色
- font.setUnderline(FontFormatting.U_SINGLE);// 设置下划线
- font.setTypeOffset(FontFormatting.SS_SUPER);// 设置上标下标
- font.setStrikeout(true);// 设置删除线
- style.setFont(font);
- cell.setCellStyle(style);
下划线选项值:
单下划线 FontFormatting.U_SINGLE
双下划线 FontFormatting.U_DOUBLE
会计用单下划线 FontFormatting.U_SINGLE_ACCOUNTING
会计用双下划线 FontFormatting.U_DOUBLE_ACCOUNTING
无下划线 FontFormatting.U_NONE
上标下标选项值:
上标 FontFormatting.SS_SUPER
下标 FontFormatting.SS_SUB
普通, 默认值 FontFormatting.SS_NONE
9. 背景和纹理
- SSFCellStyle style = workbook.createCellStyle();
- style.setFillForegroundColor(HSSFColor.GREEN.index);// 设置图案颜色
- style.setFillBackgroundColor(HSSFColor.RED.index);// 设置图案背景色
- style.setFillPattern(HSSFCellStyle.SQUARES);// 设置图案样式
- cell.setCellStyle(style);
10. 设置宽度和高度
- HSSFSheet sheet = workbook.createSheet("Test");// 创建工作表 (Sheet)
- HSSFRow row = sheet.createRow(1);
- HSSFCell cell = row.createCell(1);
- cell.setCellValue("123456789012345678901234567890");
- sheet.setColumnWidth(1, 31 * 256);// 设置第一列的宽度是 31 个字符宽度
- row.setHeightInPoints(50);// 设置行的高度是 50 个点
这里你会发现一个有趣的现象, setColumnWidth 的第二个参数要乘以 256, 这是怎么回事呢? 其实, 这个参数的单位是 1/256 个字符宽度, 也就是说, 这里是把 B 列的宽度设置为了 31 个字符
设置行高使用 HSSFRow 对象的 setHeight 和 setHeightInPoints 方法, 这两个方法的区别在于 setHeightInPoints 的单位是点, 而 setHeight 的单位是 1/20 个点, 所以 setHeight 的值永远是 setHeightInPoints 的 20 倍
你也可以使用 HSSFSheet.setDefaultColumnWidthHSSFSheet.setDefaultRowHeight 和 HSSFSheet.setDefaultRowHeightInPoints 方法设置默认的列宽或行高
11. 判断单元格是否为日期
- // 判断单元格是否为日期类型, 使用 DateUtil.isCellDateFormatted(cell) 方法, 例如:
- HSSFCell cell = row.createCell(1);
- cell.setCellValue(new Date());// 设置日期数据
- System.out.println(DateUtil.isCellDateFormatted(cell));// 输出: false
- HSSFCellStyle style =workbook.createCellStyle();
- style.setDataFormat(HSSFDataFormat.getBuiltinFormat("m/d/yy h:mm"));
- cell.setCellStyle(style);// 设置日期样式
- System.out.println(DateUtil.isCellDateFormatted(cell));// 输出: true
12. 设置默认工作表
- HSSFWorkbook workbook = new HSSFWorkbook();// 创建 Excel 文件 (Workbook)
- workbook.createSheet("Test0");// 创建工作表 (Sheet)
- workbook.createSheet("Test1");// 创建工作表 (Sheet)
- workbook.createSheet("Test2");// 创建工作表 (Sheet)
- workbook.createSheet("Test3");// 创建工作表 (Sheet)
- workbook.setActiveSheet(2);// 设置默认工作表
13. 重命名
- HSSFWorkbook workbook = new HSSFWorkbook();// 创建 Excel 文件 (Workbook)
- workbook.createSheet("Test0");// 创建工作表 (Sheet)
- workbook.createSheet("Test1");// 创建工作表 (Sheet)
- workbook.createSheet("Test2");// 创建工作表 (Sheet)
- workbook.createSheet("Test3");// 创建工作表 (Sheet)
- workbook.setSheetName(2, "1234");// 重命名工作表
14. 调整表单显示比例
- HSSFWorkbook workbook = new HSSFWorkbook();// 创建 Excel 文件 (Workbook)
- HSSFSheet sheet1= workbook.createSheet("Test0");// 创建工作表 (Sheet)
- HSSFSheet sheet2=workbook.createSheet("Test1");// 创建工作表 (Sheet)
- HSSFSheet sheet3=workbook.createSheet("Test2");// 创建工作表 (Sheet)
- sheet1.setZoom(1,2);//50% 显示比例
- sheet2.setZoom(2,1);//200% 显示比例
- sheet3.setZoom(1,10);//10% 显示比例
15. 显示 / 隐藏网格线
- HSSFWorkbook workbook = new HSSFWorkbook();// 创建 Excel 文件 (Workbook)
- HSSFSheet sheet1= workbook.createSheet("Test0");// 创建工作表 (Sheet)
- HSSFSheet sheet2=workbook.createSheet("Test1");// 创建工作表 (Sheet)
- sheet1.setDisplayGridlines(false);// 隐藏 Excel 网格线, 默认值为 true
- sheet2.setGridsPrinted(true);// 打印时显示网格线, 默认值为 false
16. 遍历 Sheet
- String filePath = "d:\\users\\lizw\\ 桌面 \\POI\\sample.xls";
- FileInputStream stream = new FileInputStream(filePath);
- HSSFWorkbook workbook = new HSSFWorkbook(stream);// 读取现有的 Excel
- HSSFSheet sheet= workbook.getSheet("Test0");// 得到指定名称的 Sheet
- for (Row row : sheet)
- {
- for (Cell cell : row)
- {
- System.out.print(cell + "\t");
- }
- System.out.println();
- }
其他详见: http://www.cnblogs.com/LiZhiW/p/4313789.html
POI HSSFColor 中 Excel 表格颜色对照表
http://blog.csdn.net/qq_27937043/article/details/72779442
. | HSSFColor.GREY_80_PERCENT |
. | HSSFColor.INDIGO |
. | HSSFColor.PLUM |
HSSFColor.BROWN | |
. | HSSFColor.OLIVE_GREEN |
. | HSSFColor.DARK_GREEN |
. | HSSFColor.SEA_GREEN |
. | HSSFColor.DARK_TEAL |
. | HSSFColor.GREY_40_PERCENT |
. | HSSFColor.BLUE_GREY |
. | HSSFColor.ORANGE |
. | HSSFColor.LIGHT_ORANGE |
. | HSSFColor.GOLD |
. | HSSFColor.LIME |
. | HSSFColor.AQUA |
. | HSSFColor.LIGHT_BLUE |
. | HSSFColor.TAN |
. | HSSFColor.LAVENDER |
. | HSSFColor.ROSE |
. | HSSFColor.PALE_BLUE |
. | HSSFColor.LIGHT_YELLOW |
. | HSSFColor.LIGHT_GREEN |
. | HSSFColor.LIGHT_TURQUOISE |
. | HSSFColor.SKY_BLUE |
. | HSSFColor.BLUE |
. | HSSFColor.TEAL |
. | HSSFColor.DARK_RED |
. | HSSFColor.VIOLET |
. | HSSFColor.TURQUOISE |
. | HSSFColor.YELLOW |
. | HSSFColor.PINK |
. | HSSFColor.DARK_BLUE |
. | HSSFColor.LIGHT_CORNFLOWER_BLUE |
. | HSSFColor.ROYAL_BLUE |
. | HSSFColor.CORAL |
. | HSSFColor.ORCHID |
. | HSSFColor.LIGHT_TURQUOISE |
. | HSSFColor.LEMON_CHIFFON |
. | HSSFColor.PLUM |
. | HSSFColor.CORNFLOWER_BLUE |
. | HSSFColor.GREY_50_PERCENT |
. | HSSFColor.GREY_25_PERCENT |
. | HSSFColor.TEAL |
. | HSSFColor.VIOLET |
. | HSSFColor.DARK_YELLOW |
. | HSSFColor.DARK_BLUE |
. | HSSFColor.GREEN |
. | HSSFColor.DARK_RED |
. | HSSFColor.TURQUOISE |
. | HSSFColor.PINK |
. | HSSFColor.YELLOW |
. | HSSFColor.BLUE |
. | HSSFColor.BRIGHT_GREEN |
. | HSSFColor.RED |
. | HSSFColor.WHITE |
. | HSSFColor.BLACK |
来源: https://www.cnblogs.com/lukelook/p/8660798.html