POI API 创建Excel 文档

原文来自 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文件。

 

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

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

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

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

        ileOut.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 2 sdk1.4.0 和Jakarta POI，Jakarta POI的Web站点是: http://jakarta.apache.org/poi/

  如何利用Jakarta POI API 创建Excel 文档。

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目录下*/
 　public static String outputFile="D:/JTest/ 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:/JTest/ 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("标题 ");