记录工作，为了遗忘

一．POI简介

Jakarta POI 是apache的子项目，目标是处理ole2对象。它提供了一组操纵Windows文档的Java API

目前比较成熟的是HSSF接口，处理MS Excel（97-2002）对象。它不象我们仅仅是用csv生成的没有格式的可以由Excel转换的东西，而是真正的Excel对象，你可以控制一些属性如sheet,cell等等。

二．HSSF概况

HSSF 是Horrible SpreadSheet Format的缩写，也即“讨厌的电子表格格式”。也许HSSF的名字有点滑稽，就本质而言它是一个非常严肃、正规的API。通过HSSF，你可以用纯Java代码来读取、写入、修改Excel文件。

HSSF 为读取操作提供了两类API：usermodel和eventusermodel，即“用户模型”和“事件-用户模型”。前者很好理解，后者比较抽象，但操作效率要高得多。

三．开始编码

1 ． 准备工作

要求:JDK 1.4+POI开发包

可以到 http://www.apache.org/dyn/closer.cgi/jakarta/poi/ 最新的POI工具包

2 ． EXCEL 结构

HSSFWorkbook excell 文档对象介绍
HSSFSheet excell的表单
HSSFRow excell的行
HSSFCell excell的格子单元
HSSFFont excell字体
HSSFName 名称
HSSFDataFormat 日期格式
在poi1.7中才有以下2项：
HSSFHeader sheet头
HSSFFooter sheet尾
和这个样式
HSSFCellStyle cell样式
辅助操作包括
HSSFDateUtil 日期
HSSFPrintSetup 打印
HSSFErrorConstants 错误信息表

3 ．具体用法实例 （采用 usermodel ）

如何读Excel

读取Excel文件时，首先生成一个POIFSFileSystem对象，由POIFSFileSystem对象构造一个HSSFWorkbook，该HSSFWorkbook对象就代表了Excel文档。下面代码读取上面生成的Excel文件写入的消息字串：
try{
   POIFSFileSystem fs=new POIFSFileSystem(new FileInputStream("d:/workbook.xls"));
   HSSFWorkbook wb = new HSSFWorkbook(fs);
   HSSFSheet sheet = wb.getSheetAt(0);
   HSSFRow row = sheet.getRow(0);
   HSSFCell cell = row.getCell((short) 0);
   String msg = cell.getStringCellValue();
   System.out.println(msg);
  }catch(Exception e){
   e.printStackTrace();
  }

如何写excel，

将excel的第一个表单第一行的第一个单元格的值写成“a test”。

POIFSFileSystem fs =new POIFSFileSystem(new FileInputStream("workbook.xls"));

    HSSFWorkbook wb = new HSSFWorkbook(fs);

    HSSFSheet sheet = wb.getSheetAt(0);

    HSSFRow row = sheet.getRow(0);

    HSSFCell cell = row.getCell((short)0);

    cell.setCellValue("a test");

    // Write the output to a file

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

    wb.write(fileOut);

fileOut.close();

4 ． 可参考文档

POI 主页： http://jakarta.apache.org/poi/ ，

初学者如何快速上手使用POI HSSF

http://jakarta.apache.org/poi/hssf/quick-guide.html 。

里面有很多例子代码，可以很方便上手。

四．使用心得

POI HSSF 的usermodel包把Excel文件映射成我们熟悉的结构，诸如Workbook、Sheet、Row、Cell等，它把整个结构以一组对象的形式保存在内存之中，便于理解，操作方便，基本上能够满足我们的要求，所以说这个一个不错的选择。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
前面已经讲过利用POI读写Excel，下面是一个用POI向Excel中插入图片的例子。

官方文档：
Images are part of the drawing support. To add an image just call createPicture() on the drawing patriarch. At the time of writing the following types are supported:
PNG
JPG
DIB
It is not currently possible to read existing images and it should be noted that any existing drawings may be erased once you add a image to a sheet.

// Create the drawing patriarch. This is the top level container for
// all shapes. This will clear out any existing shapes for that sheet.

通过HSSFPatriarch类createPicture方法的在指定的wb中的sheet创建图片,它接受二个参数，第一个是HSSFClientAnchor，设定图片的大小。

 1 package  com.poi.hssf.test;
 2
 3 import  java.io.FileOutputStream;
 4 import  java.io.File;
 5 import  java.io.ByteArrayOutputStream;
 6 import  java.io.IOException;
 7
 8 import  java.awt.image.BufferedImage;
 9 import  javax.imageio. * ;
10
11 import  org.apache.poi.hssf.usermodel.HSSFWorkbook;
12 import  org.apache.poi.hssf.usermodel.HSSFSheet;
13 import  org.apache.poi.hssf.usermodel.HSSFPatriarch;
14 import  org.apache.poi.hssf.usermodel.HSSFClientAnchor;;
15
16 public   class  TestPOI  {
17
18      public   static   void  main(String[] args)  {
19             FileOutputStream fileOut  =   null ;
20             BufferedImage bufferImg  = null ;
21             BufferedImage bufferImg1  =   null ;
22              try {
23                 
24            // 先把读进来的图片放到一个ByteArrayOutputStream中，以便产生ByteArray
25           ByteArrayOutputStream byteArrayOut  =   new  ByteArrayOutputStream();
26           ByteArrayOutputStream byteArrayOut1  =   new  ByteArrayOutputStream();
27           bufferImg  =  ImageIO.read( new  File( " d:/PieChart.jpg " ));
28           bufferImg1  =  ImageIO.read( new  File( " d:/fruitBarChart.jpg " ));
29           ImageIO.write(bufferImg, " jpg " ,byteArrayOut);
30           ImageIO.write(bufferImg1, " jpg " ,byteArrayOut1);
31           
32          // 创建一个工作薄
33         HSSFWorkbook wb  =   new  HSSFWorkbook();
34         HSSFSheet sheet1  =  wb.createSheet( " new sheet " );
35          // HSSFRow row = sheet1.createRow(2);
36         HSSFPatriarch patriarch  =  sheet1.createDrawingPatriarch();
37         HSSFClientAnchor anchor  =   new  HSSFClientAnchor( 0 , 0 , 512 , 255 ,( short )  1 , 1 ,( short ) 10 , 20 );
38         HSSFClientAnchor anchor1  =   new  HSSFClientAnchor( 0 , 0 , 512 , 255 ,( short )  2 , 30 ,( short ) 10 , 60 );
39         anchor1.setAnchorType( 2 );
40          // 插入图片
41         patriarch.createPicture(anchor , wb.addPicture(byteArrayOut.toByteArray(),HSSFWorkbook.PICTURE_TYPE_JPEG));
42         patriarch.createPicture(anchor1 , wb.addPicture(byteArrayOut1.toByteArray(),HSSFWorkbook.PICTURE_TYPE_JPEG));
43         
44             fileOut  =   new  FileOutputStream( " d:/workbook.xls " );
45              // 写入excel文件
46             wb.write(fileOut);
47             fileOut.close();
48         
49             } catch (IOException io) {
50                     io.printStackTrace();
51                     System.out.println( " io erorr :   " +  io.getMessage());
52             }   finally
53              {
54                  if  (fileOut  !=   null )
55                  {
56                            
57                      try   {
58                               fileOut.close();
59                          }
60                      catch  (IOException e)
61                      {
62                              //  TODO Auto-generated catch block
63                             e.printStackTrace();
64                      }
65                 }
66             }
67     }
68 }