原文来自 http://www.blogjava.net/hezhi/articles/POI.html
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包中的对象反向导入并根据相互关系作了整理。从中不难可以发现每一个基本对象都关联了一个Record对象。Record对象是一个参考Office格式的相关记录。
HSSFWorkbook即是一个Excell对象。这幅类图体现的是HSSFWorkbook和基本对象的相互关系。可见,许多对象中也建立了Workbook的引用。还需要注意的是在HSSFWorkbook和HSSFSheet中建立了log机制POILogger,而且POILogger也是使用apache Log4J实现的。
先看poi的examples包中提供的最简单的例子,建立一个空xls文件。
1 import org.apache.poi.hssf.usermodel.HSSFWorkbook; 2 3 import java.io.FileOutputStream; 4 5 import java.io.IOException; 6 7 public class NewWorkbook{ 8 9 public static void main(String[] args) throws IOException{ 10 11 HSSFWorkbook wb = new HSSFWorkbook();//建立新HSSFWorkbook对象 12 13 FileOutputStream fileOut = new FileOutputStream("workbook.xls"); 14 15 wb.write(fileOut);//把Workbook对象输出到文件workbook.xls中 16 17 ileOut.close(); 18 19 } 20 }
通过这个例子,我们建立的是一个空白的xls文件(不是空文件)。在此基础上,我们可以进一步看其它的例子。
1 import org.apache.poi.hssf.usermodel.*; 2 3 import java.io.FileOutputStream; 4 5 import java.io.IOException; 6 7 public class CreateCells 8 9 { 10 11 public static void main(String[] args) 12 13 throws IOException 14 15 { 16 17 HSSFWorkbook wb = new HSSFWorkbook();// 建立新HSSFWorkbook对象 18 19 HSSFSheet sheet = wb.createSheet("new sheet");// 建立新的sheet对象 20 21 // Create a row and put some cells in it. Rows are 0 based. 22 23 HSSFRow row = sheet.createRow((short) 0);// 建立新行 24 25 // Create a cell and put a value in it. 26 27 HSSFCell cell = row.createCell((short) 0);// 建立新cell 28 29 cell.setCellValue(1);// 设置cell的整数类型的值 30 31 // Or do it on one line. 32 33 row.createCell((short) 1).setCellValue(1.2);// 设置cell浮点类型的值 34 35 row.createCell((short) 2).setCellValue("test");// 设置cell字符类型的值 36 37 row.createCell((short) 3).setCellValue(true);// 设置cell布尔类型的值 38 39 HSSFCellStyle cellStyle = wb.createCellStyle();// 建立新的cell样式 40 41 cellStyle.setDataFormat(HSSFDataFormat.getFormat("m/d/yy h:mm"));// 设置cell样式为定制的日期格式 42 43 HSSFCell dCell = row.createCell((short) 4); 44 45 dCell.setCellValue(new Date());// 设置cell为日期类型的值 46 47 dCell.setCellStyle(cellStyle); // 设置该cell日期的显示格式 48 49 HSSFCell csCell = row.createCell((short) 5); 50 51 csCell.setEncoding(HSSFCell.ENCODING_UTF_16);// 设置cell编码解决中文高位字节截断 52 53 csCell.setCellValue("中文测试_Chinese Words Test");// 设置中西文结合字符串 54 55 row.createCell((short) 6).setCellType(HSSFCell.CELL_TYPE_ERROR);// 建立错误cell 56 57 // Write the output to a file 58 59 FileOutputStream fileOut = new FileOutputStream("workbook.xls"); 60 61 wb.write(fileOut); 62 63 fileOut.close(); 64 65 } 66 67 }
我稍微修改了原来的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 2 sdk1.4.0 和Jakarta POI,Jakarta POI的Web站点是: http://jakarta.apache.org/poi/
如何利用Jakarta POI API 创建Excel 文档。
1 import org.apache.poi.hssf.usermodel.HSSFWorkbook; 2 import org.apache.poi.hssf.usermodel.HSSFSheet; 3 import org.apache.poi.hssf.usermodel.HSSFRow; 4 import org.apache.poi.hssf.usermodel.HSSFCell; 5 import java.io.FileOutputStream; 6 public class CreateXL { 7 /** Excel 文件要存放的位置,假定在D盘JTest目录下*/ 8 public static String outputFile="D:/JTest/ gongye.xls"; 9 public static 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 34 35 }catch(Exception e) { 36 System.out.println("已运行 xlCreate() : " + e ); 37 } 38 } 39 }
读取Excel文档中的数据
示例2将演示如何读取Excel文档中的数据。假定在D盘JTest目录下有一个文件名为gongye.xls的Excel文件。
示例2程序如下
1 import org.apache.poi.hssf.usermodel.HSSFWorkbook; 2 import org.apache.poi.hssf.usermodel.HSSFSheet; 3 import org.apache.poi.hssf.usermodel.HSSFRow; 4 import org.apache.poi.hssf.usermodel.HSSFCell; 5 import java.io.FileInputStream; 6 public class ReadXL { 7 /** Excel文件的存放位置。注意是正斜线*/ 8 public static String fileToBeRead="D:/JTest/ gongye.xls"; 9 public static void main(String argv[]){ 10 try{ 11 // 创建对Excel工作簿文件的引用 12 HSSFWorkbook workbook = new HSSFWorkbook(new FileInputStream(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 }
设置单元格格式
在这里,我们将只介绍一些和格式设置有关的语句,我们假定workbook就是对一个工作簿的引用。在Java中,第一步要做的就是创建和设置字体和单元格的格式,然后再应用这些格式:
1、创建字体,设置其为红色、粗体:
1 HSSFFont font = workbook.createFont(); 2 font.setColor(HSSFFont.COLOR_RED); 3 font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);
2、创建格式
1 HSSFCellStyle cellStyle= workbook.createCellStyle(); 2 cellStyle.setFont(font);
3、应用格式
1 HSSFCell cell = row.createCell((short) 0); 2 cell.setCellStyle(cellStyle); 3 cell.setCellType(HSSFCell.CELL_TYPE_STRING); 4 cell.setCellValue("标题 ");