转自:http://blog.sina.com.cn/s/blog_5e0d59fb0100bx5s.html
开发环境为windowsXP-SP2,Eclipse3.2,JDK1.5.07,其实差不多都行,不会有太大的差异。本文从POI下载开始讲解,前提是开发环境包括系统变量等等已经正确设置完毕。
1.POI的下载
POI官方网址:
http://poi.apache.org/
JAR包下载:
http://apache.mirror.phpchina.com/poi/release/bin/poi-bin-3.0.1-FINAL-20070705.zip
源码下载:
http://apache.mirror.phpchina.com/poi/release/src/poi-src-3.0.1-FINAL-20070705.zip
下载上面的JAR和源码(源码不是必须的,但是为了早日修得正果,深入系统的看看POI代码还是有必要的)并解压待用。
2.用Eclipse搭建项目
第一讲:基本的Excel读写
//创建一个空白的WorkBook
HSSFWorkbook wb = new HSSFWorkbook();
//基于上面的WorkBook创建属于此WorkBook的Sheet,
//3.0.1版在使用全角Sheet名的时候不必再setEncdoing了,个人感觉方便了许多。
HSSFSheet st = wb.createSheet("测试页");
//创建属于上面Sheet的Row,参数0可以是0~65535之间的任何一个,
//注意,尽管参数是Int类型,但是Excel最多支持65536行
HSSFRow row = st.createRow(0);
//创建属于上面Row的Cell,参数0可以是0~255之间的任何一个,
//同样,是因为Excel最大支持的列数为256列
HSSFCell cell = row.createCell((short) 0);
//设置此单元格的格式为文本,此句可以省略,Excel会自动识别。
//其他还有几种常用的格式,请参考本文底部的补充部分。
cell.setCellType(HSSFCell.CELL_TYPE_STRING);
//此处是3.0.1版的改进之处,上一版可以直接setCellValue("Hello, World!"),
//但是在3.0.1里,被deprecated了。
cell.setCellValue(new HSSFRichTextString("Hello, World!"));
//创建一个文件输出流,指定到C盘根目录下(C盘都有吧?)
//xls是Excel97-2003的标准扩展名,2007是xlsx,目前的POI能直接生产的还是xls格式,
//如果此处把扩展名改成xlsx,在用Excel2007打开此文件时会报错。
FileOutputStream writeFile = new FileOutputStream("c:/helloworld.xls");
//把WorkBook写到流里
wb.write(writeFile);
//记得手动关闭流,官方文档已经做了特别说明,说POI不负责关闭用户打开的流。所以...
writeFile.close();
上面就是创建一个新文档的简易代码,下面的例子是读取刚才创建的Excel并把读取到的内容显示在控制台上。
//指定要读取的文件,本例使用上面生成的helloworld.xls
FileInputStream readFile = new FileInputStream("c:/helloworld.xls");
//创建一个WorkBook,从指定的文件流中创建,即上面指定了的文件流
HSSFWorkbook wb = new HSSFWorkbook(readFile);
//获取名称为“测试页”的sheet
//注意,如果不能确定具体的名称,可以用getSheetAt(int)方法取得Sheet
HSSFSheet st = wb.getSheet("测试页");
//获得第一行,同上,如果此行没有被创建过则抛出异常
HSSFRow row = st.getRow(0);
//获取第一个单元格,如果没有被创建过则抛出异常
HSSFCell cell = row.getCell((short) 0);
//把cell中的内容按字符串方式读取出来,并显示在控制台上
//注意,getRichStringCellValue()方法是3.0.1新追加的,
//老版本中的getStringCellValue()方法被deprecated了
System.out.println(cell.getRichStringCellValue());
//记得关闭流
readFile.close();
上面对创建和读取分别举例说明,回顾两段代码,不难看出POI操作Excel的“套路”:
获得一个WorkBook(准确说是HSSFWorkBook,对于POI来说,WorkBook是“另有其类”,以下类同)
获得要读/写的Sheet对象
获得要操作的Row对象
获得最小单位——Cell对象
然后就可以随意的读取、写入了。
--------------------------------------------------------------------------------
关于单元格格式的补充:
单元格一共有如下几种格式,都是HSSFCell类的静态共有属性,
CELL_TYPE_NUMERIC - 数字格式
CELL_TYPE_STRING - 字符串(默认)
CELL_TYPE_FORMULA - 公式
CELL_TYPE_BLANK - 空白
CELL_TYPE_BOOLEAN - 布尔
CELL_TYPE_ERROR - 错误
第二讲:单元格边框、字体及颜色
此文概要性的讲述了一下单元格的边框、字体以及颜色的设置方式,在POI中,这一切都是通过实例化HSSFCellStyle对象来实现的,HSSFCellStyle类还有很多其他实际有用方法,本例中只是取平时用的比较普遍的一些设置来做演示的。好,开始讲解了……
// 设置行号
row.setHeightInPoints((short) 50);
// 设置列宽,(256 * 50)这种写法是因为width参数单位是单个字符的256分之一
st.setColumnWidth(cell.getCellNum(), (short) (256 * 50));
// 让HSSFWorkbook创建一个单元格样式的对象
// 小技巧:在多处用到完全一样的样式的时候可以用工厂模式生产
HSSFCellStyle cellStyle = wb.createCellStyle();
// 设置单元格的横向和纵向对齐方式,具体参数就不列了,参考HSSFCellStyle
cellStyle.setAlignment(HSSFCellStyle.ALIGN_JUSTIFY);
cellStyle.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER);
// 这个地方是用来在单元格里画斜线的
// 原理是在指定的两个点之间画线,然后默认情况此线会随着单元格的变化而变化
// 类似Excel那种设置边框的方式达到的斜线效果目前好像POI不支持
// 如果是我疏忽了请记得告诉我一些,先行谢过啦
HSSFPatriarch patriarch = st.createDrawingPatriarch();
HSSFClientAnchor anchor = new HSSFClientAnchor();
anchor.setAnchor(cell.getCellNum(), row.getRowNum(), 0, 0, (short) (cell.getCellNum() + 1),
row.getRowNum() + 1, 0, 0);
patriarch.createSimpleShape(anchor);
// 设置单元格的文本方式为可多行编写方式
cellStyle.setWrapText(true);
// 设置单元格的填充方式,以及前景颜色和背景颜色
// 三点注意:
// 1.如果需要前景颜色或背景颜色,一定要指定填充方式,两者顺序无所谓;
// 2.如果同时存在前景颜色和背景颜色,前景颜色的设置要写在前面;
// 3.前景颜色不是字体颜色。
cellStyle.setFillPattern(HSSFCellStyle.DIAMONDS);
cellStyle.setFillForegroundColor(HSSFColor.RED.index);
cellStyle.setFillBackgroundColor(HSSFColor.LIGHT_YELLOW.index);
// 设置单元格底部的边框及其样式和颜色
// 这里仅设置了底边边框,左边框、右边框和顶边框同理可设
cellStyle.setBorderBottom(HSSFCellStyle.BORDER_SLANTED_DASH_DOT);
cellStyle.setBottomBorderColor(HSSFColor.DARK_RED.index);
// 创建一个字体对象,因为字体也是单元格格式的一部分,所以从属于HSSFCellStyle
// 下面几个字体的相关设置望文生义,就不用一一说明了吧
HSSFFont font = wb.createFont();
font.setFontName("宋体");
font.setItalic(true);
font.setColor(HSSFColor.BLUE.index);
font.setFontHeightInPoints((short) 20);
font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);
// 将字体对象赋值给单元格样式对象
cellStyle.setFont(font);
// 将单元格样式对应应用于单元格
cell.setCellStyle(cellStyle);
这样就OK了,可以可以看到效果了。
补充,各个章节的例子最终都在同一个附件内,下载的时候下任何一个页面内的都可以,都是一样的。
Java-Excel报表开发POI—合并、分组及冻结
Java-Excel报表开发POI系列讲座
第三讲:单元格的合并、数据行的分组以及Excel窗口的冻结
本来想把这三个东西分开来实现的,后来发现分开后内容都很少,于是就合在一起说吧。那总不能干巴巴的列几个例子就完了吧,那就拿比较初级但又会经常遇到的表格类数据的统计的设计来做个小例子。(源码下载)
结果发现——还真够辛苦的。
这次先看效果图吧,其中的竖排并不是真正意义上Excel那种设置的竖排,而是稍微转变了一下输出的方式实现的,因为老外的英文单词没有这种竖排的可能(顶多是旋转,但是那样字体就变了)。除此之外想到的另外一种竖排文字的实现方式就是样式旋转+字体旋转,没测试,不知道是否可用,谁有功夫实现一下,然后记得告诉我结果啊。
老样子,把核心的代码和简要的说明列出来大家看一下吧。
// 这里首先创建一个单元格样式对象,设置了四周的边框以及字体可以换行
其实这样实现起来是不是很麻烦呢?答案是:是。
其实这只是举个例子,熟悉一下POI的各种API而已,真正要实现这样一个表格的时候,例如项目需要制作报表等等,通常的做法都是事先把格式一切的东西都手动制作好(这个做好了的文件在实际的项目里我们称之为“数据模板”,简称“模板”),然后在Java应用中适当的时机把这个文件读进来修改,最后再另存到指定的位置或者传递给下一个处理者(例如以流的方式送给Servlet等等),这样其实POI具体做的事情就是向模板里写业务的数据,还是很方便快捷的。