java中使用poi导出Excel详解

ava当初把核心处理设成Unicode，带来的好处是代码适应了多语言环境。然而由于老外的英语只有26个字母，有些情况下，一些程序员用8 位的byte处

理，一不小心就去掉了CJK的高位。或者是由于习惯在程序中采用硬编码，还有多种原因，使得许多java应用在CJK的处理上很烦恼。还好 在POI HSSF中考虑

到这个问题，可以设置encoding为双字节。POI可以到www.apache.org下载到。

ava当初把核心处理设成Unicode，带来的好处是代码适应了多语言环境。然而由于老外的英语只有26个字母，有些情况下，一些程序员用8 位的byte处

理，一不小心就去掉了CJK的高位。或者是由于习惯在程序中采用硬编码，还有多种原因，使得许多java应用在CJK的处理上很烦恼。还好 在POI HSSF中考虑

到这个问题，可以设置encoding为双字节。POI可以到www.apache.org下载到。

HSSF提供给用户使用的对象在org.apache.poi.hssf.usermodel包中,主要部分包括Excell对象，样式和格式，还有辅助操作。有以下几种对象：

HSSFWorkbook excell的文档对象
HSSFSheet excell的表单
HSSFRow excell的行
HSSFCell excell的格子单元
HSSFFont excell字体
HSSFName 名称
HSSFDataFormat 日期格式

仔细看org.apache.poi.hssf包的结构，不难发现HSSF的内部实现遵循的是MVC模型。

HSSFWorkbook即是一个Excell对象。许多对象中也建立了 Workbook的引用。还需要注意的是在HSSFWorkbook和HSSFSheet中建立了log机制POILogger，

而且POILogger 也是使用apache Log4J实现的。 

先看poi的examples包中提供的最简单的例子，建立一个空xls文件。

01import org.apache.poi.hssf.usermodel.HSSFWorkbook;

02import java.io.FileOutputStream;

03import java.io.IOException;

04public classNewWorkbook{

05    publicstaticvoid main(String[] args)throwsIOException{

06 

07    HSSFWorkbook wb =new HSSFWorkbook();//建立新HSSFWorkbook对象

08    FileOutputStream fileOut =new FileOutputStream("workbook.xls");

09    wb.write(fileOut);//把Workbook对象输出到文件workbook.xls中

10    fileOut.close();

11    }

12}

通过这个例子，我们建立的是一个空白的xls文件（不是空文件）。在此基础上，我们可以进一步看其它的例子。

01import org.apache.poi.hssf.usermodel.*;

02import java.io.FileOutputStream;

03import java.io.IOException;

04public classCreateCells{

05    publicstatic void main(String[] args)throws IOException{

06 

07    HSSFWorkbook wb =new HSSFWorkbook();//建立新HSSFWorkbook对象

08    HSSFSheet sheet = wb.createSheet("new sheet");//建立新的sheet对象

09 

10    // Create a row and put some cells in it. Rows are 0 based.

11    HSSFRow row = sheet.createRow((short)0);//建立新行

12 

13    // Create a cell and put a value in it.

14    HSSFCell cell = row.createCell((short)0);//建立新cell

15    cell.setCellValue(1);//设置cell的整数类型的值

16 

17    // Or do it on one line.

18    row.createCell((short)1).setCellValue(1.2);//设置cell浮点类型的值

19    row.createCell((short)2).setCellValue("test");//设置cell字符类型的值

20    row.createCell((short)3).setCellValue(true);//设置cell布尔类型的值

21 

22    HSSFCellStyle cellStyle = wb.createCellStyle();//建立新的cell样式

23    cellStyle.setDataFormat(HSSFDataFormat.getFormat("m/d/yy h:mm"));//设置cell样式为定制的日期格式

24 

25    HSSFCell dCell =row.createCell((short)4);

26    dCell.setCellValue(newDate());//设置cell为日期类型的值

27    dCell.setCellStyle(cellStyle);//设置该cell日期的显示格式

28    HSSFCell csCell =row.createCell((short)5);

29 

30    csCell.setEncoding(HSSFCell.ENCODING_UTF_16);//设置cell编码解决中文高位字节截断

31    csCell.setCellValue("中文测试_Chinese Words Test");//设置中西文结合字符串

32    row.createCell((short)6).setCellType(HSSFCell.CELL_TYPE_ERROR);//建立错误cell

33 

34    // Write the output to a file

35    FileOutputStream fileOut =new FileOutputStream("workbook.xls");

36    wb.write(fileOut);

37    fileOut.close();

38    }

39}

