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文件。
01 | import org.apache.poi.hssf.usermodel.HSSFWorkbook; |
02 | import java.io.FileOutputStream; |
03 | import java.io.IOException; |
04 | public class NewWorkbook{ |
05 | publicstaticvoid main(String[] args) throws IOException{ |
07 | HSSFWorkbook wb = new HSSFWorkbook(); |
08 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
通过这个例子,我们建立的是一个空白的xls文件(不是空文件)。在此基础上,我们可以进一步看其它的例子。
01 | import org.apache.poi.hssf.usermodel.*; |
02 | import java.io.FileOutputStream; |
03 | import java.io.IOException; |
04 | public class CreateCells{ |
05 | public static void main(String[] args) throws IOException{ |
07 | HSSFWorkbook wb = new HSSFWorkbook(); |
08 | HSSFSheet sheet = wb.createSheet( "new sheet" ); |
11 | HSSFRow row = sheet.createRow(( short ) 0 ); |
14 | HSSFCell cell = row.createCell(( short ) 0 ); |
18 | row.createCell(( short ) 1 ).setCellValue( 1.2 ); |
19 | row.createCell(( short ) 2 ).setCellValue( "test" ); |
20 | row.createCell(( short ) 3 ).setCellValue( true ); |
22 | HSSFCellStyle cellStyle = wb.createCellStyle(); |
23 | cellStyle.setDataFormat(HSSFDataFormat.getFormat( "m/d/yy h:mm" )); |
25 | HSSFCell dCell =row.createCell(( short ) 4 ); |
26 | dCell.setCellValue( new Date()); |
27 | dCell.setCellStyle(cellStyle); |
28 | HSSFCell csCell =row.createCell(( short ) 5 ); |
30 | csCell.setEncoding(HSSFCell.ENCODING_UTF_16); |
31 | csCell.setCellValue( "中文测试_Chinese Words Test" ); |
32 | row.createCell(( short ) 6 ).setCellType(HSSFCell.CELL_TYPE_ERROR); |
35 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
稍微修改了原来的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程序如下:
01 | import org.apache.poi.hssf.usermodel.HSSFWorkbook; |
02 | import org.apache.poi.hssf.usermodel.HSSFSheet; |
03 | import org.apache.poi.hssf.usermodel.HSSFRow; |
04 | import org.apache.poi.hssf.usermodel.HSSFCell; |
05 | import java.io.FileOutputStream; |
06 | public class CreateXL { |
07 | /** Excel 文件要存放的位置,假定在D盘JTest目录下*/ |
08 | publicstatic String outputFile= "D:/Test/gongye.xls" ; |
09 | public static void main(String argv[]){ |
12 | HSSFWorkbook workbook = new HSSFWorkbook(); |
16 | HSSFSheet sheet = workbook.createSheet(); |
18 | HSSFRow row = sheet.createRow(( short ) 0 ); |
20 | HSSFCell cell = row.createCell(( short ) 0 ); |
22 | cell.setCellType(HSSFCell.CELL_TYPE_STRING); |
24 | cell.setCellValue( "增加值" ); |
26 | FileOutputStream fOut = new FileOutputStream(outputFile); |
32 | System.out.println( "文件生成..." ); |
34 | System.out.println( "已运行 xlCreate() : " + e ); |
读取Excel文档中的数据
示例2将演示如何读取Excel文档中的数据。假定在D盘JTest目录下有一个文件名为gongye.xls的Excel文件。
示例2程序如下:
01 | import org.apache.poi.hssf.usermodel.HSSFWorkbook; |
02 | import org.apache.poi.hssf.usermodel.HSSFSheet; |
03 | import org.apache.poi.hssf.usermodel.HSSFRow; |
04 | import org.apache.poi.hssf.usermodel.HSSFCell; |
05 | import java.io.FileInputStream; |
07 | /** Excel文件的存放位置。注意是正斜线*/ |
08 | public static String fileToBeRead= "D:/Test/ gongye.xls" ; |
09 | public static void main(String argv[]){ |
12 | HSSFWorkbook workbook = new HSSFWorkbook( new FileInputStream(fileToBeRead)); |
15 | HSSFSheet sheet = workbook.getSheet( "Sheet1" ); |
20 | HSSFRow row = sheet.getRow( 0 ); |
21 | HSSFCell cell = row.getCell(( short ) 0 ); |
23 | System.out.println( "左上端单元是: " + cell.getStringCellValue()); |
25 | System.out.println( "已运行xlRead() : " + e ); |
设置单元格格式
在这里,我们将只介绍一些和格式设置有关的语句,我们假定workbook就是对一个工作簿的引用。在Java 中,第一步要做的就是创建和设
置字体和单元格的格式,然后再应用这些格式:
02 | HSSFFont font = workbook.createFont(); |
03 | font.setColor(HSSFFont.COLOR_RED); |
04 | font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD); |
07 | HSSFCellStyle cellStyle= workbook.createCellStyle(); |
08 | cellStyle.setFont(font); |
11 | HSSFCell cell = row.createCell(( short ) 0 ); |
12 | cell.setCellStyle(cellStyle); |
13 | cell.setCellType(HSSFCell.CELL_TYPE_STRING); |
14 | 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
01 | public void copyRows(String pSourceSheetName, String pTargetSheetName, int pStartRow, int pEndRow, int pPosition){ |
03 | HSSFRow sourceRow = null ; |
04 | HSSFRow targetRow = null ; |
05 | HSSFCell sourceCell = null ; |
06 | HSSFCell targetCell = null ; |
07 | HSSFSheet sourceSheet = null ; |
08 | HSSFSheet targetSheet = null ; |
15 | if ((pStartRow == - 1 ) || (pEndRow == - 1 )){ |
18 | sourceSheet = this .fWorkbook.getSheet(pSourceSheetName); |
19 | targetSheet = this .fWorkbook.getSheet(pTargetSheetName); |
22 | for (i = 0 ; i < sourceSheet.getNumMergedRegions(); i++){ |
23 | region = sourceSheet.getMergedRegionAt(i); |
24 | if ((region.getRowFrom() >= pStartRow) && (region.getRowTo() <= pEndRow)){ |
26 | targetRowFrom = region.getRowFrom() - pStartRow + pPosition; |
27 | targetRowTo = region.getRowTo() - pStartRow + pPosition; |
28 | region.setRowFrom(targetRowFrom); |
29 | region.setRowTo(targetRowTo); |
30 | targetSheet.addMergedRegion(region); |
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)); |
44 | for (;i <= pEndRow; i++){ |
45 | sourceRow = sourceSheet.getRow(i); |
46 | if (sourceRow == null ){ |
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 ){ |
56 | targetCell = targetRow.createCell(j); |
57 | targetCell.setEncoding(sourceCell.getEncoding()); |
58 | targetCell.setCellStyle(sourceCell.getCellStyle()); |
59 | cType = sourceCell.getCellType(); |
60 | targetCell.setCellType(cType); |
63 | case HSSFCell.CELL_TYPE_BOOLEAN: |
64 | targetCell.setCellValue(sourceCell.getBooleanCellValue()); |
67 | case HSSFCell.CELL_TYPE_ERROR: |
68 | targetCell.setCellErrorValue(sourceCell.getErrorCellValue()); |
71 | case HSSFCell.CELL_TYPE_FORMULA: |
73 | targetCell.setCellFormula(parseFormula(sourceCell.getCellFormula())); |
76 | case HSSFCell.CELL_TYPE_NUMERIC: |
77 | targetCell.setCellValue(sourceCell.getNumericCellValue()); |
80 | case HSSFCell.CELL_TYPE_STRING: |
81 | targetCell.setCellValue(sourceCell.getStringCellValue()); |
这个函数有两个问题暂时无法解决:
a、只能在同一个Workbook里面使用,跨Workbook总是拷不过去,不知道为什么?
b、由于在拷贝行时也把行高也拷过去了,如果往这些单元格里写入的数据长度超过单元格长度,那么他们不会自动调整行高
3、公式的问题
POI对Excel公式的支持是相当好的,但是发现,如果公式里面的函数不带参数,比如now()或today(),
那么你通过 getCellFormula()取出来的值就是now(ATTR(semiVolatile))和 today(ATTR (semiVolatile)),
这样的值写入Excel是会出错的,这也是我上面copyRow的函数在写入公式前要调用 parseFormula的原因,
parseFormula这个函数的功能很简单,就是把ATTR(semiVolatile)删掉,它的代码:
01 | private String parseFormula(String pPOIFormula){ |
03 | final String cstReplaceString = "ATTR(semiVolatile)" ; |
04 | StringBuffer result = null ; |
06 | result = new StringBuffer(); |
07 | index = pPOIFormula.indexOf(cstReplaceString); |
09 | result.append(pPOIFormula.substring( 0 , index)); |
10 | result.append(pPOIFormula.substring(index + cstReplaceString.length())); |
12 | result.append(pPOIFormula); |
14 | return result.toString(); |
至于为什么会出现ATTR(semiVolatile),还需要大家的探索精神。
4、向Excel写入图片的问题,两种结论:
1、不支持写入图片;
2、支持写入图片,通过EscherGraphics2d这个Class实现。去查EscherGraphics2d这个Class,
发现这个 Class提供了N个drawImage方法,喜出望外的我开始写代码,结果调了一天,一直看不到效果,
在万般无奈下只好跟踪进 drawImage这个函数内部,经过N个函数调用后在最底层函数发现了最终答案:
1 | public boolean drawImage(Image image, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, |
2 | int sx2, int sy2, Color bgColor, ImageObserver imageobserver){ |
3 | if (logger.check( POILogger.WARN )) |
4 | logger.log(POILogger.WARN, "drawImage() not supported" ); |
所以建议大家,以后使用第三方开发包一定尽量下载它的源代码,这样碰到问题时,看看它的的内部是怎么实现的。
既然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
设定单元格格式
说明:以下可能需要使用到如下的类
01 | import org.apache.poi.hssf.usermodel.HSSFCell; |
02 | import org.apache.poi.hssf.usermodel.HSSFCellStyle; |
03 | import org.apache.poi.hssf.usermodel.HSSFDataFormat; |
04 | import org.apache.poi.hssf.usermodel.HSSFFont; |
05 | import org.apache.poi.hssf.usermodel.HSSFRow; |
06 | import org.apache.poi.hssf.usermodel.HSSFSheet; |
07 | import org.apache.poi.hssf.usermodel.HSSFWorkbook; |
08 | import org.apache.poi.hssf.util.HSSFColor; |
12 | HSSFWorkbook wb = new HSSFWorkbook(); |
14 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
22 | HSSFWorkbook wb = new HSSFWorkbook(); |
23 | HSSFSheet sheet1 = wb.createSheet( "new sheet" ); |
25 | HSSFSheet sheet2 = wb.createSheet( "second sheet" ); |
27 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
33 | HSSFWorkbook wb = new HSSFWorkbook(); |
34 | HSSFSheet sheet = wb.createSheet( "new sheet" ); |
36 | HSSFRow row = sheet.createRow(( short ) 0 ); |
38 | HSSFCell cell = row.createCell(( short ) 0 ); |
43 | row.createCell(( short ) 1 ).setCellValue( 1.2 ); |
44 | row.createCell(( short ) 2 ).setCellValue( "This is a string" ); |
45 | row.createCell(( short ) 3 ).setCellValue( true ); |
47 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
53 | HSSFWorkbook wb = new HSSFWorkbook(); |
54 | HSSFSheet sheet = wb.createSheet( "new sheet" ); |
55 | HSSFRow row = sheet.createRow(( short ) 0 ); |
56 | HSSFCell cell = row.createCell(( short ) 0 ); |
58 | cell.setCellValue( new Date()); |
59 | HSSFCellStyle cellStyle = wb.createCellStyle(); |
61 | cellStyle.setDataFormat(HSSFDataFormat.getFormat( "m/d/yy h:mm" )); |
62 | cell = row.createCell(( short ) 1 ); |
63 | cell.setCellValue( new Date()); |
65 | cell.setCellStyle(cellStyle); |
66 | FileOutputStream fileOut = new FileOutputStream( "workbook.xls" ); |
//设定单元格格式
单元格格式的设定有很多形式包括单元格的对齐方式,内容的字体设置,单元格的背景色等,因为形式比较多,只举一些例子.以下的例子在
POI1.5中可能会有所改变具体查看API.
02 | HSSFCellStyle style = wb.createCellStyle(); |
04 | style.setFillBackgroundColor(HSSFCellStyle.AQUA); |
06 | style.setFillPattern(HSSFCellStyle.BIG_SPOTS); |
12 | style.setAlignment(HSSFCellStyle.ALIGN_CENTER ); |
14 | style.setFillBackgroundColor(HSSFColor.GREEN.index); |
16 | style.setFillForegroundColor(HSSFColor.RED.index); |
18 | HSSFCell cell = row.createCell(( short ) 1 ); |
19 | cell.setCellValue( "X" ); |
20 | 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
1 | HSSFWorkbook book = _proxy.expertExcel(_formBean,_login); |
3 | response.setContentType ( "application/ms-excel" ) ; |
4 | response.setHeader ( "Content-Disposition" , "attachment;filename=" + new String( "导出Excel.xls" .getBytes(), "iso-8859-1" )); |
5 | 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处理中文:
1 | HSSFCell cell = row.createCell(( short ) 1 ); |
2 | cell.setEncoding(HSSFCell.ENCODING_UTF_16); |
3 | cell.setCellValue( "中文" ); |