利用Java＋POI 读写Excel文档&向Excel中插入图片

一．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 。

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

5、中文乱码问题

 //把List expItems,写到EXCEL文件中
  FileOutputStream fileOut = new FileOutputStream(filePath);
  HSSFWorkbook wb = new HSSFWorkbook();// HSSFWorkbook
  HSSFSheet sheet = wb.createSheet();// 
  wb.setSheetName(0,“实验项目列表－－中文测试“,HSSFWorkbook.ENCODING_UTF_16);
  HSSFRow row = sheet.createRow((short) 0);
  HSSFCell cell;
  Iterator iter = expItems.iterator();
  int i = 0;
  while (iter.hasNext()) {
   cell = row.createCell((short) i);
   cell.setEncoding(HSSFCell.ENCODING_UTF_16);
   cell.setCellValue(iter.next().toString());
   i++;
  }
  wb.write(fileOut);
  fileOut.close();
 }

四．使用心得

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，设定图片的大小。

package com.poi.hssf.test;

import java.io.FileOutputStream;
import java.io.File;
import java.io.ByteArrayOutputStream;
import java.io.IOException;

import java.awt.image.BufferedImage;
import javax.imageio.*;

import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFPatriarch;
import org.apache.poi.hssf.usermodel.HSSFClientAnchor;;

public class TestPOI {

    public static void main(String[] args) {
            FileOutputStream fileOut = null;
            BufferedImage bufferImg =null;
            BufferedImage bufferImg1 = null;
            try{
                
          //先把读进来的图片放到一个ByteArrayOutputStream中，以便产生ByteArray
          ByteArrayOutputStream byteArrayOut = new ByteArrayOutputStream();
          ByteArrayOutputStream byteArrayOut1 = new ByteArrayOutputStream();
          bufferImg = ImageIO.read(new File("d:/PieChart.jpg"));
          bufferImg1 = ImageIO.read(new File("d:/fruitBarChart.jpg"));
          ImageIO.write(bufferImg,"jpg",byteArrayOut);
          ImageIO.write(bufferImg1,"jpg",byteArrayOut1);
          
        //创建一个工作薄
        HSSFWorkbook wb = new HSSFWorkbook();
        HSSFSheet sheet1 = wb.createSheet("new sheet");
        //HSSFRow row = sheet1.createRow(2);
        HSSFPatriarch patriarch = sheet1.createDrawingPatriarch();
        HSSFClientAnchor anchor = new HSSFClientAnchor(0,0,512,255,(short) 1,1,(short)10,20);
        HSSFClientAnchor anchor1 = new HSSFClientAnchor(0,0,512,255,(short) 2,30,(short)10,60);
        anchor1.setAnchorType(2);
        //插入图片
        patriarch.createPicture(anchor , wb.addPicture(byteArrayOut.toByteArray(),HSSFWorkbook.PICTURE_TYPE_JPEG));
        patriarch.createPicture(anchor1 , wb.addPicture(byteArrayOut1.toByteArray(),HSSFWorkbook.PICTURE_TYPE_JPEG));
        
            fileOut = new FileOutputStream("d:/workbook.xls");
            //写入excel文件
            wb.write(fileOut);
            fileOut.close();
        
            }catch(IOException io){
                    io.printStackTrace();
                    System.out.println("io erorr :  "+ io.getMessage());
            } finally
            {
                if (fileOut != null)
                {
                           
                    try {
                              fileOut.close();
                         }
                    catch (IOException e)
                    {
                            // TODO Auto-generated catch block
                            e.printStackTrace();
                     }
                }
            }
    }
}