稍微修改了原来的examples包中的CreateCells类写了上面的功能测试类。通过这个例子，我们可以清楚的看到xls文件从大到小包括了 HSSFWorkbook

HSSFSheet  HSSFRow HSSFCell这样几个对象。我们可以在cell中设置各种类型的值。尤其要注意的是如果你想正确的显示非欧美的字符时，尤其象

中日韩这样的语言，必须设置编码为16位的即是HSSFCell.ENCODING_UTF_16，才能保证字符的高8位不被截断而引起编码失真形成乱码。  

其他测试可以通过参考examples包中的测试例子掌握poi的详细用法，包括字体的设置，cell大小和低纹的设置等。


需要注意的是POI是一个仍然在完善中的公开代码的项目，所以有些功能正在不断的扩充。

如HSSFSheet的getFooter() getHeader()和 setFooter(HSSFFooter hsf) setHeader(HSSFHeader hsh)是在POI1.7中才有的，

而POI1.5中就没有。运行测试熟悉代码或者使用它做项目时请注意POI的版本。


另外需要注意的是HSSF也有它的对xls基于事件的解析。可以参考例程中的EventExample.java。它通过实现 HSSFListener完成从普通流认知Xls中包含

的内容，在apache Cocoon中的 org.apache.cocoon.serialization.HSSFSerializer中用到了这个解析。因为Cocoon2 是基于事件的，所以POI为了提供快速的解

析也提供了相应的事件。当然我们自己也可以实现这个事件接口。  

因为POI还不是一个足够成熟的项目，所以有必要做进一步的开发和测试。但是它已经为我们用纯java操作ole2对象提供了可能，而且克服了ole对象调用的缺陷，

提供了服务器端的Excel解决方案。  



利用Java 创建和读取Excel文档  

为了保证示例程序的运行，必须安装Java 2 sdk1.4.0 和Jakarta POI，Jakarta POI的Web站点是: http://jakarta.apache.org/poi/

示例1将演示如何利用Jakarta POI API 创建Excel 文档。  


示例1程序如下：

01import org.apache.poi.hssf.usermodel.HSSFWorkbook;

02import org.apache.poi.hssf.usermodel.HSSFSheet;

03import org.apache.poi.hssf.usermodel.HSSFRow;

04import org.apache.poi.hssf.usermodel.HSSFCell;

05import java.io.FileOutputStream;

06public classCreateXL {

07/** Excel 文件要存放的位置，假定在D盘JTest目录下*/

08    publicstatic String outputFile="D:/Test/gongye.xls";

09    publicstatic void main(String argv[]){

10        try{

11            // 创建新的Excel 工作簿

12            HSSFWorkbook workbook =new HSSFWorkbook();

13            // 在Excel工作簿中建一工作表，其名为缺省值

14            // 如要新建一名为"效益指标"的工作表，其语句为：

15            // HSSFSheet sheet = workbook.createSheet("效益指标");

16            HSSFSheet sheet = workbook.createSheet();

17            // 在索引0的位置创建行（最顶端的行）

18            HSSFRow row = sheet.createRow((short)0);

19            //在索引0的位置创建单元格（左上端）

20            HSSFCell cell = row.createCell((short)0);

21            // 定义单元格为字符串类型

22            cell.setCellType(HSSFCell.CELL_TYPE_STRING);

23            // 在单元格中输入一些内容

24            cell.setCellValue("增加值");

25            // 新建一输出文件流

26            FileOutputStream fOut =new FileOutputStream(outputFile);

27            // 把相应的Excel 工作簿存盘

28            workbook.write(fOut);

29            fOut.flush();

30            // 操作结束，关闭文件

31            fOut.close();

32            System.out.println("文件生成...");

33　       }catch(Exception e) {

34        System.out.println("已运行 xlCreate() : "+ e );

35        }

36    }

37}

