用POI HSSF处理EXCEL表格

POI的主页：http://jakarta.apache.org/poi

POI HSSF的Quick Guide,教初学者如何快速上手使用POI HSSF：

http://jakarta.apache.org/poi/hssf/quick-guide.html

笔者据使用经验以为：POI HSSF是当今市面上最强大的处理EXCEL表格的java工具，比韩国人写的那个JExcelApi或其它几种工具都要好。而且它是Apache的开源项目。当然POI HSSF也有缺点：不能直接支持EXCEL图表，API文档粗糙简略，有些类和方法需要引用Apache项目中的其它一些包，包与包之间依赖关系比较复杂等等。

本文内容不在于提供一个POI HSSF 的完整使用指南（上面那个Apache主页上的Quick Guide已经非常详细），而是列出一些笔者在项目开发过程中找到的一些技巧、经验。

下图是定义的模板PoiTest.xls:

通过POI生成的最终结果：

(单元格中的数据发生变化时，图表中的柱状、折线也会跟着变化）

处理图表

目前POI版本为2.5.1，org.apache.poi.hssf.usermodel包里有一个HSSFChart类，里面只有一个空方法createBarChart()，表明POI还不直接支持EXCEL图表。

替代方法还是有的：因为EXCEL图表的源数据引用自EXCEL单元格。我们可以先新建一个EXCEL工作薄，作为模板，在里面创建图表，指定它引用工作表中的一些特定单元格。然后我们用POI来读取这个工作薄，把数据写入到那些特定单元格。

首先要在模板里创建可以动态引用单元格的“名称”，利用“名称”来创建图表中的“系列”。

一、打开模板PoiTest.xls,点击[插入]>[名称]>[定义]，创建四个“名称”sx，s1y,s2y,s3y:

sx=OFFSET(Sheet1!$A$17,0,2,1,COUNTA(Sheet1!$17:$17)-4)

s1y=OFFSET(Sheet1!$A$18,0,2,1,COUNTA(Sheet1!$18:$18)-4)

s2y=OFFSET(Sheet1!$A$19,0,2,1,COUNTA(Sheet1!$19:$19)-3)

s3y=OFFSET(Sheet1!$A$20,0,2,1,COUNTA(Sheet1!$20:$20)-3)

这里用到了两个EXCEL函数，OFFSET()和COUNTA()函数。

其中COUNTA（）可以返回一行或一列的单元格总数：

比如COUNTA(Sheet1!$A:$A)，计算工作表Sheet1的A列的单元格数目。

又比如COUNTA(Sheet1!$17:$17)，计算的是Sheet1的第17行的单元格数目。

当我们没有在单元格里键入数据时，该单元格是不会被COUNTA()计算的。

OFFSET()函数用来引用一系列连续的单元格，它共有五个参数：

参数一，作为位置参照的单元格。

参数二，行的起始偏移量（以参数一为参照）。

参数三，列的起始偏移量（以参数一为参照）。

参数四，跨行数。

参数五，跨列数。

比如：

OFFSET(Sheet1!$A:$1,1,2,3,4),表示引用范围为：C2:F4。

二、在模板中创建图表，在图表上点右键，选择[源数据]>[系列],如图建立三个系列：

点[添加]创建新的系列：

[名称]表示系列名，可以直接输入字串，也可以引用EXCEL单元格。

在[值]中输入我们在上一步中创建的“名称”，格式为:模板名.xls!名称。

在[分类(X)轴标志(T)]中输入我们在上一步中创建的“名称”sx,格式为:模板名.xls!名称。它表示图表区域的X轴将要显示的内容。

三、用POI把数据写入到相应的单元格中，图表将会自动显示对应的信息。

注意：

上面这种方法适用数据集合行数固定而列数动态变化的情况。

对于行数也动态变化的情况，只能先在模板里预设尽可能多的“名称”和“系列”。

对于行数和列数都固定的情形，没必要这么复杂，只要在图表的[源数据]里设置[数据区域]，使之引用EXCEL模板中的一定范围，如下图：

 

设置单元格样式

HSSFCellStyle类代表一种单元格样式。可以通过这个类来设置单元格的边框样式 、背景颜色 、字体 、水平 和垂直 对齐方式等等。

 

HSSFCellStyle titleStyle = workbook.createCellStyle(); titleStyle.setBorderBottom(HSSFCellStyle.BORDER_DOUBLE); titleStyle.setBorderLeft((short)1); titleStyle.setBorderRight((short)1); titleStyle.setBorderTop(HSSFCellStyle.BORDER_DOUBLE); titleStyle.setFillForegroundColor(HSSFColor.LIGHT_ORANGE.index); titleStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND);

