使用POI操作Excel的几点注意事项

首先说说现在我所知道的Java编辑Excel文件的两大开源工具：

jakarta POI和JavaExcelAPI（简称JXL），这两套工具我都试用了一这段时间，感觉各有优劣吧。POI在某些细节有些小Bug并且不支持写入图片，其他方面都挺不错的；

JXL就惨了，除了支持写入图片外，我暂时看不到它比POI好的地方，我碰到的主要的问题就是对公式支持不是很好，很多带有公式的Excel文件用JXL打开后，公式就丢失了（比如now(),today()），在网上看到其他大虾评论说JXL写入公式也有问题，另外，JXL操作Excel文件的效率比POI低一点。经过比较后，我选择了POI开发我的项目。

现在我要做的东西基本完成啦，我把这段时间使用POI的一些心得总结出来，希望能对和我遇到相同问题的朋友有所帮助，至于POI基本的使用方法，自己去看文档吧。

1、设置分页符的bug

POI里的HSSFSheet类提供了setRowBreak方法可以设置Sheet的分页符。

Bug：如果你要设置分页符的Sheet是本来就有的，并且你没有在里面插入过分页符，那么调用setRowBreak时POI会抛出空指针的异常。

解决方法：在Excel里给这个sheet插入一个分页符，用POI打开后再把它删掉，然后你就可以随意插入分页符了。

如果sheet是由POI生成的则没有这个问题。我跟踪了setRowBreak的源代码，发现是Sheet.Java下的PageBreakRecord rowBreaks这个变量在搞鬼，如果Sheet里原来没有分页符，开发这个模块的那位兄台忘了为这个对象new实例，所以只能我们先手工给Excel插入一个分页符来触发POI为rowBreaks创建实例。

2、如何拷贝行

我在gmane.org的POI用户论坛翻遍了每个相关的帖子，找遍了api，也没看到一个拷贝行的方法，没办法，只能自己写：

//注：this.fWorkbook是一个HSSHWorkbook，请自行在外部new
    public void copyRows
    (String pSourceSheetName, 
    String pTargetSheetName, 
    int pStartRow, int pEndRow,
    int pPosition)
    {
    HSSFRow sourceRow = null;
    HSSFRow targetRow = null;
    HSSFCell sourceCell = null;
    HSSFCell targetCell = null;
    HSSFSheet sourceSheet = null;
    HSSFSheet targetSheet = null;
    Region region = null;
    int cType;
    int i;
    short j;
    int targetRowFrom;
    int targetRowTo;
    
    if ((pStartRow == -1) || (pEndRow == -1))
    {
      return;
    }
    sourceSheet = this.fWorkbook.getSheet(pSourceSheetName);
    targetSheet = this.fWorkbook.getSheet(pTargetSheetName);
    //拷贝合并的单元格
    for (i = 0; i < sourceSheet.getNumMergedRegions(); i++)
    {
    region = sourceSheet.getMergedRegionAt(i);
    if ((region.getRowFrom() >= pStartRow) && (region.getRowTo() <= pEndRow))
    {
    targetRowFrom = region.getRowFrom() - pStartRow + pPosition;
    targetRowTo = region.getRowTo() - pStartRow + pPosition;
    region.setRowFrom(targetRowFrom);
    region.setRowTo(targetRowTo);
    targetSheet.addMergedRegion(region);
    }
    } 
    //设置列宽
    for (i = pStartRow; i <= pEndRow; i++)
    {
    sourceRow = sourceSheet.getRow(i);
    if (sourceRow != null)
    {
    for (j = sourceRow.getFirstCellNum(); j < sourceRow.getLastCellNum(); j++)
    {
    targetSheet.setColumnWidth(j, sourceSheet.getColumnWidth(j));
    }
    break;
    }
    }
    //拷贝行并填充数据
    for (;i <= pEndRow; i++)
    {
    sourceRow = sourceSheet.getRow(i);
    if (sourceRow == null)
    {
    continue;
    }
    targetRow = targetSheet.createRow(i - pStartRow + pPosition);
    targetRow.setHeight(sourceRow.getHeight());
    for (j = sourceRow.getFirstCellNum(); j < sourceRow.getLastCellNum(); j++)
    {
    sourceCell = sourceRow.getCell(j);
    if (sourceCell == null)
    {
    continue;
    }
    targetCell = targetRow.createCell(j);
    targetCell.setEncoding(sourceCell.getEncoding());
    targetCell.setCellStyle(sourceCell.getCellStyle());
    cType = sourceCell.getCellType();
    targetCell.setCellType(cType);
    switch (cType)
    {
    case HSSFCell.CELL_TYPE_BOOLEAN: 
    targetCell.setCellValue(sourceCell.getBooleanCellValue());
    break;
    case HSSFCell.CELL_TYPE_ERROR:
    targetCell.setCellErrorValue(sourceCell.getErrorCellValue());
    break;            
    case HSSFCell.CELL_TYPE_FORMULA:
    //parseFormula这个函数的用途在后面说明
    targetCell.setCellFormula(parseFormula(sourceCell.getCellFormula()));
    break;
    case HSSFCell.CELL_TYPE_NUMERIC:
    targetCell.setCellValue(sourceCell.getNumericCellValue());
    break;
    case HSSFCell.CELL_TYPE_STRING:
    targetCell.setCellValue(sourceCell.getStringCellValue());
    break;
    }
    }
    }
    }

