使用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)，还需要大家的探索精神！

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()这些函数丢失掉了，鱼与熊掌不能兼得吧。 (T117)