Apache POI使用详解

最新推荐文章于 2024-07-22 16:44:01 发布

山峰之巅ZF

最新推荐文章于 2024-07-22 16:44:01 发布

阅读量391

点赞数 3

文章标签： POI Excel Java

Apache POI使用详解

1、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	打印

2、Excel的基本操作

(1)创建Workbook和Sheet

 public class Test00
    {
        public static void main(String[] args) throws IOException
        {
            String filePath="d:\\users\\lizw\\桌面\\POI\\sample.xls";//文件路径
            HSSFWorkbook workbook = new HSSFWorkbook();//创建Excel文件(Workbook)
            HSSFSheet sheet = workbook.createSheet();//创建工作表(Sheet)
            sheet = workbook.createSheet("Test");//创建工作表(Sheet)
            FileOutputStream out = new FileOutputStream(filePath);
            workbook.write(out);//保存Excel文件
            out.close();//关闭文件流
            System.out.println("OK!");
        }
    }

(2)创建单元格

    HSSFSheet sheet = workbook.createSheet("Test");// 创建工作表(Sheet)
    HSSFRow row = sheet.createRow(0);// 创建行,从0开始
    HSSFCell cell = row.createCell(0);// 创建行的单元格,也是从0开始
    cell.setCellValue("李志伟");// 设置单元格内容
    row.createCell(1).setCellValue(false);// 设置单元格内容,重载
    row.createCell(2).setCellValue(new Date());// 设置单元格内容,重载
    row.createCell(3).setCellValue(12.345);// 设置单元格内容,重载

(3)创建文档摘要信息

    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测试文档");//备注

这里写图片描述
(4)创建批注

    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个单元格的行号

参数	说明
dx1	第1个单元格中x轴的偏移量
dy1	第1个单元格中y轴的偏移量
dx2	第2个单元格中x轴的偏移量
dy2	第2个单元格中y轴的偏移量
col1	第1个单元格的列号
row1	第1个单元格的行号
col2	第2个单元格的列号
row2	第2个单元格的行号

(5)创建页眉和页脚

    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 当前页号

代码	标签	说明
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	当前页号

3、Excel的单元格操作

(1)设置格式

    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静态方法更加直接一些。

(2)合并单元格

    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 区域中最后一个单元格的列号

提示：即使你没有用CreateRow和CreateCell创建过行或单元格，也完全可以直接创建区域然后把这一区域合并，Excel的区域合并信息是单独存储的，和RowRecord、ColumnInfoRecord不存在直接关系。

参数	说明
firstRow	区域中第一个单元格的行号
lastRow	区域中最后一个单元格的行号
firstCol	区域中第一个单元格的列号
lastCol	区域中最后一个单元格的列号

(3)单元格对齐

    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;

(4)使用边框
边框和其他单元格设置一样也是调用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);

这里写图片描述
其中边框类型分为以下几种：

这里写代码片

(5)设置字体

    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

(6)背景和纹理

    HSSFCellStyle style = workbook.createCellStyle();
    style.setFillForegroundColor(HSSFColor.GREEN.index);//设置图案颜色
    style.setFillBackgroundColor(HSSFColor.RED.index);//设置图案背景色
    style.setFillPattern(HSSFCellStyle.SQUARES);//设置图案样式
    cell.setCellStyle(style);

这里写图片描述
图案样式及其对应的值：

(7)设置宽度和高度

    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.setDefaultColumnWidth、HSSFSheet.setDefaultRowHeight和HSSFSheet.setDefaultRowHeightInPoints方法设置默认的列宽或行高

(8)判断单元格是否为日期
判断单元格是否为日期类型，使用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

文章转载自：
https://www.cnblogs.com/LiZhiW/p/4313789.html#_labelTop