java处理excel的2大框架：jakarta POI和JavaExcelAPI（简称JXL）
java当初把核心处理设成Unicode，带来的好处是另代码适应了多语言环境。然而由于老外的英语只有26个字母，有些情况下，一些程序员用8位的byte处理，一不小心就去掉了CJK的高位。或者是由于习惯在程序中采用硬编码，还有多种原因，使得许多java应用在CJK的处理上很烦恼。还好在POIHSSF中考虑到这个问题，可以设置encoding为双字节。
POI可以到www.apache.org下载到。编译好的jar主要有这样4个：poi包,poi Browser包,poihdf包,poi hssf例程包。实际运行时，需要有poi包就可以了。如果用Jakarta ant编译和运行，下载apacheJakarta POI的release中的src包，它里面已经为你生成好了build文件了。只要运行ant就可以了(ant的安装和使用在此不说了)。如果是用Jbuilder运行，请在新建的项目中加入poi包。以Jbuilder6为例，选择Tools菜单项的configlibraries...选项，新建一个lib。在弹出的菜单中选择poi包，如这个jakarta-poi-1.5.1-final-20020820.jar，把poi添加到jbuilder中。然后，右键点击你的项目，在project的properties菜单中path的required Libraries中，点add，添加刚才加入到jbuilder中的poi到你现在的项目中。如果你仅仅是为了熟悉POIhssf的使用，可以直接看POI的samples包中的源代码，并且运行它。hssf的各种对象都有例程的介绍。hssf提供的例程在org.apache.poi.hssf.usermodel.examples包中，共有14个，生成的目标xls都是workbook.xls。如果你想看更多的例程，可以参考hssf的Junittest cases，在poi的包的源代码中有。hssf都有测试代码。
这里只对部分例程的实现做介绍。
HSSF提供给用户使用的对象在org.apache.poi.hssf.usermodel包中,主要部分包括Excell对象，样式和格式，还有辅助操作。有以下几种对象：
HSSFWorkbook excell的文档对象
HSSFSheet excell的表单
HSSFRow excell的行
HSSFCell excell的格子单元
HSSFFont excell字体
HSSFName 名称
HSSFDataFormat 日期格式
在poi1.7中才有以下2项：
HSSFHeader sheet头
HSSFFooter sheet尾
和这个样式
HSSFCellStyle cell样式
辅助操作包括
HSSFDateUtil 日期
HSSFPrintSetup 打印
HSSFErrorConstants 错误信息表
仔细看org.apache.poi.hssf包的结构，不难发现HSSF的内部实现遵循的是MVC模型。
这里我用Rose把org.apache.poi.hssf.usermodel包中的对象反向导入并根据相互关系作了整理，详见下面两图：
图1 基本对象
从中不难可以发现每一个基本对象都关联了一个Record对象。Record对象是一个参考Office格式的相关记录。
图2 HSSFWorkbook
HSSFWorkbook即是一个Excell对象。这幅类图体现的是HSSFWorkbook和基本对象的相互关系。可见，许多对象中也建立了Workbook的引用。还需要注意的是在HSSFWorkbook和HSSFSheet中建立了log机制POILogger，而且POILogger也是使用apache Log4J实现的。
先看poi的examples包中提供的最简单的例子，建立一个空xls文件。
Java代码
- importorg.apache.poi.hssf.usermodel.HSSFWorkbook;
- importjava.io.FileOutputStream;
- importjava.io.IOException;
- public classNewWorkbook
- {
- public static voidmain(String[] args)
- throws IOException
- {
- HSSFWorkbook wb = newHSSFWorkbook();//建立新HSSFWorkbook对象
- FileOutputStream fileOut = newFileOutputStream("workbook.xls");
- wb.write(fileOut);//把Workbook对象输出到文件workbook.xls中
- fileOut.close();
- }
- }
- 通过这个例子，我们建立的是一个空白的xls文件（不是空文件）。在此基础上，我们可以进一步看其它的例子。
- importorg.apache.poi.hssf.usermodel.*;
- importjava.io.FileOutputStream;
- importjava.io.IOException;
- public classCreateCells
- {
- public static voidmain(String[] args)
- throws IOException
- {
- HSSFWorkbook wb = newHSSFWorkbook();//建立新HSSFWorkbook对象
- HSSFSheet sheet = wb.createSheet("newsheet");//建立新的sheet对象
- // Create a row and put some cells in it. Rows are0 based.
- HSSFRow row =sheet.createRow((short)0);//建立新行
- // Create a cell and put a value init.
- HSSFCell cell =row.createCell((short)0);//建立新cell
- cell.setCellValue(1);//设置cell的整数类型的值
- // Or do it on one line.
- 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.getFormat("m/d/yyh:mm"));//设置cell样式为定制的日期格式
- HSSFCell dCell=row.createCell((short)4);
- dCell.setCellValue(newDate());//设置cell为日期类型的值
- dCell.setCellStyle(cellStyle);//设置该cell日期的显示格式
- HSSFCell csCell=row.createCell((short)5);
- csCell.setEncoding(HSSFCell.ENCODING_UTF_16);//设置cell编码解决中文高位字节截断
- csCell.setCellValue("中文测试_Chinese WordsTest");//设置中西文结合字符串
- row.createCell((short)6).setCellType(HSSFCell.CELL_TYPE_ERROR);//建立错误cell
- // Write the output to a file
- FileOutputStream fileOut = newFileOutputStream("workbook.xls");
- wb.write(fileOut);
- fileOut.close();
- }
- }
- 我稍微修改了原来的examples包中的CreateCells类写了上面的功能测试类。通过这个例子，我们可以清楚的看到xls文件从大到小包括了HSSFWorkbookHSSFSheet HSSFRowHSSFCell这样几个对象。我们可以在cell中设置各种类型的值。尤其要注意的是如果你想正确的显示非欧美的字符时，尤其象中日韩这样的语言，必须设置编码为16位的即是HSSFCell.ENCODING_UTF_16，才能保证字符的高8位不被截断而引起编码失真形成乱码。
- 其他测试可以通过参考examples包中的测试例子掌握poi的详细用法，包括字体的设置，cell大小和低纹的设置等。需要注意的是POI是一个仍然在完善中的公开代码的项目，所以有些功能正在不断的扩充。如HSSFSheet的getFooter()getHeader()和setFooter(HSSFFooter hsf) setHeader(HSSFHeaderhsh)是在POI1.7中才有的，而POI1.5中就没有。运行测试熟悉代码或者使用它做项目时请注意POI的版本。
- 另外需要注意的是HSSF也有它的对xls基于事件的解析。可以参考例程中的EventExample.java。它通过实现HSSFListener完 成从普通流认知Xls中包含的内容，在apacheCocoon中的org.apache.cocoon.serialization.HSSFSerializer中用到了这个解析。因为Cocoon2是基于事件的， 所以POI为了提供快速的解析也提供了相应的事件。当然我们自己也可以实现这个事件接口。
- 因为POI还不是一个足够成熟的项目，所以有必要做进一步的开发和测试。但是它已经为我们用纯java操作ole2对象提供了可能，而且克服了ole对象调用的缺陷，提供了服务器端的Excel解决方案。
- ======================================================
- 利用Java 创建和读取Excel文档
- 为了保证示例程序的运行，必须安装Java 2sdk1.4.0 和Jakarta POI，JakartaPOI的Web站点是:http://jakarta.apache.org/poi/
- 示例1将演示如何利用Jakarta POI API 创建Excel文档。
- 示例1程序如下：
- importorg.apache.poi.hssf.usermodel.HSSFWorkbook;
- importorg.apache.poi.hssf.usermodel.HSSFSheet;
- importorg.apache.poi.hssf.usermodel.HSSFRow;
- importorg.apache.poi.hssf.usermodel.HSSFCell;
- importjava.io.FileOutputStream;
- public class CreateXL{
- public static StringoutputFile="D:/JTest/gongye.xls";
- public static voidmain(String argv[])
- {
- try
- {
- // 创建新的Excel 工作簿
- HSSFWorkbook workbook = newHSSFWorkbook();
- // 在Excel工作簿中建一工作表，其名为缺省值
- // 如要新建一名为"效益指标"的工作表，其语句为：
- // HSSFSheet sheet =workbook.createSheet("效益指标");
- HSSFSheet sheet = workbook.createSheet();
- // 在索引0的位置创建行（最顶端的行）
- HSSFRow row =sheet.createRow((short)0);
- //在索引0的位置创建单元格（左上端）
- HSSFCell cell =row.createCell((short)0);
- // 定义单元格为字符串类型
- cell.setCellType(HSSFCell.CELL_TYPE_STRING);
- // 在单元格中输入一些内容
- cell.setCellValue("增加值");
- // 新建一输出文件流
- FileOutputStream fOut = newFileOutputStream(outputFile);
- // 把相应的Excel 工作簿存盘
- workbook.write(fOut);
- fOut.flush();
- // 操作结束，关闭文件
- fOut.close();
- System.out.println("文件生成...");
- }catch(Exception e){
- System.out.println("已运行 xlCreate() : "+ e );
- }
- }
- }
- 读取Excel文档中的数据
- 示例2将演示如何读取Excel文档中的数据。假定在D盘JTest目录下有一个文件名为gongye.xls的Excel文件。
- 示例2程序如下：
- importorg.apache.poi.hssf.usermodel.HSSFWorkbook;
- importorg.apache.poi.hssf.usermodel.HSSFSheet;
- importorg.apache.poi.hssf.usermodel.HSSFRow;
- importorg.apache.poi.hssf.usermodel.HSSFCell;
- importjava.io.FileInputStream;
- public class ReadXL{
- public static StringfileToBeRead="D:/JTest/gongye.xls";
- public static voidmain(String argv[]){
- try{
- // 创建对Excel工作簿文件的引用
- HSSFWorkbook workbook = newHSSFWorkbook(newFileInputStream(fileToBeRead));
- // 创建对工作表的引用。
- //本例是按名引用（让我们假定那张表有着缺省名"Sheet1"）
- HSSFSheet sheet =workbook.getSheet("Sheet1");
- // 也可用getSheetAt(intindex)按索引引用，
- // 在Excel文档中，第一张工作表的缺省索引是0，
- // 其语句为：HSSFSheet sheet =workbook.getSheetAt(0);
- // 读取左上端单元
- HSSFRow row =sheet.getRow(0);
- HSSFCell cell =row.getCell((short)0);
- //输出单元内容，cell.getStringCellValue()就是取所在单元的值
- System.out.println("左上端单元是： " +cell.getStringCellValue());
- }catch(Exception e){
- System.out.println("已运行xlRead() : " +e );
- }
- }
- }
- 设置单元格格式
- 在这里，我们将只介绍一些和格式设置有关的语句，我们假定workbook就是对一个工作簿的引用。在Java
- 中，第一步要做的就是创建和设置字体和单元格的格式，然后再应用这些格式：
- 1、创建字体，设置其为红色、粗体：
- HSSFFont font = workbook.createFont();
- font.setColor(HSSFFont.COLOR_RED);
- font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);
- 2、创建格式
- HSSFCellStyle cellStyle=workbook.createCellStyle();
- cellStyle.setFont(font);
- 3、应用格式
- HSSFCell cell =row.createCell((short)0);
- cell.setCellStyle(cellStyle);
- cell.setCellType(HSSFCell.CELL_TYPE_STRING);
- cell.setCellValue("标题");
- 总之，如本篇文章所演示的一样，Java程序员不必担心Excel工作表中的数据了，利用Jakarta POIAPI，
- 我们就可以轻易的在程序中存取Excel文档。
- ==============================================
- 首先说说现在我所知道的Java编辑Excel文件的两大开源工具：
- jakartaPOI和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下的PageBreakRecordrowBreaks这个变量在搞鬼，如果Sheet里原来没有分页符，开发这个模块的那位兄台忘了为这个对象new实例，所以只能我们先手工给Excel插入一个分页符来触发POI为rowBreaks创建实例。
- 2、如何拷贝行
- 我在gmane.org的POI用户论坛翻遍了每个相关的帖子，找遍了api，也没看到一个拷贝行的方法，没办法，只能自己写：
- //注：this.fWorkbook是一个HSSHWorkbook，请自行在外部new
- public voidcopyRows
- (String pSourceSheetName,
- String pTargetSheetName,
- int pStartRow, intpEndRow,
- 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)
- {
- caseHSSFCell.CELL_TYPE_BOOLEAN:
- targetCell.setCellValue(sourceCell.getBooleanCellValue());
- break;
- caseHSSFCell.CELL_TYPE_ERROR:
- targetCell.setCellErrorValue(sourceCell.getErrorCellValue());
- break;
- caseHSSFCell.CELL_TYPE_FORMULA:
- //parseFormula这个函数的用途在后面说明
- targetCell.setCellFormula(parseFormula(sourceCell.getCellFormula()));
- break;
- caseHSSFCell.CELL_TYPE_NUMERIC:
- targetCell.setCellValue(sourceCell.getNumericCellValue());
- break;
- caseHSSFCell.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(StringpPOIFormula)
- {
- final String cstReplaceString ="ATTR(semiVolatile)";//$NON-NLS-1$
- StringBuffer result =null;
- int index;
- result = newStringBuffer();
- index =pPOIFormula.indexOf(cstReplaceString);
- if (index >=0)
- {
- result.append(pPOIFormula.substring(0,index));
- result.append(pPOIFormula.substring(index +cstReplaceString.length()));
- }
- else
- {
- result.append(pPOIFormula);
- }
- returnresult.toString();
- }
- 至于为什么会出现ATTR(semiVolatile)，还需要大家的探索精神！
- 4、向Excel写入图片的问题。
- 我上POI论坛查相关帖子，得到两种结论：
- 1、不支持写入图片；
- 2、支持写入图片，通过EscherGraphics2d这个Class实现。于是我就去查EscherGraphics2d这个Class，发现这个Class提供了N个drawImage方法，喜出望外的我开始写代码，结果调了一天，一直看不到效果，黔驴技穷的我在万般无奈下只好跟踪进drawImage这个函数内部，经过N个函数调用后在最底层函数发现了最终答案：
- public booleandrawImage(Image image, intdx1, int dy1,int dx2, intdy2, int sx1,int sy1,
- int sx2, intsy2, Color bgColor, ImageObserverimageobserver)
- {
- if (logger.check( POILogger.WARN))
- logger.log(POILogger.WARN,"drawImage() notsupported");
- returntrue;
- }
- 所以我强烈建议大家，以后使用第三方开发包一定尽量下载它的源代码，这样你在碰到问题时，看看它的的内部是怎么实现的，很多时候就可以不必重蹈我的覆辙了。既然POI不能写入图片，那我们只能把目光投向JXL，我用JXL写入图片功能是实现了，付出的代价是now()和today()这些函数丢失掉了，鱼与熊掌不能兼得吧。