读取Excel文档中的数据  

示例2将演示如何读取Excel文档中的数据。假定在D盘JTest目录下有一个文件名为gongye.xls的Excel文件。  

示例2程序如下：

01import org.apache.poi.hssf.usermodel.HSSFWorkbook;

02import org.apache.poi.hssf.usermodel.HSSFSheet;

03import org.apache.poi.hssf.usermodel.HSSFRow;

04import org.apache.poi.hssf.usermodel.HSSFCell;

05import java.io.FileInputStream;

06public classReadXL {

07/** Excel文件的存放位置。注意是正斜线*/

08public staticString fileToBeRead="D:/Test/ gongye.xls";

09public staticvoid main(String argv[]){

10        try{

11            // 创建对Excel工作簿文件的引用

12            HSSFWorkbook workbook =new HSSFWorkbook(newFileInputStream(fileToBeRead));

13            // 创建对工作表的引用。

14            // 本例是按名引用（让我们假定那张表有着缺省名"Sheet1"）

15            HSSFSheet sheet = workbook.getSheet("Sheet1");

16            // 也可用getSheetAt(int index)按索引引用，

17            // 在Excel文档中，第一张工作表的缺省索引是0，

18            // 其语句为：HSSFSheet sheet = workbook.getSheetAt(0);

19            // 读取左上端单元

20            HSSFRow row = sheet.getRow(0);

21            HSSFCell cell = row.getCell((short)0);

22            // 输出单元内容，cell.getStringCellValue()就是取所在单元的值

23            System.out.println("左上端单元是： "+ cell.getStringCellValue());

24        }catch(Exception e) {

25            System.out.println("已运行xlRead() : "+ e );

26        }

27    }

28}

设置单元格格式  

在这里，我们将只介绍一些和格式设置有关的语句，我们假定workbook就是对一个工作簿的引用。在Java  中，第一步要做的就是创建和设

置字体和单元格的格式，然后再应用这些格式：

011、创建字体，设置其为红色、粗体：

02HSSFFont font = workbook.createFont();

03font.setColor(HSSFFont.COLOR_RED);

04font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);

05 

062、创建格式

07HSSFCellStyle cellStyle= workbook.createCellStyle();

08cellStyle.setFont(font);

09 

103、应用格式

11HSSFCell cell = row.createCell((short)0);

12cell.setCellStyle(cellStyle);

13cell.setCellType(HSSFCell.CELL_TYPE_STRING);

14cell.setCellValue("标题 ");

总之，如本篇文章所演示的一样，Java程序员不必担心Excel工作表中的数据了，利用Jakarta POI API，  我们就可以轻易的在程序中存取Excel文档。  



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

jakarta POI和JavaExcelAPI（简称JXL），这两套工具我都试用了一这段时间，感觉各有优劣吧。

POI在某些细节有些小Bug并且不支持写入图片，其他方面都挺不错的；  

JXL 就惨了，除了支持写入图片外，我暂时看不到它比POI好的地方，我碰到的主要的问题就是对公式支持不是很好，

很多带有公式的Excel文件用JXL打开后，公式就丢失了（比如now(),today()），在网上看到其他大虾评论说JXL写入

公式也有问题，另外，JXL操作Excel文件的效率比 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、如何拷贝行  

api没看到一个拷贝行的方法，只能自己写：  

//注：this.fWorkbook是一个HSSHWorkbook，请自行在外部new

