Java-Excel 报表开发 POI

转自：http://blog.sina.com.cn/s/blog_5e0d59fb0100bx5s.html

 开发环境为windowsXP-SP2，Eclipse3.2，JDK1.5.07，其实差很少都行，不会有太大的差别。本文从POI下载开始讲解，前提是开发环境包括系统变量等等已经正确设置完毕。

 

1.POI的下载

 截至本文发表，POI最新版本是3.0.1，距离上一个Final版本有3年了吧，以致于我差点儿就把他放弃了——觉得没人管了。官方的公告讲，这一版主要是追加了一些新的特性和BUG修正，不过稍微有点儿遗憾的是，还不能很好的操做Excel2007。

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搭建项目

  打开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更好的为咱们工做。

 

第一讲：基本的Excel读写

 本文主要演示一下POI的基本操做，例如怎样读取和建立一个具体的Excel文件。按照惯例，拿HelloWorld说事儿。

 说明：本文主要内容皆包含于官方帮助手册，之因此要拿出来，出于两个缘由，手册是英文的+手册是对应2.5.1的。

 核心代码以下，注释部分为讲解。这里只挑干的讲，完整的代码请参考(下载代码)。

//建立一个空白的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那种设置的竖排，而是稍微转变了一下输出的方式实现的，由于老外的英文单词没有这种竖排的可能（顶可能是旋转，可是那样字体就变了）。除此以外想到的另一种竖排文字的实现方式就是样式旋转+字体旋转，没测试，不知道是否可用，谁有功夫实现一下，而后记得告诉我结果啊。

 

老样子，把核心的代码和简要的说明列出来你们看一下吧。

// 这里首先建立一个单元格样式对象，设置了四周的边框以及字体能够换行

  // 其中的字体换行是用来竖向显示其中的一个单元格的

  // 更好的一点儿作法是再作一个单独的单元格样式对象

  // 要否则在处理自动列宽的时候可能会有点儿小问题

  HSSFCellStyle normalStyle = wb.createCellStyle();

  normalStyle.setBorderLeft(HSSFCellStyle.BORDER_THIN);

  normalStyle.setBorderTop(HSSFCellStyle.BORDER_THIN);

  normalStyle.setBorderRight(HSSFCellStyle.BORDER_THIN);

  normalStyle.setBorderBottom(HSSFCellStyle.BORDER_THIN);

  normalStyle.setAlignment(HSSFCellStyle.ALIGN_CENTER);

  normalStyle.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER);

  normalStyle.setWrapText(true);

  // 合并单元格A1-C1，填入内容的时候添到第一个格子里就能够

  // 可是注意一点：单元格合并後设置边框只在原第一个上有效，

  // 若是想应用的合并後的总体，则须要一个个的Create出单元格并应用样式

  // 这个明显是一个不太方便的操做，期待POI下一版的改进了

  st.addMergedRegion(new Region(0, (short) 0, 0, (short) 2));

  HSSFRow row = st.createRow(0);

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

  cell.setCellValue(new HSSFRichTextString("业务一览表"));

  cell.setCellStyle(normalStyle);

  row.createCell((short) 1).setCellStyle(normalStyle);

  row.createCell((short) 2).setCellStyle(normalStyle);

  // 设置列头，固然也能够一个一个格子的写，用循环感受有些取巧而已

  // 一样，须要单独给每一个单元格应用样式对象

  String[] seasonName = { "第一季度", "第二季度", "第三季度", "第四季度" };

  for (short i = 3; i < 7; i++)

  {

  cell = row.createCell(i);

  cell.setCellValue(new HSSFRichTextString(seasonName[i - 3]));

  cell.setCellStyle(normalStyle);

  }

  // 这个是竖排文字的实现

  // 目前POI没找到（或许没提供，或许我无知）让文字竖排的方法，

  // HSSFCellStyle.setRotation()方法是设置旋转角度的，和竖排不太同样，

  // 后来想了一下，由于只有中文等全角字符才有竖排的可能，

  // 一个英文单词要是竖排看起来恐怕会很是怪异，不过不排除搞艺术的……

  st.addMergedRegion(new Region(1, (short) 0, 6, (short) 0));

  row = st.createRow(1);

  cell = row.createCell((short) 0);

  cell.setCellValue(new HSSFRichTextString("地\n区\n代\n理\nA"));

  cell.setCellStyle(normalStyle);

  for (int i = 2; i < 7; i++)

  st.createRow(i).createCell((short) 0).setCellStyle(normalStyle);

  // 属于地区的二级分类，竖向合并相邻的两个单元格，其余同上

  String[] shopName = { "连锁店A", "连锁店B", "连锁店C" };

  for (int i = 1; i < 6; i = i + 2)

  {

  row = st.createRow(i);

  cell = row.createCell((short) 1);

  cell.setCellValue(new HSSFRichTextString(shopName[(i - 1) / 2]));

  cell.setCellStyle(normalStyle);

  st.createRow(i + 1).createCell((short) 1).setCellStyle(normalStyle);

  st.addMergedRegion(new Region(i, (short) 1, i + 1, (short) 1));

  }

  // 属于连锁店的下一级，基本也是建立出来而后赋值+应用样式

  for (int i = 1; i < 7; i = i + 2)

  {

  cell = st.getRow(i).createCell((short) 2);

  cell.setCellValue(new HSSFRichTextString("收入"));

  cell.setCellStyle(normalStyle);

  cell = st.getRow(i + 1).createCell((short) 2);

  cell.setCellValue(new HSSFRichTextString("支出"));

  cell.setCellStyle(normalStyle);

  }

  // 数据部分，直接Create而后应用样式，有数据的话这个地方就打数据好了

  for (int i = 1; i < 7; i++)

  for (short j = 3; j < 7; j++)

  st.createRow(i).createCell(j).setCellStyle(normalStyle);

  // 冻结Excel的窗口，边界为数据部分的边界

  st.createFreezePane(3, 1);

  // 按照连锁店级别分组（固然实际状况这样分组没啥意义）

  for (int i = 1; i < 7; i = i + 2)

  st.groupRow(i, i);

  // 按照地区分组

  st.groupRow(1, 5);

其实这样实现起来是否是很麻烦呢？答案是：是。

其实这只是举个例子，熟悉一下POI的各类API而已，真正要实现这样一个表格的时候，例如项目须要制做报表等等，一般的作法都是事先把格式一切的东西都手动制做好（这个作好了的文件在实际的项目里咱们称之为“数据模板”，简称“模板”），而后在Java应用中适当的时机把这个文件读进来修改，最后再另存到指定的位置或者传递给下一个处理者（例如以流的方式送给Servlet等等），这样其实POI具体作的事情就是向模板里写业务的数据，仍是很方便快捷的。