java中使用poi导出Excel详解「建议收藏」

大家好，欢迎来到IT知识分享网。

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

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

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

编译好的jar主要有这样4个：poi包, poi Browser包, poi hdf包, poi hssf例程包。实际运行时，需要有poi包就可以了。如果你仅仅是为了熟悉POI hssf的使用，

可以直接看POI的samples包中的源代码，并且运行它。hssf的各种对象都有例程的介绍。hssf提供的例程在 org.apache.poi.hssf.usermodel.examples包中，共有

14个，生成的目标xls都是workbook.xls。如果 你想看更多的例程，可以参考hssf的Junit test cases，在poi的包的源代码中。hssf都有测试代码。这里只对部分例程的实现做介绍。

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文件。

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import java.io.FileOutputStream;
import java.io.IOException;
public class NewWorkbook{
	publicstaticvoid main(String[] args)throws IOException{

	HSSFWorkbook wb = new HSSFWorkbook();//建立新HSSFWorkbook对象
	FileOutputStream fileOut = new FileOutputStream("workbook.xls");
	wb.write(fileOut);//把Workbook对象输出到文件workbook.xls中
	fileOut.close();
	}
}

通过这个例子，我们建立的是一个空白的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对象

	// Create a row and put some cells in it. Rows are 0 based.
	HSSFRow row = sheet.createRow((short)0);//建立新行

	// Create a cell and put a value in it.
	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/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

	// Write the output to a file
	FileOutputStream fileOut = new FileOutputStream("workbook.xls");
	wb.write(fileOut);
	fileOut.close();
	}
}

稍微修改了原来的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程序如下：

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFCell;
import java.io.FileOutputStream;
public class CreateXL {
/** Excel 文件要存放的位置，假定在D盘JTest目录下*/
	publicstatic String outputFile="D:/Test/gongye.xls";
	public static void main(String argv[]){
		try{
			// 创建新的Excel 工作簿
			HSSFWorkbook workbook = new HSSFWorkbook();
			// 在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 = new FileOutputStream(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程序如下：

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFCell;
import java.io.FileInputStream;
public class ReadXL {
/** Excel文件的存放位置。注意是正斜线*/
public static String fileToBeRead="D:/Test/ gongye.xls";
public static void main(String argv[]){ 
		try{
			// 创建对Excel工作簿文件的引用
			HSSFWorkbook workbook = new HSSFWorkbook(new FileInputStream(fileToBeRead));
			// 创建对工作表的引用。
			// 本例是按名引用（让我们假定那张表有着缺省名"Sheet1"）
			HSSFSheet sheet = workbook.getSheet("Sheet1");
			// 也可用getSheetAt(int index)按索引引用，
			// 在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 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

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写入图片的问题，两种结论：  

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()这些函数丢失掉了。  

==========================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  
设定单元格格式  

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

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;


//创建workbook
HSSFWorkbook wb = new HSSFWorkbook();
//使用默认的构造方法创建workbook
FileOutputStream fileOut = new FileOutputStream("workbook.xls");
//指定文件名
wb.write(fileOut);
//输出到文件
fileOut.close();


//创建一个sheet
HSSFWorkbook wb = new HSSFWorkbook();
HSSFSheet sheet1 = wb.createSheet("new sheet");
//workbook创建sheet
HSSFSheet sheet2 = wb.createSheet("second sheet");
//workbook创建另外的sheet
FileOutputStream fileOut = new FileOutputStream("workbook.xls");
wb.write(fileOut);
fileOut.close();


//创建cells
HSSFWorkbook wb = new HSSFWorkbook();
HSSFSheet sheet = wb.createSheet("new sheet");
//注意以下的代码很多方法的参数是short 而不是int 所以需要做一次类型转换
HSSFRow row = sheet.createRow((short)0);
//sheet 创建一行
HSSFCell cell = row.createCell((short)0);
//行创建一个单元格
cell.setCellValue(1);
//设定单元格的值
//值的类型参数有多中double ,String ,boolean,
row.createCell((short)1).setCellValue(1.2);
row.createCell((short)2).setCellValue("This is a string");
row.createCell((short)3).setCellValue(true);
// Write the output to a file
FileOutputStream fileOut = new FileOutputStream("workbook.xls");
wb.write(fileOut);
fileOut.close();


//创建日期cells
HSSFWorkbook wb = new HSSFWorkbook();
HSSFSheet sheet = wb.createSheet("new sheet");
HSSFRow row = sheet.createRow((short)0);
HSSFCell cell = row.createCell((short)0);
//设定值为日期
cell.setCellValue(new Date());
HSSFCellStyle cellStyle = wb.createCellStyle();
//指定日期显示格式
cellStyle.setDataFormat(HSSFDataFormat.getFormat("m/d/yy h:mm"));
cell = row.createCell((short)1);
cell.setCellValue(new Date());
//设定单元格日期显示格式
cell.setCellStyle(cellStyle);
FileOutputStream fileOut = new FileOutputStream("workbook.xls");
wb.write(fileOut);
fileOut.close();

//设定单元格格式

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

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

// Aqua background
HSSFCellStyle style = wb.createCellStyle();
//创建一个样式
style.setFillBackgroundColor(HSSFCellStyle.AQUA);
//设定此样式的的背景颜色填充
style.setFillPattern(HSSFCellStyle.BIG_SPOTS);
//样式的填充类型。
//有多种式样如:
//HSSFCellStyle.BIG_SPOTS
//HSSFCellStyle.FINE_DOTS
//HSSFCellStyle.SPARSE_DOTS等
style.setAlignment(HSSFCellStyle.ALIGN_CENTER );
//居中对齐
style.setFillBackgroundColor(HSSFColor.GREEN.index);
//设定单元个背景颜色
style.setFillForegroundColor(HSSFColor.RED.index);
//设置单元格显示颜色
HSSFCell cell = row.createCell((short) 1);
cell.setCellValue("X");
cell.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 

HSSFWorkbook book = _proxy.expertExcel(_formBean,_login);
	if(book!=null){
        response.setContentType ( "application/ms-excel" ) ;
        response.setHeader ( "Content-Disposition" ,"attachment;filename="+new String("导出Excel.xls".getBytes(),"iso-8859-1"));
        book.write(response.getOutputStream());
	}

其中“导出的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处理中文：

HSSFCell cell = row.createCell((short)1);
cell.setEncoding(HSSFCell.ENCODING_UTF_16);
cell.setCellValue("中文");