POI框架开发经验小结

POI框架使用了一段时间,总结下自己的使用经验。

POI框架介绍

Apache POI是Apache软件基金会的开放源码程序库,POI提供API给Java程序对Microsoft Office格式档案读和写的功能。

1. 07版excel行的上限

2的20次方,超过这个值会报错

2. 下拉列表能包含的最多字符个数

下拉列表能包含的最多字符个数256个,超了就不显示。如果下拉列表的数据超过了256个字符,只能用函数的方式引用另一列作为数据源

3. 不同workbook类实例间不能复制样式

  This Style does not belong to the supplied Workbook Stlyes Source. Are you trying to assign a style from one workbook to the cell of a differnt workbook?
java.lang.IllegalArgumentException: This Style does not belong to the supplied Workbook Stlyes Source. Are you trying to assign a style from one workbook to the cell of a differnt workbook?
    at org.apache.poi.xssf.usermodel.XSSFCellStyle.verifyBelongsToStylesSource(XSSFCellStyle.java:120)
    at org.apache.poi.xssf.usermodel.XSSFCell.setCellStyle(XSSFCell.java:651)
    at org.apache.poi.xssf.usermodel.XSSFCell.copyCellFrom(XSSFCell.java:184)
    at org.apache.poi.xssf.usermodel.XSSFRow.copyRowFrom(XSSFRow.java:640)

4. 向cell设置非string类型的值

向cell设置非string类型的值时,同时要设置cell的类型。否则打开excel的时候excel会有错误提示,“数字类型以字符串形式存储”,poi这一点做的不完善。如果设置的数字类型,那么poi应该自动把单元格类型设置成数字类型才对。

 destRowCell.setCellValue(sourceRowCell.getNumericCellValue());
 destRowCell.setCellType(CellType.NUMERIC);

5. 关于autoSizeColumn(int, boolean) 方法

这个方法一定要放在excel处理的最后使用,一开始就用或者中途用达不到效果

6. 强制用户从下拉列表中取值

加了这个校验,一旦用户手动输入,excel会弹错误提示。excel有这样的特点,即使提供下拉列表,也可以手动输入值。

 XSSFDataValidation dataValidation = (XSSFDataValidation) helper.createValidation(constraint, regions);
        dataValidation.createErrorBox("输入错误", "请从下拉列表中取值");
        dataValidation.setShowErrorBox(true);

7. 设置单元格背景色

XSSFCellStyle errorCellStyle = errorBook.createCellStyle();
errorCellStyle.setFillForegroundColor(new XSSFColor(Color.RED));
errorCellStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND);

setFillBackgroundColor,这个方式不起效果。

8. 设置row默认高度

org.apache.poi.xssf.usermodel.XSSFSheet#setDefaultRowHeightInPoints不可靠。在mac上,excel文件和其他文件压缩zip包之后,填了数据的行,会恢复设置前的excel本身的默认高度。

9. 设置列宽

org.apache.poi.xssf.usermodel.XSSFSheet#autoSizeColumn(int),在单元格有中文的情况下,会出问题(mac上2016版不会有问题),正确的方式是取出字符串的字节数,再乘以256

 xssfSheet.setColumnWidth(columnIndex, string.getBytes().length * 256);

10. excel支持的最大行数和列数

在POI的这个类里有定义,包括03版一下的和07版以上的

org.apache.poi.ss.SpreadsheetVersion

11. sheet名字的最大长度

30个字符,超了就会被excel自动截断。并且名字里不能包括“\”, “/”, “[“, “]”, “*”, “?” 。建议使用poi自带工具方法设置sheet的name, 这个方法会自动过滤非法字符:

org.apache.poi.ss.util.WorkbookUtil#createSafeSheetName(java.lang.String, char)

12. XssfWorkBook解析Ole2格式的xls文件会报如下异常。部分2007版excel用户也会报如下错误,可能是excel客户端的问题

org.apache.poi.openxml4j.exceptions.OLE2NotOfficeXmlFileException: The supplied data appears to be in the OLE2 Format. You are calling the part of POI that deals with OOXML (Office Open XML) Documents. You need to call a different part of POI to process this data (eg HSSF instead of XSSF)

03版一下的excel文件用HssfWorkBook打开,07版以上的excel文件则需要用XssfWorkBook类打开,不能串。

13. 日期数据的判断与解析

日期数据是org.apache.poi.ss.usermodel.CellType#NUMERIC的一个特例,当一个单元格是Numeric类型的时候,再用下面的方法判断是否是日期类型

if (DateUtil.isCellDateFormatted(cell)) {
    Date dateCellValue = cell.getDateCellValue();
}

DateUtil全路径: org.apache.poi.ss.usermodel.DateUtil

14. 平台兼容性问题

这里指的是mac/windows平台的兼容性。我的开发机是mac的,用poi开发出来的excel模板的样式在mac上调的十分漂亮。但是在测试同学的windows机器上特别难看,为了解决windows上样式的问题,我不得不装一台windows虚拟机,一点一点的调windows上的样式问题。

15. 整型溢出问题

excel单元格里设置数字的时候,excel会将数字存成double类型。亲测当数字超过15位的时候,数据会出现精度丢失,更长的时候,最后将以科学计数法表示。如果希望完整的保存一个大数字,可以通过将单元格设置成字符型来绕过。后端处理的时候再转成BigDecimal类型就可以了。

excel_digit

发布了232 篇原创文章 · 获赞 291 · 访问量 139万+
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 大白 设计师: CSDN官方博客

分享到微信朋友圈

×

扫一扫,手机浏览