简单EXCEL报表方案：Spring+POI

近期为完成一个简单的报表模块，需求很简单，从数据库中取出数据导出到已写好的Excel模版中。
     一开始准备用jfreeReport实现，偶然调试spring的demo时发现，countries的例子很好，既有web分页，又有excel，pdf的输出，经分析例子，spring封装了poi实现excel导出，itext实现pdf输出。
     1，先来分析一下poi的一些背景。POI的主页：http://jakarta.apache.org/poi。POI HSSF是当今市面上最强大的处理EXCEL表格的java工具，比韩国人写的那个JExcelApi或其它几种工具都要好。而且它是Apache的开源项目。当然POI HSSF也有缺点：不能直接支持EXCEL图表，API文档粗糙简略，有些类和方法需要引用Apache项目中的其它一些包，包与包之间依赖关系比较复杂等等。
Apache的Jakata项目的POI子项目，目标是处理ole2对象。目前比较成熟的是HSSF接口，处理MS Excel（97-2002）对象。它不象我们仅仅是用csv生成的没有格式的可以由Excel转换的东西，而是真正的Excel对象，你可以控制一些属性如sheet,cell等等。这是一个年轻的项目，所以象HDF这样直接支持Word对象的好东西仍然在设计中。其它支持word格式的纯java方案还有itext，不过也是仍在奋斗中。但是HSSF已经成熟到能够和足够我们使用了。另外，无锡永中Office的实现方案也是纯java的解决方案，不过那也是完全商业的产品，并不是公开代码项目。其实，从开发历史的角度讲，在80年代中期starOffice的原作者在德国成立了StarOffice suite公司，然后到1999年夏天starOffice被sun收购，再到2000年6月starOffice5.2的发布；并且从starOffice6.0开始，starOffice建立在OpenOffice的api的基础上，这个公开代码的office项目已经进行了很长的时间。虽然那是由C++写的，但是POI的代码部分也是由openOffice改过来的。所以，应该对POI充满足够的信心。国内已经有部分公司在他们的办公自动化等Web项目中使用poi了，如日恒的ioffice，海泰的HTOffice等。java当初把核心处理设成Unicode，带来的好处是另代码适应了多语言环境。然而由于老外的英语只有26个字母，有些情况下，一些程序员用8位的byte处理，一不小心就去掉了CJK的高位。或者是由于习惯在程序中采用硬编码，还有多种原因，使得许多java应用在CJK的处理上很烦恼。还好在POI HSSF中考虑到这个问题，可以设置encoding为双字节。编译好的jar主要有这样4个：poi包,poi Browser包,poi hdf包,poi hssf例程包。实际运行时，需要有poi包就可以了。如果用Jakarta ant编译和运行，下载apache Jakarta POI的release中的src包，它里面已经为你生成好了build文件了。只要运行ant就可以了(ant 的安装和使用在此不说了)。如果是用Jbuilder 运行，请在新建的项目中加入poi包。以Jbuilder6为例，选择Tools菜单项的config libraries...选项，新建一个lib。在弹出的菜单中选择poi包，如这个jakarta-poi-1.5.1-final-20020820.jar，把poi添加到jbuilder中。然后，右键点击你的项目，在project的properties菜单中path的required Libraries中，点add，添加刚才加入到jbuilder中的poi到你现在的项目中。如果你仅仅是为了熟悉POI hssf的使用，可以直接看POI的samples包中的源代码，并且运行它。hssf的各种对象都有例程的介绍。hssf提供的例程在org.apache.poi.hssf.usermodel.examples包中，共有14个，生成的目标xls都是workbook.xls。如果你想看更多的例程，可以参考hssf的Junit test cases，在poi的包的源代码中有。hssf都有测试代码。
     2 ，poi提供了一个不错的tutor，教初学者如何快速上手使用POI HSSF：http://jakarta.apache.org/poi/hssf/quick-guide.html
 建一个poiDemo的工程，然后把tutor首页的例子运行一遍，入门级别就够了。其中包括：新建excel文件（WorkBook）；新建sheet；开辟cell；设置cell数据类型和格式；设置输出的样式如对齐方式，颜色，字体，边框等；合并单元格；读取已有excel文件；设置打印区域；设置页码和页脚；调用公式；选中sheet；屏幕缩放；绘图；插入图像等等。
   3， spring的对poi的封装。在spring-framework-1.2-rc2/src/org/springframework/web/servlet/view/document下有两个类AbstractExcelView.java和AbstractPdfView.java，其中前者是处理excel的抽象类，继承它的时候，需要实现抽象方法 buildExcelDocument,实例代码如下：

 1 protected void  buildExcelDocument(
 2      Map model, HSSFWorkbook workbook,
 3     HttpServletRequest request, HttpServletResponse response)  {
 4
 5   // Go to the first sheet.
 6   // getSheetAt: only if workbook is created from an existing document
 7         // HSSFSheet sheet = workbook.getSheetAt(0);
 8         HSSFSheet sheet = workbook.createSheet("Spring");
 9         sheet.setDefaultColumnWidth(12);
10
11   // Write a text at A1.
12   HSSFCell cell = getCell(sheet, 0, 0);
13   setText(cell, "Spring POI test");
14
15   // Write the current date at A2.
16   HSSFCellStyle dateStyle = workbook.createCellStyle();
17   dateStyle.setDataFormat(HSSFDataFormat.getBuiltinFormat("m/d/yy"));
18   cell = getCell(sheet, 1, 0);
19   cell.setCellValue(new Date());
20   cell.setCellStyle(dateStyle);
21
22   // Write a number at A3
23   getCell(sheet, 2, 0).setCellValue(458);
24
25   // Write a range of numbers.
26   HSSFRow sheetRow = sheet.createRow(3);
27   for (short i = 0; i < 10; i++) {
28     sheetRow.createCell(i).setCellValue(i * 10);
29   }
30 }

4， 通过web程序调用，很多情况需要把生成的excel文件通过网络连接来输出，这些spring已经替你做好了，所以只要按照spring的调用标准就可以，我使用的是spring的mvc，实例代码如下：

1 protected  ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)  throws  Exception  {
2        List list = (List) request.getSession().getAttribute("list"); //从session中取数据list
3        Map model=new HashMap(); 
4        model.put("list",list); //将list封装传到excelView中
5        ExcelView ev = this.getExcelView();//ExcelView继承了AbatractExcelView
6         return new ModelAndView(ev,model); //跳转页面
7    }