01public voidcopyRows(String pSourceSheetName, String pTargetSheetName, int pStartRow, intpEndRow,int pPosition){

02 

03    HSSFRow sourceRow =null;

04    HSSFRow targetRow =null;

05    HSSFCell sourceCell =null;

06    HSSFCell targetCell =null;

07    HSSFSheet sourceSheet =null;

08    HSSFSheet targetSheet =null;

09    Region region =null;

10    intcType;

11    inti;

12    shortj;

13    inttargetRowFrom;

14    inttargetRowTo;

15    if((pStartRow == -1) || (pEndRow == -1)){

16        return;

17    }

18    sourceSheet =this.fWorkbook.getSheet(pSourceSheetName);

19    targetSheet =this.fWorkbook.getSheet(pTargetSheetName);

20 

21//拷贝合并的单元格

22    for(i = 0; i < sourceSheet.getNumMergedRegions(); i++){

23        region = sourceSheet.getMergedRegionAt(i);

24        if((region.getRowFrom() >= pStartRow) && (region.getRowTo() <= pEndRow)){

25 

26        targetRowFrom = region.getRowFrom() - pStartRow + pPosition;

27        targetRowTo = region.getRowTo() - pStartRow + pPosition;

28        region.setRowFrom(targetRowFrom);

29        region.setRowTo(targetRowTo);

30        targetSheet.addMergedRegion(region);

31        }

32    }

33//设置列宽

34    for(i = pStartRow; i <= pEndRow; i++){

35        sourceRow = sourceSheet.getRow(i);

36            if(sourceRow != null){

37                for(j = sourceRow.getFirstCellNum(); j < sourceRow.getLastCellNum(); j++){

38                    targetSheet.setColumnWidth(j, sourceSheet.getColumnWidth(j));

39                    }

40            break;

41            }

42    }

43//拷贝行并填充数据

44    for(;i <= pEndRow; i++){

45        sourceRow = sourceSheet.getRow(i);

46        if(sourceRow == null){

47            continue;

48            }

49        targetRow = targetSheet.createRow(i - pStartRow + pPosition);

50        targetRow.setHeight(sourceRow.getHeight());

51        for(j = sourceRow.getFirstCellNum(); j < sourceRow.getLastCellNum(); j++){

52            sourceCell = sourceRow.getCell(j);

53                if(sourceCell == null){

54                    continue;

55                }

56        targetCell = targetRow.createCell(j);

57        targetCell.setEncoding(sourceCell.getEncoding());

58        targetCell.setCellStyle(sourceCell.getCellStyle());

59        cType = sourceCell.getCellType();

60        targetCell.setCellType(cType);

61 

62    switch(cType){

63        caseHSSFCell.CELL_TYPE_BOOLEAN:

64            targetCell.setCellValue(sourceCell.getBooleanCellValue());

65        break;

66 

67        caseHSSFCell.CELL_TYPE_ERROR:

68            targetCell.setCellErrorValue(sourceCell.getErrorCellValue());

69        break;           

70 

71        caseHSSFCell.CELL_TYPE_FORMULA:

72            //parseFormula这个函数的用途在后面说明

73            targetCell.setCellFormula(parseFormula(sourceCell.getCellFormula()));

74        break;

75 

76        caseHSSFCell.CELL_TYPE_NUMERIC:

77            targetCell.setCellValue(sourceCell.getNumericCellValue());

78        break;

79 

80        caseHSSFCell.CELL_TYPE_STRING:

81            targetCell.setCellValue(sourceCell.getStringCellValue());

82        break;

83    }

84   }

85  }

86}

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

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

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


3、公式的问题

POI对Excel公式的支持是相当好的，但是发现，如果公式里面的函数不带参数，比如now()或today()，

那么你通过 getCellFormula()取出来的值就是now(ATTR(semiVolatile))和 today(ATTR (semiVolatile))，

这样的值写入Excel是会出错的，这也是我上面copyRow的函数在写入公式前要调用 parseFormula的原因，

parseFormula这个函数的功能很简单，就是把ATTR(semiVolatile)删掉，它的代码：

01private String parseFormula(String pPOIFormula){

02 

03    finalString cstReplaceString = "ATTR(semiVolatile)";//$NON-NLS-1$

04    StringBuffer result =null;

05    intindex;

06    result = new StringBuffer();

07    index = pPOIFormula.indexOf(cstReplaceString);

08    if(index >= 0){

09        result.append(pPOIFormula.substring(0, index));

10        result.append(pPOIFormula.substring(index + cstReplaceString.length()));

11    }else{

12        result.append(pPOIFormula);

13    }

14    returnresult.toString();

15 }

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