注意：如果我们定义了一种样式，把它赋给一些单元格。然后基于新的需要，更改该样式中的某个属性，再赋给另一些单元格。那么之前单元格样式的该属性也会被同时更改。

比如我们定义了样式，设置单元格背景色为红色：

 

HSSFCellStyle cellStyle = workbook.createCellStyle(); cellStyle.setFillForegroundColor(HSSFColor.RED .index); cellStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND);

然后把它赋给一个单元格：

 

HSSFCell cell1 = row.createCell((short)1); cell1.setCellStyle(cellStyle);

然后更改样式中的背景色属性为蓝色：

 

cellStyle.setFillForegroundColor(HSSFColor.BLUE .index);

然后赋给另一个单元格：

 

HSSFCell cell2 = row.createCell((short)2); cell2.setCellStyle(cellStyle);

想当然，我们预计在最终结果中cell1的背景色为红色，cell2的背景色为蓝色。但是结果是：两个单元格的背景色都变成了蓝色。

遇到这种情况，要预先定义两种不同的单元格样式。

当一个EXCEL文件同时需要很多大同小异的单元格样式时，这样一一定义很麻烦。POI HSSF提供了一个HSSFCellUtil类（在org.apache.poi.hssf.usermodel.contrib包），里面有几个方法可以绕过HSSFCellStyle直接设定单元格的样式，但这几个方法会抛出NestableException异常，要处理这个异常，需要引用Apache的几个Common包：

commons-beanutils.jar

commons-beanutils-bean-collections.jar

commons-beanutils-core.jar

commons-lang.jar

commons-logging-api.jar

合并单元格

HSSFSheet.addMergedRegion(new Region())方法可以合并单元格，Region()中的一个构造函数含有四个参数，分别代表起始行、起始列、结束行、结束列：

 

sheet.addMergedRegion(new Region(initRow, (short)(initCol-2), initRow + lists.size() - 1, (short)(initCol-2)));

处理公式

HSSFCell.setCellFormula()方法用来在EXCEL单元格中写入公式。

 

cell = row.createCell((short)(dataFlag)); cell.setCellType(HSSFCell.CELL_TYPE_FORMULA); cell.setCellFormula("SUM(" + getColLetter(initCol) + (listFlag+1) + ":" + getColLetter(dataFlag-1) + (listFlag+1) + ")"); cell.setCellStyle(nameStyle);

处理链接

在POI中往单元格中写链接，是用HYPERLINK函数搞定的。

HYPERLINK函数包含两个参数，第一个参数是指向的URL地址，第二个参数是显示字串。

 

cell = row.createCell((short)(dataFlag)); cell.setCellType(HSSFCell.CELL_TYPE_FORMULA); cell.setCellFormula("HYPERLINK(\" http://www.xxxxx.com/xxx.jsp?id=1\",\"homepage\ ")"); cell.setCellStyle(linkStyle);

为了使链接效果更好，我们可以给链接所在单元格定义一种样式，使链接显示为有下划线的蓝色字串：

 

