POI简介

在咱们实际的开发中，表现层的解决方案虽然有多样，可是IE浏览器已成为最多人使用的浏览器，由于你们都用Windows。在企业办公系统中，经常有客户这样子要求：你要把咱们的报表直接用Excel打开(电信系统、银行系统)。或者是：咱们已经习惯用Excel打印。

Apache的Jakata项目的POI子项目，目前比较成熟的是HSSF接口，处理MSExcel对象。它不象咱们仅仅是用csv生成的没有格式的能够由Excel转换的东西，而是真正的Excel对象，你能够控制一些属性如sheet,cell等等。

首先，理解一下一个Excel的文件的组织形式，一个Excel文件对应于一个workbook(HSSFWorkbook)，一个workbook能够有多个sheet（HSSFSheet）组成，一个sheet是由多个row（HSSFRow）组成，一个row是由多个cell（HSSFCell）组成。

POI能够到www.apache.org下载到。实际运行时，须要有poi包就能够了。HSSF提供给用户使用的对象在rg.apache.poi.hssf.usermodel包中,主要部分包括Excel对象，样式和格式，还有辅助操做。有如下几种对象：

HSSFWorkbook  excel的文档对象

HSSFSheet  excel的表单

HSSFRow  excel的行 

HSSFCell  excel的格子单元

HSSFFont  excel字体

HSSFDataFormat  日期格式

在poi1.7中才有如下2项：

HSSFHeader  sheet头

HSSFFooter  sheet尾（只有打印的时候才能看到效果）

和这个样式

HSSFCellStyle  cell样式

辅助操做包括

HSSFDateUtil  日期

HSSFPrintSetup  打印 

HSSFErrorConstants  错误信息表

如下可能须要使用到以下的类
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;

 

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

import java.io.FileOutputStream; import java.io.IOException; import org.apache.poi.hssf.usermodel.HSSFWorkbook; public class ExcelSample1 {   public static void main(String[] args) throws IOException { //建立一个excel文件 HSSFWorkbook wb= new HSSFWorkbook(); FileOutputStream fileOut= new FileOutputStream("c:\\workbook.xls"); // FileOutputStream fileOut= new FileOutputStream("c:/workbook.xls"); wb.write(fileOut); fileOut.close(); } }

经过这个例子，咱们在c盘下创建的是一个空白的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对象 HSSFRow row = sheet.createRow((short)0); //在sheet里建立一行，参数为行号（第一行，此处可想象成数组） HSSFCell cell = row.createCell((short)0);       //在row里创建新cell（单元格），参数为列号（第一列） cell.setCellvalue(1);                       //设置cell的整数类型的值 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. getBuiltinFormat("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 FileOutputStream fileOut = new FileOutputStream("workbook.xls"); wb.write(fileOut); fileOut.close(); } }

经过这个例子，咱们能够清楚的看到xls文件从大到小包括了HSSFWorkbook HSSFSheet HSSFRow HSSFCell这样几个对象。咱们能够在cell中设置各类类型的值。
   尤为要注意的是若是你想正确的显示非欧美的字符时，尤为象中日韩这样的语言，必须设置编码为16位的便是HSSFCell.ENCODING_UTF_16，才能保证字符的高8位不被截断而引发编码失真造成乱码。
   其余测试能够经过参考examples包中的测试例子掌握poi的详细用法，包括字体的设置，cell大小和低纹的设置等。须要注意的是POI是一个仍然在完善中的公开代码的项目，因此有些功能正在不断的扩充。

感受上面的操做比较的繁琐，而后就本身写了一个方法。这个方法不须要事先建立row和cell，直接进行cteateCell就能够了，在程序中会自动进行判断，若是不存在的话会建立。

private static void  cteateCell(HSSFWorkbook wb,HSSFRow row,short col,short align,String val){ HSSFCell cell = row.createCell(col); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue(val); HSSFCellStyle cellstyle = wb.createCellStyle(); cellstyle.setAlignment(align); cell.setCellStyle(cellstyle); }

对里面的几个参数的说明：

short col           应该是你的cell单元格的位置也就是列号；

short align         应该是你的对齐方式；

String val          应该是你单元格里面要添加的值；

具体的调用以下：

HSSFRow row = sheet.createRow((short)1); cteateCell(wb,row,(short)0,HSSFCellStyle.ALIGN_CENTER_SELECTION,"SampleID");

在上边的例子里咱们看到了要设置一个单元格里面信息的格式（例如，要将信息居中）设置的操做以下：

HSSFCellStyle cellstyle = wb.createCellStyle(); cellstyle.setAlignment(HSSFCellStyle.ALIGN_CENTER_SELECTION); cell.setCellStyle(cellstyle);

还有咱们咱们常常会用到的合并单元格，在这里咱们也有这样的操做，代码以下：

sheet.addMergedRegion(new Region(1,(short)1,2,(short)4));

 

 

这里面咱们还要介绍一个常常会遇到的问题，就是怎么来冻结一个窗口。poi也为咱们集成了这样的事情了。代码以下：

sheet.createFreezePane(1,2);

l 在这里咱们须要注意的是

1、 该方法是在一个具体的sheet里面来进行操做。

2、 方法createFreezepane;有2个参数。前一个参数表明列；后一个参数表明行。

上边的代码对应的excel文件以下：

 

我么在画面上看到了明显的两条黑线，这就是冻结的窗口。

而后咱们来看一个完整的STRUTS的小例子，在这个例子里面咱们要作的事情是要模拟移动公司的网上营业厅里面的一个功能，咱们要把一个客户当月的通话记录和各类信息查询出来，而且生成一张excel报表。首先，咱们来看一下网上效果的截图。