引言

  报表输出是研发数据库应用程式经常涉及的内容,而一般的报表往往缺乏通用性,不方便用户进行个性化编辑。Excel是Windos平台上优秀的电子表格软件,假如把报表输出成Excel格式,用户就能够利用Excel的强大功能对报表进行再编辑,以满足自己的特别需要。但是,长期以来,Java程式由于其跨平台特性,不能直接操纵Excel。为了实现纯Java的Excel解决方案,Apache Jakara推出了一个免费的开源项目POI。POI现在已比较成熟,能够处理MS Excel(97 - 2002)对象。国内已有部分公司在他们的办公自动化等Web项目中使用POI了。

  POI的下载和安装

  请到网站右击超链接2.5.1.zip下载压缩包poi-bin-2.5.1-final-20040804.zip,解压缩后得到如图2.1所示的目录结构。我们主要用到poi-2.5.1-final-20040804.jar这个库文档。请把poi-2.5.1-final-20040804.jar这个文档的路径添加到系统环境变量classpath中,否则无法编译下面的示例程式。



图2.1 POI的目录结构

  POI使用初步

  POI提供给用户使用的对象在org.apache.poi.hssf.usermodel包中,主要部分包括Excel对象、样式和格式,更有辅助操作等。

  最主要的几个对象如表3.1所示:

  表3.1 POI主要对象

POI对象名称 所对应的Excel对象
HSSFWorkbook 工作簿
HSSFSheet 工作表
HSSFRow
HSSFCell 单元格

  下面我们来看如下的例子,使用表3.1中的对象在程式的当前目录下创建一个Excel文档test.xls,在第一个单元格中写入内容,然后读出第一个单元格的内容。

  完整的程式如下:

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;
import java.io.FileInputStream;

public class CreateXL
{
 public static String xlsFile="test.xls"; //产生的Excel文档的名称
 public static void main(String args[])
 {
  try
  {
   HSSFWorkbook workbook = new HSSFWorkbook(); //产生工作簿对象
   HSSFSheet sheet = workbook.createSheet(); //产生工作表对象
   //配置第一个工作表的名称为firstSheet
   //为了工作表能支持中文,配置字符编码为UTF_16
   workbook.setSheetName(0,"firstSheet",HSSFWorkbook.ENCODING_UTF_16);
   //产生一行
   HSSFRow row = sheet.createRow((short)0);
   //产生第一个单元格
   HSSFCell cell = row.createCell((short) 0);
   //配置单元格内容为字符串型
   cell.setCellType(HSSFCell.CELL_TYPE_STRING);
   //为了能在单元格中写入中文,配置字符编码为UTF_16。
   cell.setEncoding(HSSFCell.ENCODING_UTF_16);
   //往第一个单元格中写入信息
   cell.setCellValue("测试成功");
   FileOutputStream fOut = new FileOutputStream(xlsFile);
   workbook.write(fOut);
   fOut.flush();
   fOut.close();
   System.out.println("文档生成...");
   //以下语句读取生成的Excel文档内容
   FileInputStream fIn=new FileInputStream(xlsFile);
   HSSFWorkbook readWorkBook= new HSSFWorkbook(fIn);
   HSSFSheet readSheet= readWorkBook.getSheet("firstSheet");
   HSSFRow readRow =readSheet.getRow(0);
   HSSFCell readCell = readRow.getCell((short)0);
   System.out.println("第一个单元是:" + readCell.getStringCellValue());
  }
  catch(Exception e)
  {
   System.out.println(e);
  }
 }
}

  和数据库结合使用

  使用POI,结合JDBC编程技术,我们就能够方便地将数据库中的数据导出生成Excel报表。其关键代码如下:

/*把数据集rs中的数据导出至Excel工作表中。
*传入参数:数据集rs,Excel文档名称xlsName,工作表名称sheetName。
*/

public static void resultSetToExcel(ResultSet rs,String xlsName,String sheetName) throws Exception
{
 HSSFWorkbook workbook = new HSSFWorkbook();
 HSSFSheet sheet = workbook.createSheet();
 workbook.setSheetName(0,sheetName,HSSFWorkbook.ENCODING_UTF_16);
 HSSFRow row= sheet.createRow((short)0);;
 HSSFCell cell;
 ResultSetMetaData md=rs.getMetaData();
 int nColumn=md.getColumnCount();
 //写入各个字段的名称
 for(int i=1;i<=nColumn;i++)
 {
  cell = row.createCell((short)(i-1));
  cell.setCellType(HSSFCell.CELL_TYPE_STRING);
  cell.setEncoding(HSSFCell.ENCODING_UTF_16);
  cell.setCellValue(md.getColumnLabel(i));
 }

 int iRow=1;
 //写入各条记录,每条记录对应Excel中的一行
 while(rs.next())
 {row= sheet.createRow((short)iRow);;
  for(int j=1;j<=nColumn;j++)
  {
   cell = row.createCell((short)(j-1));
   cell.setCellType(HSSFCell.CELL_TYPE_STRING);
   cell.setEncoding(HSSFCell.ENCODING_UTF_16);
   cell.setCellValue(rs.getObject(j).toString());
  }
  iRow++;
 }
 FileOutputStream fOut = new FileOutputStream(xlsName);
 workbook.write(fOut);
 fOut.flush();
 fOut.close();
 JOptionPane.showMessageDialog(null,"导出数据成功!");
}

  结束语

  POI功能强大,还能够配置单元格格式、配置页眉页脚等。限于篇幅的关系就不一一举例了,感兴趣的读者能够参考其帮助文档(在图2.1的doc文档夹中)。总之,使用POI,我们能够较好地解决Java编程中的Excel报表问题,进一步满足用户的需求