记一次POI升级版本踩坑

文章讲述了在升级项目中从poi3.10版本到5.2.1版本时遇到的问题,包括对旧版本jar的依赖清理、新版本引入的ooxml-schemas和ThemeDocument冲突,以及强调了直接从官网寻找升级解决方案的重要性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

由于项目久远,加上二开项目且业务复杂等方面原因。使用的poi版本比较老,一次项目漏洞扫描发现poi的jar的漏洞问题,于是升级项目的poi版本。
按照漏洞清单的建议升级了版本,太过于粗心大意的直接升级版本。此前并未有过相关升级的经验,直接导致没有按照官方给的建议升级版本所需要的jar包。
测试方面也过于简陋的测试,最终导致上线之后才发现问题。

升级前:
poi.jar(3.10-FINAL)
poi-ooxml.jar(3.10-FINAL)
poi-scratchpad.jar(3.10-FINAL)
poi-excelant.jar(3.10-FINAL)
org.apache.poi.xwpf.converter.core.jar(1.0.5)
org.apache.poi.xwpf.converter.xhtml.jar(1.0.5)
排除了:
curvesapi.jar
xmlbeans.jar


升级后:
org.apache.poi.xwpf.converter.core.jar(1.0.6)
org.apache.poi.xwpf.converter.xhtml.jar(1.0.6)
ooxml-schemas.jar(1.4)
poi.jar(5.2.1)
poi-ooxml.jar(5.2.1)
poi-scratchpad.jar(5.2.1)
poi-excelant.jar(5.2.1)
poi-ooxml-schemas.jar(4.1.2)

排除了:
curvesapi.jar
xmlbeans.jar
SparseBitSet.jar
poi-ooxml-lite.jar
commons-math3.jar
commons-collections4.jar
log4j-api.jar

此时回过头来看升级的jar发现ooxml-schemas.jar、poi-ooxml-schemas.jar完全是不用,但是当时测试的时候并未发现什么问题,并没有下载生成excel模板时的兼容性问题。
后续在修复版本升级带来的问题时,反复测试才发现ooxml-schemas.jar、poi-ooxml-schemas.jar和poi.5.2.1版本有类(ThemeDocument)冲突问题。

最终升级版本:
commons-codec-1.15.jar
commons-collections4-4.4.jar
commons-io-2.11.0.jar
commons-math3-3.6.1.jar
log4j-api-2.17.1.jar
SparseBitSet-1.2.jar
commons-compress-1.21.jar
commons-logging-1.2.jar
curvesapi-1.07.jar
slf4j-api-1.7.36.jar
xmlbeans-5.0.3.jar
poi-5.2.1.jar
poi-excelant-5.2.1.jar
poi-ooxml-5.2.1.jar
poi-ooxml-full-5.2.1.jar
poi-scratchpad-5.2.1.jar

pom引入:
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-excelant</artifactId>
    <version>5.2.1</version>
</dependency>
    引入poi-excelant带入以下相关的jar,使用Maven Helper去掉重复的jar即可
     ant(1.10.12)
     poi-ooxml(5.2.1) 
         curvesapi(1.07)
         commons-io(2.11.0)
         commons-compress(1.21)
         commons-collections4(4.4)
         log4j-api(2.17.1)
         poi(5.2.1)  
            SparseBitSet(1.2)
            commons-codec(1.15)
            commons-io(2.11.0)
            commons-collections4(4.4)
            log4j-api(2.17.1)
            commons-math3(3.6.1)
         poi-ooxml-lite(5.2.1)
         xmlsec(2.3.0)
         xmlbeans(5.0.3)
         
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml-full</artifactId>
    <version>5.2.1</version>
    <exclusions>
        <exclusion>
            <artifactId>xmlbeans</artifactId>
            <groupId>org.apache.xmlbeans</groupId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-scratchpad</artifactId>
    <version>5.2.1</version>
    <exclusions>
        <exclusion>
            <artifactId>log4j-api</artifactId>
            <groupId>org.apache.logging.log4j</groupId>
        </exclusion>
        <exclusion>
            <artifactId>commons-math3</artifactId>
            <groupId>org.apache.commons</groupId>
        </exclusion>
    </exclusions>
