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("部门");

 

import org.apache.poi.hssf.usermodel.HSSFCell;
import org.apache.poi.hssf.usermodel.HSSFCellStyle;
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;
import org.apache.poi.hssf.usermodel.HSSFRichTextString;
import org.apache.poi.hssf.usermodel.HSSFDataFormat;
import org.apache.poi.hssf.usermodel.HSSFComment;
import org.apache.poi.hssf.usermodel.HSSFPatriarch;
import org.apache.poi.hssf.usermodel.HSSFClientAnchor;

public class PoiCreateExcelTest ... {
     public static void main(String[] args) ... {
         /** */ /**
          * @see <a href=" http://poi.apache.org/hssf/quick-guide.html #NewWorkbook">For more</a>
          */         
         // 创建新的Excel 工作簿
         HSSFWorkbook workbook = new HSSFWorkbook();
        
         // 在Excel工作簿中建一工作表，其名为缺省值, 也可以指定Sheet名称
         HSSFSheet sheet = workbook.createSheet();
         // HSSFSheet sheet = workbook.createSheet("SheetName");
        
         // 用于格式化单元格的数据
         HSSFDataFormat format = workbook.createDataFormat();
        
         // 创建新行(row),并将单元格(cell)放入其中. 行号从0开始计算.
         HSSFRow row = sheet.createRow(( short ) 1 );

         // 设置字体
         HSSFFont font = workbook.createFont();
         font.setFontHeightInPoints(( short ) 20 ); // 字体高度
         font.setColor(HSSFFont.COLOR_RED); // 字体颜色
         font.setFontName( " 黑体 " ); // 字体
         font.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD); // 宽度
         font.setItalic( true ); // 是否使用斜体
//          font.setStrikeout(true); // 是否使用划线

         // 设置单元格类型
         HSSFCellStyle cellStyle = workbook.createCellStyle();
         cellStyle.setFont(font);
         cellStyle.setAlignment(HSSFCellStyle.ALIGN_CENTER); // 水平布局：居中
         cellStyle.setWrapText( true );
        
         // 添加单元格注释
         // 创建HSSFPatriarch对象,HSSFPatriarch是所有注释的容器.
         HSSFPatriarch patr = sheet.createDrawingPatriarch();
         // 定义注释的大小和位置,详见文档
         HSSFComment comment = patr.createComment( new HSSFClientAnchor( 0 , 0 , 0 , 0 , ( short ) 4 , 2 , ( short ) 6 , 5 ));
         // 设置注释内容
         comment.setString( new HSSFRichTextString( " 可以在POI中添加注释！ " ));
         // 设置注释作者. 当鼠标移动到单元格上是可以在状态栏中看到该内容.
         comment.setAuthor( " Xuys. " );
        
         // 创建单元格
         HSSFCell cell = row.createCell(( short ) 1 );
         HSSFRichTextString hssfString = new HSSFRichTextString( " Hello World! " );
         cell.setCellValue(hssfString); // 设置单元格内容
         cell.setCellStyle(cellStyle); // 设置单元格样式
         cell.setCellType(HSSFCell.CELL_TYPE_STRING); // 指定单元格格式：数值、公式或字符串
         cell.setCellComment(comment); // 添加注释

         // 格式化数据
         row = sheet.createRow(( short ) 2 );
         cell = row.createCell(( short ) 2 );
         cell.setCellValue( 11111.25 );
         cellStyle = workbook.createCellStyle();
         cellStyle.setDataFormat(format.getFormat( " 0.0 " ));
         cell.setCellStyle(cellStyle);

         row = sheet.createRow(( short ) 3 );
         cell = row.createCell(( short ) 3 );
         cell.setCellValue( 9736279.073 );
         cellStyle = workbook.createCellStyle();
         cellStyle.setDataFormat(format.getFormat( " #,##0.0000 " ));
         cell.setCellStyle(cellStyle);
        
        
         sheet.autoSizeColumn(( short ) 0 ); // 调整第一列宽度
         sheet.autoSizeColumn(( short ) 1 ); // 调整第二列宽度
         sheet.autoSizeColumn(( short ) 2 ); // 调整第三列宽度
         sheet.autoSizeColumn(( short ) 3 ); // 调整第四列宽度

         try ... {
             FileOutputStream fileOut = new FileOutputStream( " C:\3.xls " );
             workbook.write(fileOut);
             fileOut.close();
         } catch (Exception e) ... {
             System.out.println(e.toString());
         }
     }

}

如果不可以，可以使用下面相关方法！

   1. font1 = wb.createFont();  
   2. System.out.println(HSSFFont.COLOR_RED);  
   3. font1.setColor(HSSFFont.COLOR_RED);  
   4. font2 = wb.createFont();  
   5. font2.setColor(HSSFColor.BLUE.index);  
   6. HSSFRichTextString textString = new  HSSFRichTextString( "Hello,World!Hello,World!" );  
   7. textString.applyFont(0 ,  5 , font1);  
   8. textString.applyFont(12 ,  17 , font2);  
   9. cell.setCellValue(textString); 

 

 

 

完整的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);
 }

}

评论

1 楼 kyan54 2011-07-20  

太牛B了。。。。非常感谢。。。