4、向Excel写入图片的问题，两种结论：  

1、不支持写入图片；  

2、支持写入图片，通过EscherGraphics2d这个Class实现。去查EscherGraphics2d这个Class，

发现这个 Class提供了N个drawImage方法，喜出望外的我开始写代码，结果调了一天，一直看不到效果，

在万般无奈下只好跟踪进 drawImage这个函数内部，经过N个函数调用后在最底层函数发现了最终答案：

1public booleandrawImage(Image image, intdx1, int dy1, int dx2, intdy2, int sx1, int sy1,

2                        intsx2, int sy2, Color bgColor, ImageObserver imageobserver){

3    if(logger.check( POILogger.WARN ))

4        logger.log(POILogger.WARN,"drawImage() not supported");

5        returntrue;

6   }

所以建议大家，以后使用第三方开发包一定尽量下载它的源代码，这样碰到问题时，看看它的的内部是怎么实现的。

既然POI不能写入图片，那只能把目光投向JXL，用JXL写入图片功能是实现了，付出的代价是now()和today()这些函数丢失掉了。  


==========================jsp操作===============================  

<%@ page contentType="application/msexcel;charset=gb2312" %>
response.setHeader("Content-disposition","inline; filename=test1.xls");

//以上这行设定传送到前端浏览器时的档名为test1.xls，靠这一行，让前端浏览器以为接收到一个excel档