HSSFCellStyle linkStyle = workbook.createCellStyle(); linkStyle.setBorderBottom((short)1); linkStyle.setBorderLeft((short)1); linkStyle.setBorderRight((short)1); linkStyle.setBorderTop((short)1); linkStyle.setFillForegroundColor(HSSFColor.SKY_BLUE.index); linkStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); HSSFFont font = workbook.createFont(); font.setFontName(HSSFFont.FONT_ARIAL); font.setUnderline((byte)1); font.setColor(HSSFColor.BLUE.index); linkStyle.setFont(font);

中文处理：

要在通过POI生成的EXCEL中正常显示中文，需要为单元格设置编码：

 

cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue("部门");

 

完整的PoiServlet类：

 

package org.eleaf.poi.servlets; import java.io.IOException; import java.io.PrintWriter; import java.util.ArrayList; import java.util.HashMap; import java.util.Iterator; import java.util.List; import javax.servlet.ServletException; import javax.servlet.ServletOutputStream; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.apache.poi.hssf.usermodel.HSSFCell; import org.apache.poi.hssf.usermodel.HSSFCellStyle; import org.apache.poi.hssf.util.HSSFColor; import org.apache.poi.hssf.util.Region; import org.apache.poi.hssf.usermodel.HSSFFont; import org.apache.poi.hssf.usermodel.HSSFRow; import org.apache.poi.hssf.usermodel.HSSFSheet; import org.apache.poi.hssf.usermodel.HSSFWorkbook; public class PoiServlet extends HttpServlet { public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("application/vnd.ms-excel;charset=utf-8"); response.setHeader("Content-Disposition", "attachment;filename=PoiTest.xls"); ServletOutputStream sos = response.getOutputStream(); HSSFWorkbook workbook = new HSSFWorkbook(getServletContext().getResourceAsStream("/PoiTest.xls")); HashMap map = getDatas(); workbook = writeDatas(workbook, map); workbook.write(sos); sos.close(); } /** * 将数据写入到EXCEL中。 * @param workbook * @param map 数据集合 * @return */ private HSSFWorkbook writeDatas(HSSFWorkbook workbook, HashMap map) { HSSFCellStyle titleStyle = workbook.createCellStyle(); titleStyle.setBorderBottom(HSSFCellStyle.BORDER_DOUBLE); titleStyle.setBorderLeft((short)1); titleStyle.setBorderRight((short)1); titleStyle.setBorderTop(HSSFCellStyle.BORDER_DOUBLE); titleStyle.setFillForegroundColor(HSSFColor.LIGHT_ORANGE.index); titleStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); HSSFCellStyle dataStyle = workbook.createCellStyle(); dataStyle.setBorderBottom((short)1); dataStyle.setBorderLeft((short)1); dataStyle.setBorderRight((short)1); dataStyle.setBorderTop((short)1); dataStyle.setFillForegroundColor(HSSFColor.LIGHT_GREEN.index); dataStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); dataStyle.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER); HSSFCellStyle nameStyle = workbook.createCellStyle(); nameStyle.setBorderBottom((short)1); nameStyle.setBorderLeft((short)1); nameStyle.setBorderRight((short)1); nameStyle.setBorderTop((short)1); nameStyle.setFillForegroundColor(HSSFColor.LIGHT_CORNFLOWER_BLUE.index); nameStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); HSSFCellStyle linkStyle = workbook.createCellStyle(); linkStyle.setBorderBottom((short)1); linkStyle.setBorderLeft((short)1); linkStyle.setBorderRight((short)1); linkStyle.setBorderTop((short)1); linkStyle.setFillForegroundColor(HSSFColor.SKY_BLUE.index); linkStyle.setFillPattern(HSSFCellStyle.SOLID_FOREGROUND); HSSFFont font = workbook.createFont(); font.setFontName(HSSFFont.FONT_ARIAL); font.setUnderline((byte)1); font.setColor(HSSFColor.BLUE.index); linkStyle.setFont(font); HSSFSheet sheet = workbook.getSheetAt(0); final int initRow = 17; final int initCol = 2; HSSFRow rTitle = sheet.createRow(initRow - 1); List lists = (List) map.get("list"); List titles = (List)map.get("title"); int titleFlag = initCol; for (Iterator it = titles.iterator(); it.hasNext();) { String title = (String)it.next(); HSSFCell cell = rTitle.createCell((short)titleFlag); cell.setCellStyle(titleStyle); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setCellValue(title); titleFlag++; } HSSFCell cell = rTitle.createCell((short)(titleFlag)); cell.setCellStyle(titleStyle); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue("总计"); titleFlag++; cell = rTitle.createCell((short)(titleFlag)); cell.setCellStyle(titleStyle); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue("链接"); cell = rTitle.createCell((short)(initCol-1)); cell.setCellStyle(titleStyle); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue("职员"); cell = rTitle.createCell((short)(initCol-2)); cell.setCellStyle(titleStyle); cell.setCellType(HSSFCell.CELL_TYPE_STRING); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue("部门"); int listFlag = initRow; for (Iterator it = lists.iterator(); it.hasNext();) { String name = (String)it.next(); List datas = (List)map.get(name); HSSFRow row = sheet.createRow(listFlag); cell = row.createCell((short)(initCol-1)); cell.setCellStyle(nameStyle); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellValue(name); cell = row.createCell((short)(initCol-2)); cell.setEncoding(HSSFCell.ENCODING_UTF_16); cell.setCellStyle(dataStyle); int dataFlag = initCol; System.out.println("datas=" + datas); for (Iterator ite = datas.iterator(); ite.hasNext();) { int data = ((Integer)ite.next()).intValue(); cell = row.createCell((short)dataFlag); cell.setCellStyle(dataStyle); cell.setCellType(HSSFCell.CELL_TYPE_NUMERIC); cell.setCellValue(data); dataFlag++; } cell = row.createCell((short)(dataFlag)); cell.setCellType(HSSFCell.CELL_TYPE_FORMULA); cell.setCellFormula("SUM(" + getColLetter(initCol) + (listFlag+1) + ":" + getColLetter(dataFlag-1) + (listFlag+1) + ")"); cell.setCellStyle(nameStyle); dataFlag++; cell = row.createCell((short)(dataFlag)); cell.setCellType(HSSFCell.CELL_TYPE_FORMULA); cell.setCellFormula("HYPERLINK(\"http://www.xxxxx.com/xxx.jsp?id=1\",\"homepage\ ")"); cell.setCellStyle(linkStyle); listFlag++; } sheet.getRow(initRow).getCell((short)(initCol-2)).setCellValue("武装部"); sheet.addMergedRegion(new Region(initRow, (short)(initCol-2), initRow + lists.size() - 1, (short)(initCol-2))); return workbook; } /** * 将列的索引换算成ABCD字母，这个方法要在插入公式时用到。 * @param colIndex 列索引。 * @return ABCD字母。 */ private String getColLetter(int colIndex) { String ch = ""; if (colIndex < 26) ch = "" + (char)((colIndex) + 65); else ch = "" + (char)((colIndex) / 26 + 65 - 1) + (char)((colIndex) % 26 + 65); return ch; } /** * 获得数据，组织为HashMap. 这里为了演示方便，简单生成了一些数据。在实际应用中，是从 * 数据库中获取数据的。 * @return 组织后的数据 */ private HashMap getDatas() { HashMap map = new HashMap(); List lists = new ArrayList(); List title = new ArrayList(); List a = new ArrayList(); List b = new ArrayList(); List c = new ArrayList(); for (int i = 1; i <= 8; i++) { title.add(i + "月"); a.add(new Integer((int)(Math.random() * 10))); b.add(new Integer((int)(Math.random() * 10))); c.add(new Integer((int)(Math.random() * 10))); } map.put("荆轲", a);lists.add("荆轲"); map.put("专诸", b); lists.add("专诸"); map.put("聂政", c); lists.add("聂政"); map.put("list", lists); map.put("title", title); System.out.println("map=" + map); return map; } public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request, response); } }