一.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,设定图片的大小。
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 }