这个函数有两个问题暂时无法解决：

a、只能在同一个Workbook里面使用，跨Workbook总是拷不过去，不知道为什么？

b、由于在拷贝行时也把行高也拷过去了，如果往这些单元格里写入的数据长度超过单元格长度，那么他们不会自动调整行高！

3、公式的问题

POI对Excel公式的支持是相当好的，但是我发现一个问题，如果公式里面的函数不带参数，比如now()或today()，那么你通过getCellFormula()取出来的值就是now(ATTR(semiVolatile))和today(ATTR(semiVolatile))，这样的值写入Excel是会出错的，这也是我上面copyRow的函数在写入公式前要调用parseFormula的原因，parseFormula这个函数的功能很简单，就是把ATTR(semiVolatile)删掉，我把它的代码贴出来：

private String parseFormula(String pPOIFormula)
    {
    final String cstReplaceString = "ATTR(semiVolatile)"; //$NON-NLS-1$
    StringBuffer result = null;
    int index;
    
    result = new StringBuffer();
    index = pPOIFormula.indexOf(cstReplaceString);
    if (index >= 0)
    {
    result.append(pPOIFormula.substring(0, index));
    result.append(pPOIFormula.substring(index + cstReplaceString.length()));
    }
    else
    {
    result.append(pPOIFormula);
    }
    
    return result.toString();
    }

至于为什么会出现ATTR(semiVolatile)，还需要大家的探索精神！

4、向Excel写入图片的问题。

我上POI论坛查相关帖子，得到两种结论：

1、不支持写入图片；

2、支持写入图片，通过EscherGraphics2d这个Class实现。于是我就去查EscherGraphics2d这个Class，发现这个Class提供了N个drawImage方法，喜出望外的我开始写代码，结果调了一天，一直看不到效果，黔驴技穷的我在万般无奈下只好跟踪进drawImage这个函数内部，经过N个函数调用后在最底层函数发现了最终答案：

 

public boolean drawImage(Image image, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1,
   int sx2, int sy2, Color bgColor, ImageObserver imageobserver)
   {
   if (logger.check( POILogger.WARN ))
   logger.log(POILogger.WARN,"drawImage() not supported");
   return true;
   }

所以我强烈建议大家，以后使用第三方开发包一定尽量下载它的源代码，这样你在碰到问题时，看看它的的内部是怎么实现的，很多时候就可以不必重蹈我的覆辙了。既然POI不能写入图片，那我们只能把目光投向JXL，我用JXL写入图片功能是实现了，付出的代价是now()和today()这些函数丢失掉了，鱼与熊掌不能兼得吧。