</dependency>


这时候去官网找到5.2.1版本所需的jar包升级,又发现问题不能初始化类的问题(Could not initialize class org.openxmlformats.schemas.drawingml.x2006.main.ThemeDocument),
此时在代码里搜索才发现poi-ooxml-lite-5.2.1.jar和poi-ooxml-full-5.2.1.jar都有类ThemeDocument,去掉了poi-ooxml-lite-5.2.1.jar后正常。如果项目里引入了xbean-fixed会入xmlbeans冲突,

切记:遇到升级版本问题切勿百度搜索相关解决方案,直接官网找解决方案。

切记:遇到升级版本问题切勿百度搜索相关解决方案,直接官网找解决方案。

切记:遇到升级版本问题切勿百度搜索相关解决方案,直接官网找解决方案。

java_POI教程.pdf javaPOI操作Excel文件.doc POI_API帮助文档.chm poi-bin-3.9-20121203.tar.gz poi帮助.docx POI中文帮助文档.pdf poi中文教程.doc第一章 POI简介 实际的开发中,表现层的解决方案虽然有多样,但是IE浏览器已成为最多人使用的浏览器,因为大家都用Windows。在企业办公系统中,常常有客户这样子要求:你要把我们的报表直接用Excel打开(电信系统、银行系统)。或者是:我们已经习惯用Excel打印。 workbook(HSSFWorkbook),一个workbook可以有多个sheet(HSSFSheet)组成,一个sheet是由多个row(HSSFRow)组成,一个row是由多个cell(HSSFCell)组成。 POI可以到www.apache.org下载到。实际运行时,需要有poi包就可以了。HSSF提供给用户使用的对象在rg.apache.poi.hssf.usermodel包中,主要部分包括Excel对象,样式和格式,还有辅助操作。有以下几种对象: HSSFWorkbook excel的文档对象 HSSFSheet excel的表单 HSSFRow excel的行 HSSFCell excel的格子单元 HSSFFont excel字体 HSSFDataFormat 日期格式 在poi1.7中才有以下2项: HSSFHeader sheet头 HSSFFooter sheet尾(只有打印的时候才能看到效果) 和这个样式 HSSFCellStyle cell样式 辅助操作包括 HSSFDateUtil 日期 HSSFPrintSetup 打印 HSSFErrorConstants 错误信息表 以下可能需要使用到如下的类 import org.apache.poi.hssf.usermodel.HSSFCell; import org.apache.poi.hssf.usermodel.HSSFCellStyle; import org.apache.poi.hssf.usermodel.HSSFDataFormat; import org.apache.poi.hssf.usermodel.HSSFFont; import org.apache.poi.hssf.usermodel.HSSFRow; import org.apache.poi.hssf.usermodel.HSSFSheet; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.hssf.util.HSSFColor; 先看poi的examples包中提供的最简单的例子,建立一个空xls文件。 import java.io.FileOutputStream; import java.io.IOException; import org.apache.poi.hssf.usermodel.HSSFWorkbook; public class ExcelSample1 { public static void main(String[] args) throws IOException { //创建一个excel文件 HSSFWorkbook wb= new HSSFWorkbook(); FileOutputStream fileOut= new FileOutputStream("c:\\workbook.xls"); // FileOutputStream fileOut= new FileOutputStream("c:/workbook.xls"); wb.write(fileOut); fileOut.close(); } } 通过这个例子,我们在c盘下建立的是一个空白的xls文件(不是空文件)。在此基础上,我们可以进一步看其它的例子。 import org.apache.poi.hssf.usermodel.*; import java.io.FileOutputStream; import java.io.IOException; public class CreateCells { public static void main(String[] args) throws IOException { HSSFWorkbook wb = new HSSFWorkbook(); //建立新HSSFWorkbook对象 HSSFSheet sheet = wb.createSheet("new sheet"); //建立新的sheet对象 HSSFRow row = sheet.createRow((short)0); //在sheet里创建一行,参数为行号(第一行,此处可想象成数组) HSSFCell cell = row.createCell((short)0); //在row里建立新cell(单元格),参数为列号(第一列) cell.setCellvalue(1); //设置cell的整数类型的值 row.createCell((short)1).setCellvalue(1.2); //设置cell浮点类型的值 row.createCell((short)2).setCellvalue("test"); //设置cell字符类型的值 row.createCell((short)3).setCellvalue(true); //设置cell布尔类型的值 HSSFCellStyle cellStyle = wb.createCellStyle(); //建立新的cell样式 cellStyle.setDataFormat(HSSFDataFormat. getBuiltinFormat("m/d/yy h:mm")); //设置cell样式为定制的日期格式 HSSFCell dCell =row.createCell((short)4); dCell.setCellvalue(new Date()); //设置cell为日期类型的值 dCell.setCellStyle(cellStyle); //设置该cell日期的显示格式 HSSFCell csCell =row.createCell((short)5); csCell.setEncoding(HSSFCell.ENCODING_UTF_16); //设置cell编码解决中文高位字节截断 csCell.setCellvalue("中文测试_Chinese Words Test"); //设置中西文结合字符串 row.createCell((short)6).setCellType(HSSFCell.CELL_TYPE_ERROR); //建立错误cell FileOutputStream fileOut = new FileOutputStream("workbook.xls"); wb.write(fileOut); fileOut.close(); } } 通过这个例子,我们可以清楚的看到xls文件从大到小包括了HSSFWorkbook HSSFSheet HSSFRow HSSFCell这样几个对象。我们可以在cell中设置各种类型的值。 尤其要注意的是如果你想正确的显示非欧美的字符时,尤其象中日韩这样的语言,必须设置编码为16位的即是HSSFCell.ENCODING_UTF_16,才能保证字符的高8位不被截断而引起编码失真形成乱码。 其他测试可以通过参考examples包中的测试例子掌握poi的详细用法,包括字体的设置,cell大小和低纹的设置等。需要注意的是POI是一个仍然在完善中的公开代码的项目,所以有些功能正在不断的扩充。 感觉上面的操作比较的繁琐,然后就自己写了一个方法。这个方法不需要事先创建row和cell,直接进行cteateCell就可以了,在程序中会自动进行判断,如果不存在的话会创建。 private static void cteateCell(HSSFWorkbook wb,HSSFRow row,short col,short align,String val){ HSSFCell cell = row.createCell(col); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue(val); HSSFCellStyle cellstyle = wb.createCellStyle(); cellstyle.setAlignment(align); cell.setCellStyle(cellstyle); } 对里面的几个参数的说明: short col 应该是你的cell单元格的位置也就是列号; short align 应该是你的对齐方式; String val 应该是你单元格里面要添加的值; 具体的调用如下: HSSFRow row = sheet.createRow((short)1); cteateCell(wb,row,(short)0,HSSFCellStyle.ALIGN_CENTER_SELECTION,"SampleID"); 在上边的例子里我们看到了要设置一个单元格里面信息的格式(例如,要将信息居中)设置的操作如下: HSSFCellStyle cellstyle = wb.createCellStyle(); cellstyle.setAlignment(HSSFCellStyle.ALIGN_CENTER_SELECTION); cell.setCellStyle(cellstyle); 还有我们我们经常会用到的合并单元格,在这里我们也有这样的操作,代码如下: sheet.addMergedRegion(new Region(1,(short)1,2,(short)4)); 这里面我们还要介绍一个经常会遇到的问题,就是怎么来冻结一个窗口。poi也为我们集成了这样的事情了。代码如下: sheet.createFreezePane(1,2);  在这里我们需要注意的是 一、 该方法是在一个具体的sheet里面来进行操作。 二、 方法createFreezepane;有2个参数。前一个参数代表列;后一个参数代表行。 上边的代码对应的excel文件如下: 我么在画面上看到了明显的两条黑线,这就是冻结的窗口。 然后我们来看一个完整的STRUTS的小例子,在这个例子里面我们要做的事情是要模拟移动公司的网上营业厅里面的一个功能,我们要把一个客户当月的通话录和各种信息查询出来,并且生成一张excel报表。首先,我们来看一下网上效果的截图。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值