其实POI下面的几个子项目侧重不同读写 Word 的HDF正在开发当中.  XML下的FOP(http://xml.apache.org/fop/index.html)，可以输出pdf文件，也是

比较好的一个工具  

目录:  
创建一个workbook  
创建一个sheet  
创建cells  
创建日期cells  
设定单元格格式  

说明：以下可能需要使用到如下的类 

01import org.apache.poi.hssf.usermodel.HSSFCell;

02import org.apache.poi.hssf.usermodel.HSSFCellStyle;

03import org.apache.poi.hssf.usermodel.HSSFDataFormat;

04import org.apache.poi.hssf.usermodel.HSSFFont;

05import org.apache.poi.hssf.usermodel.HSSFRow;

06import org.apache.poi.hssf.usermodel.HSSFSheet;

07import org.apache.poi.hssf.usermodel.HSSFWorkbook;

08import org.apache.poi.hssf.util.HSSFColor;

09 

10 

11//创建workbook

12HSSFWorkbook wb = newHSSFWorkbook();

13//使用默认的构造方法创建workbook

14FileOutputStream fileOut = newFileOutputStream("workbook.xls");

15//指定文件名

16wb.write(fileOut);

17//输出到文件

18fileOut.close();

19 

20 

21//创建一个sheet

22HSSFWorkbook wb = newHSSFWorkbook();

23HSSFSheet sheet1 = wb.createSheet("new sheet");

24//workbook创建sheet

25HSSFSheet sheet2 = wb.createSheet("second sheet");

26//workbook创建另外的sheet

27FileOutputStream fileOut = newFileOutputStream("workbook.xls");

28wb.write(fileOut);

29fileOut.close();

30 

31 

32//创建cells

33HSSFWorkbook wb = newHSSFWorkbook();

34HSSFSheet sheet = wb.createSheet("new sheet");

35//注意以下的代码很多方法的参数是short 而不是int 所以需要做一次类型转换

36HSSFRow row = sheet.createRow((short)0);

37//sheet 创建一行

38HSSFCell cell = row.createCell((short)0);

39//行创建一个单元格

40cell.setCellValue(1);

41//设定单元格的值

42//值的类型参数有多中double ,String ,boolean,

43row.createCell((short)1).setCellValue(1.2);

44row.createCell((short)2).setCellValue("This is a string");

45row.createCell((short)3).setCellValue(true);

46// Write the output to a file

47FileOutputStream fileOut = newFileOutputStream("workbook.xls");

48wb.write(fileOut);

49fileOut.close();

50 

51 

52//创建日期cells

53HSSFWorkbook wb = newHSSFWorkbook();

54HSSFSheet sheet = wb.createSheet("new sheet");

55HSSFRow row = sheet.createRow((short)0);

56HSSFCell cell = row.createCell((short)0);

57//设定值为日期

58cell.setCellValue(newDate());

59HSSFCellStyle cellStyle = wb.createCellStyle();

60//指定日期显示格式

61cellStyle.setDataFormat(HSSFDataFormat.getFormat("m/d/yy h:mm"));

62cell = row.createCell((short)1);

63cell.setCellValue(newDate());

64//设定单元格日期显示格式

65cell.setCellStyle(cellStyle);

66FileOutputStream fileOut = newFileOutputStream("workbook.xls");

67wb.write(fileOut);

68fileOut.close();

//设定单元格格式

单元格格式的设定有很多形式包括单元格的对齐方式，内容的字体设置，单元格的背景色等，因为形式比较多，只举一些例子.以下的例子在

POI1.5中可能会有所改变具体查看API.

01// Aqua background

02HSSFCellStyle style = wb.createCellStyle();

03//创建一个样式

04style.setFillBackgroundColor(HSSFCellStyle.AQUA);

05//设定此样式的的背景颜色填充

06style.setFillPattern(HSSFCellStyle.BIG_SPOTS);

07//样式的填充类型。

08//有多种式样如:

09//HSSFCellStyle.BIG_SPOTS

10//HSSFCellStyle.FINE_DOTS

11//HSSFCellStyle.SPARSE_DOTS等

12style.setAlignment(HSSFCellStyle.ALIGN_CENTER );

13//居中对齐

14style.setFillBackgroundColor(HSSFColor.GREEN.index);

15//设定单元个背景颜色

16style.setFillForegroundColor(HSSFColor.RED.index);

17//设置单元格显示颜色

18HSSFCell cell = row.createCell((short)1);

19cell.setCellValue("X");

20cell.setCellStyle(style);

加上response.setContentType("Application/msexcel");
    response.setHeader("Content-disposition","attachment; filename=book.xls" );

然后提交给它的时候会时候会提示下载，下载的就是生成的EXCEL文件。  


有趣的是，对一个html文件（数据在表格中），当把后缀改为xls后，打开文件即是。 

加上response.setContentType("Application/msexcel");  

response.setHeader("Content-disposition","attachment; >>filename=book.xls" );  

然后提交给它的时候会时候会提示下载，下载的就是生成的EXCEL文件。  



使用poi的hssf生成一个excel文件以后  

有一个主类Workbook(相当于一个excel文件)的方法，Workbook.write(OutputStream)可以写

到response.getOutputStream()里面，如果事先设置response的contentType为excel和下载的附件名称就可下载excel 

1HSSFWorkbook book = _proxy.expertExcel(_formBean,_login);

2    if(book!=null){

3        response.setContentType ("application/ms-excel" ) ;

4        response.setHeader ("Content-Disposition" ,"attachment;filename="+newString("导出Excel.xls".getBytes(),"iso-8859-1"));

5        book.write(response.getOutputStream());

6    }

其中“导出的Excel”无非是从数据库或者其他地方获取数据创建excel.  

response.setHeader("Content-disposition","attachment; filename=book.xls" ); 加上attachment浏览器就会提示保存或者打开。


其中写入的中文全都是乱码！！！ 如何解决？？？  

<%@ page contentType="application/msexcel;charset=gb2312" %>
response.setHeader("Content-disposition","inline; filename=***.xls");
就可以了，要是想要word 就：
<%@ page contentType="application/msword;charset=gb2312" %>
response.setHeader("Content-disposition","inline; filename=test1.xls");

使用POI处理中文：

1HSSFCell cell = row.createCell((short)1);

2cell.setEncoding(HSSFCell.ENCODING_UTF_16);

3cell.setCellValue("中文");