Java读写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工具包

 

在eclipse里加载POI开发包

用Eclipse搭建项目

•  打开Eclipse
• 依次点击File->New->Java Project
• 输入项目名称，本例中设置为POI
• 单击完成
• 在项目上点击右键->New->Folder
• 输入文件夹名称lib
• 把刚才解压的poi-3.0.1-FINAL-20070705.jar复制过来
• 右键点击项目，选择Properties
• 在左侧列表里选中Java Build Path，右侧选中Libraries
• 点击Add JARs（注意要刷新一下项目），选择POI项目的lib下的所有文件
• 两次OK确认，回到Eclipse界面

小技巧，快捷操作：可以用鼠标左键选中poi-3.0.1-FINAL-20070705.jar但不松开，拖到任务栏的Eclipse图标上等候1秒左右，Eclipse会自动弹起来，依然不松开移动到lib文件夹上，这个 时候鼠标后面跟个十字符号，松开左键，就完成了复制动作。这个是对整个windows系统都好用的快捷复制方式，视源盘符和目标盘符的不同偶尔会用到 Ctrl键。

到此为止，我们做好了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();
                     }
                }
            }
    }
}