POI和Java Excel Api导入导出

一、介绍

　　

       当前B/S模式已成为应用开发的主流，而在企业办公系统中，常常有客户这样子要求：你要把我们的报表直接用Excel打开(电信系统、银行系统)。或者是：我们已经习惯用Excel打印。这样在我们实际的开发中，很多时候需要实现导入、导出Excel的应用。

　　目前，比较常用的实现Java导入、导出Excel的技术有两种Jakarta POI和Java Excel

　　下面我就分别讲解一下如何使用这两个技术实现导入、导出Excel

二、使用Jakarta POI导入、导出Excel

　　Jakarta POI 是一套用于访问微软格式文档的Java API。Jakarta POI有很多组件组成，其中有用于操作Excel格式文件的HSSF和用于操作Word的HWPF，在各种组件中目前只有用于操作Excel的HSSF相对成熟。官方主页http://poi.apache.org/index.html，API文档http://poi.apache.org/apidocs/index.html

2.1 环境配置

　　2.1.1下载jar

　　官方下载：http://poi.apache.org/download.html这里可以下载到它的最新版本和文档，目前最新版本是3.7，这里使用比较稳定的3.6版。

　　2.1.2加入jar包

　　将根目录下的poi-3.6-20091214.jar和Lib目录下三个通用包 commons-logging-1.1.jar junit-3.8.1.jar log4j-1.2.13.jar拷贝到项目的Lib下

2.2 Jakarta POI HSSF API组件

　　HSSF（用于操作Excel的组件）提供给用户使用的对象在rg.apache.poi.hssf.usermodel包中,主要部分包括Excel对象，样式和格式，还有辅助操作。有以下几种对象： 

常用组件：

HSSFWorkbook                      excel的文档对象

HSSFSheet                         excel的表单

HSSFRow                           excel的行

HSSFCell                          excel的格子单元

HSSFFont                          excel字体

HSSFDataFormat                    日期格式

HSSFHeader                        sheet头

HSSFFooter                        sheet尾（只有打印的时候才能看到效果）

样式：

HSSFCellStyle                       cell样式

辅助操作包括：

HSSFDateUtil                        日期

HSSFPrintSetup                      打印

HSSFErrorConstants                  错误信息表

2.3 基本操作步骤

　　首先，理解一下一个Excel的文件的组织形式，一个Excel文件对应于一个workbook(HSSFWorkbook)，一个workbook可以有多个sheet（HSSFSheet）组成，一个sheet是由多个row（HSSFRow）组成，一个row是由多个cell（HSSFCell）组成。

　　基本操作步骤：

1、用HSSFWorkbook打开或者创建“Excel文件对象”

2、用HSSFWorkbook对象返回或者创建Sheet对象

3、用Sheet对象返回行对象，用行对象得到Cell对象

4、对Cell对象读写。

　　下面来看一个动态生成Excel文件的例子：

 

//创建HSSFWorkbook对象  
HSSFWorkbook wb = new HSSFWorkbook();  
//创建HSSFSheet对象  
HSSFSheet sheet = wb.createSheet("sheet0");  
//创建HSSFRow对象  
HSSFRow row = sheet.createRow(0);  
//创建HSSFCell对象  
HSSFCell cell=row.createCell(0);  
//设置单元格的值  
cell.setCellValue("单元格中的中文");  
//输出Excel文件  
FileOutputStream output=new FileOutputStream("d:\\workbook.xls");  
wkb.write(output);  
output.flush();  

 

　　HSSF读取文件同样还是使用这几个对象，只是把相应的createXXX方法变成了getXXX方法即可。可见只要理解了其中原理，不管是读还是写亦或是特定格式都可以轻松实现，正所谓知其然更要知其所以然。

2.4 导出Excel应用实例

　　 在2.3中我们寥寥几行代码实际上就已经就是实现了导出Excel一个简单示例，下面我们在看如何实现导出如图所示的Excel表格？

　　代码如下：（实际开发中应封装到业务层组件中，然后在控制层中调用。这里直接写在控制层组件，如Servlet的doGet/doPost方法或Struts框架的execute方法中）

 

//创建HSSFWorkbook对象(excel的文档对象)  
      HSSFWorkbook wb = new HSSFWorkbook();  
//建立新的sheet对象（excel的表单）  
HSSFSheet sheet=wkb.createSheet("成绩表");  
//在sheet里创建第一行，参数为行索引(excel的行)，可以是0～65535之间的任何一个  
HSSFRow row1=sheet.createRow(0);  
//创建单元格（excel的单元格，参数为列索引，可以是0～255之间的任何一个  
HSSFCell cell=row1.createCell(0);  
      //设置单元格内容  
cell.setCellValue("学员考试成绩一览表");  
//合并单元格CellRangeAddress构造参数依次表示起始行，截至行，起始列， 截至列  
sheet.addMergedRegion(new CellRangeAddress(0,0,0,3));  
//在sheet里创建第二行  
HSSFRow row2=sheet.createRow(1);      
      //创建单元格并设置单元格内容  
      row2.createCell(0).setCellValue("姓名");  
      row2.createCell(1).setCellValue("班级");      
      row2.createCell(2).setCellValue("笔试成绩");  
row2.createCell(3).setCellValue("机试成绩");      
      //在sheet里创建第三行  
      HSSFRow row3=sheet.createRow(2);  
      row3.createCell(0).setCellValue("李明");  
      row3.createCell(1).setCellValue("As178");  
      row3.createCell(2).setCellValue(87);      
      row3.createCell(3).setCellValue(78);      
  //.....省略部分代码  
  
  
//输出Excel文件  
    OutputStream output=response.getOutputStream();  
    response.reset();  
    response.setHeader("Content-disposition", "attachment; filename=details.xls");  
    response.setContentType("application/msexcel");          
    wkb.write(output);  
    output.close();  
retrun null;  

 

　　加下划线这部分代码是B/S模式中采用的输出方式，而不是输出到本地指定的磁盘目录。该代码表示将details.xls的Excel文件通过应答实体（response）输出给请求的客户端浏览器，客户端可保存或直接打开。

2.5 样式设置

　　在实际应用中导出的Excel文件往往需要阅读和打印的，这就需要对输出的Excel文档进行排版和样式的设置，主要操作有合并单元格、设置单元格样式、设置字体样式等。

　　2.5.1单元格合并

    使用HSSFSheet的addMergedRegion()方法

1. public int addMergedRegion(CellRangeAddress region)  

    参数CellRangeAddress 表示合并的区域，构造方法如下：

1. CellRangeAddress(int firstRow, int lastRow, int firstCol, int lastCol)  

　　构造参数依次表示起始行，截至行，起始列， 截至列。示例代码参照2.4部分

2.5.2设置单元格的行高、列宽

 

 

HSSFSheet sheet=wb.createSheet();  
  
sheet.setDefaultRowHeightInPoints(10);//设置缺省列高
sheet.setDefaultColumnWidth(20);//设置缺省列宽  
  
//设置指定列的列宽，256 * 50这种写法是因为width参数单位是单个字符的256分之一  
  
sheet.setColumnWidth(cell.getColumnIndex(), 256 * 50);  

　　2.5.2单元格样式

　　1、创建HSSFCellStyle

HSSFCellStyle cellStyle=wkb.createCellStyle()  

　　2、设置样式

 

// 设置单元格的横向和纵向对齐方式，具体参数就不列了，参考HSSFCellStyle  
  
 cellStyle.setAlignment(HSSFCellStyle.ALIGN_JUSTIFY);  
  
 cellStyle.setVerticalAlignment(HSSFCellStyle.VERTICAL_CENTER);  
  
 /* 设置单元格的填充方式，以及前景颜色和背景颜色 

  三点注意： 

  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);  
  
 //设置日期型数据的显示样式  
  
 cellStyle.setDataFormat(HSSFDataFormat.getBuiltinFormat("m/d/yy h:mm"));    

 

　　3、将样式应用于单元格

 

cell.setCellStyle(cellStyle);  
  
//将样式应用到行，但有些样式只对单元格起作用  
  
row.setRowStyle(cellStyle);  

 

　　2.5.2设置字体样式

　　1、创建HSSFFont对象（调用HSSFWorkbook 的createFont方法）

 

HSSFWorkbook wb=new HSSFWorkbook();  
  
HSSFFont  fontStyle=wb.createFont();  
  
HSSFWorkbook wb=new HSSFWorkbook ();  

 

　　2、设置字体各种样式

 

  //设置字体样式  
  
  fontStyle.setFontName("宋体");    
  
  //设置字体高度  
  
  fontStyle.setFontHeightInPoints((short)20);    
  
  //设置字体颜色  
  
  font.setColor(HSSFColor.BLUE.index);  
  
  //设置粗体  
  
  fontStyle.setBoldweight(HSSFFont.BOLDWEIGHT_BOLD);  
  
  //设置斜体  
  
font.setItalic(true);  
  
//设置下划线  
  
font.setUnderline(HSSFFont.U_SINGLE);  

 

　　3、将字体设置到单元格样式

//字体也是单元格格式的一部分，所以从属于HSSFCellStyle  
  
// 将字体对象赋值给单元格样式对象  
  
cellStyle.setFont(font);  
  
// 将单元格样式应用于单元格  
  
cell.setCellStyle(cellStyle);  

 

2.6 导入Excel应用实例

　　实现将已存在的Excel文件中的数据导入到系统中的基本步骤同导出十分的类似，关键在于要了解要导入Excel文件的结构，比如数据有哪些列、读取数据起始位置（有效数据从第几行几列开始）等。

 

public List loadScoreInfo(String xlsPath) throws IOException{  
    List temp = new ArrayList();  
    FileInputStream fileIn = new FileInputStream(xlsPath);  
    //根据指定的文件输入流导入Excel从而产生Workbook对象  
    Workbook wb0 = new HSSFWorkbook(fileIn);  
    //获取Excel文档中的第一个表单  
    Sheet sht0 = wb0.getSheetAt(0);  
    //对Sheet中的每一行进行迭代  
    for (Row r : sht0) {  
        //如果当前行的行号（从0开始）未达到2（第三行）则从新循环  
           If(r.getRowNum()<1){  
              continue;  
           }  
        //创建实体类  
        ScoreInfo info=new ScoreInfo();  
        //取出当前行第1个单元格数据，并封装在info实体stuName属性上  
        info.setStuName(r.getCell(0).getStringCellValue());  
        info.setClassName(r.getCell(1).getStringCellValue());  
        info.setRscore(r.getCell(2).getNumericCellValue());  
        info.setLscore(r.getCell(3).getNumericCellValue());  
        temp.add(info);  
     }  
        fileIn.close();      
        return temp;      
    }  

三、使用java Excel操作Excel文件

 　　Java Excel是一开放源码项目，通过它Java开发人员可以读取Excel文件的内容、创建新的Excel文件、更新已经存在的Excel文件。jxl 由于其小巧 易用的特点, 逐渐已经取代了 POI-excel的地位, 成为了越来越多的java开发人员生成excel文件的首选。Java  Excel的特征：

● 支持Excel 95-2000的所有版本 
         ● 生成Excel 2000标准格式 
         ● 支持字体、数字、日期格式化操作 
         ● 支持对单元格加阴影和加色彩；

● 修改存在的工作表；
         ● 支持图像和图表

● 日志记录可以定制

● 更小更快更省内存

　　应该说以上功能已经能够大致满足我们的需要。最关键的是这套API是纯Java的，并不依赖Windows系统，即使运行在Linux下，它同样能够正确的处理Excel文件。另外需要说明的是，这套API对图形和图表的支持很有限，而且仅仅识别PNG格式。在线帮助文档http://jexcelapi.sourceforge.net/resources/javadocs/2_6_10/docs/index.html

　　在这里我们将通过一些实例，学习掌握读取、新建、更新，其中也包括常见格式的设置:字体、颜色、背景、合并单元格等操作，有这些其实已经基本足够应付大部分问题了。

3.1环境配置

　　3.1.1下载

　　下载地址    http://www.andykhan.com/jexcelapi/

　　3.1.2 加入jar包

　　将jxl.jar拷贝到项目的Lib下

3.2 使用Java Excel Api 导出 Excel文件

　　下面我们在看如何使用Java Excel实现导出Excel表格？

　　代码如下：（实际开发中应封装到业务层组件中，然后在控制层中调用。这里直接写在控制层组件，如Servlet的doGet/doPost方法或Struts框架的execute方法中）

//获得输出流，该输出流的输出介质是客户端浏览器  
  
  OutputStream output=response.getOutputStream();  
  
  response.reset();  
  
  response.setHeader("Content-disposition","attachment;           filename=temp.xls");  
  
  response.setContentType("application/msexcel");  
  
  //创建可写入的Excel工作薄，且内容将写入到输出流，并通过输出流输出给客户端浏览  
  
  WritableWorkbook wk=Workbook.createWorkbook(output);  
  
  
///创建可写入的Excel工作表  
  
 WritableSheet sheet=wk.createSheet("成绩表", 0);  
  
//把单元格（column, row）到单元格（column1, row1）进行合并。  
  
//mergeCells(column, row, column1, row1);  
  
  sheet.mergeCells(0,0, 4,0);//单元格合并方法  
  
//创建WritableFont 字体对象，参数依次表示黑体、字号12、粗体、非斜体、不带下划线、亮蓝色  
  
WritableFont titleFont=new WritableFont(WritableFont.createFont("黑体"),12,WritableFont.BOLD,false,UnderlineStyle.NO_UNDERLINE,Colour.LIGHT_BLUE);  
  
//创建WritableCellFormat对象，将该对象应用于单元格从而设置单元格的样式  
  
WritableCellFormat titleFormat=new WritableCellFormat();  
  
//设置字体格式  
  
titleFormat.setFont(titleFont);  
  
//设置文本水平居中对齐  
  
titleFormat.setAlignment(Alignment.CENTRE);  
  
//设置文本垂直居中对齐  
  
titleFormat.setVerticalAlignment(VerticalAlignment.CENTRE);  
  
//设置背景颜色  
  
titleFormat.setBackground(Colour.GRAY_25);  
  
//设置自动换行  
  
titleFormat.setWrap(true);  
  
//添加Label对象，参数依次表示在第一列，第一行，内容，使用的格式  
  
Label lab_00=new Label(0,0,"学员考试成绩一览表",titleFormat);  
  
//将定义好的Label对象添加到工作表上，这样工作表的第一列第一行的内容为‘学员考试成绩一览表’并应用了titleFormat定义的样式  
  
sheet.addCell(lab_00);  
  
WritableCellFormat cloumnTitleFormat=new WritableCellFormat();  
  
cloumnTitleFormat.setFont(new WritableFont(WritableFont.createFont("宋体"),10,WritableFont.BOLD,false));  
  
cloumnTitleFormat.setAlignment(Alignment.CENTRE);  
  
Label lab_01=new Label(0,1,"姓名",cloumnTitleFormat);  
  
Label lab_11=new Label(1,1,"班级",cloumnTitleFormat);  
  
Label lab_21=new Label(2,1,"笔试成绩",cloumnTitleFormat);  
  
Label lab_31=new Label(3,1,"上机成绩",cloumnTitleFormat);  
  
Label lab_41=new Label(4,1,"考试日期",cloumnTitleFormat);  
  
  sheet.addCell(lab_01);  
  
  sheet.addCell(lab_11);  
  
  sheet.addCell(lab_21);  
  
  sheet.addCell(lab_31);  
  
  sheet.addCell(lab_41);  
  
  sheet.addCell(new Label(0,2,"李明"));  
  
  sheet.addCell(new Label(1,2,"As178"));  
  
//定义数字格式  
  
NumberFormat nf=new NumberFormat("0.00");  
  
WritableCellFormat wcf=new WritableCellFormat(nf);  
  
//类似于Label对象，区别Label表示文本数据，Number表示数值型数据  
  
Number numlab_22=new Number(2,2,78,wcf);  
  
sheet.addCell(numlab_22);  
  
sheet.addCell(newNumber(3,2,87,new WritableCellFormat(new NumberFormat("#.##") )));  
  
//定义日期格式  
  
DateFormat df=new DateFormat("yyyy-MM-dd hh:mm:ss");  
  
//创建WritableCellFormat对象  
  
WritableCellFormat datewcf=new WritableCellFormat(df);  
  
//类似于Label对象，区别Label表示文本数据，DateTime表示日期型数据  
  
DateTime dtLab_42=new DateTime(4,2,new Date(),datewcf);  
  
sheet.addCell(dtLab_42);     
  
//将定义的工作表输出到之前指定的介质中（这里是客户端浏览器）  
  
wk.write();  
  
//操作完成时，关闭对象，释放占用的内存空间     
  
wk.close();  
　　加下划线这部分代码是B/S模式中采用的输出方式，而不是输出到本地指定的磁盘目录。该代码表示将temp.xls的Excel文件通过应答实体（response）输出给请求的客户端浏览器，下载到客户端本地（保存或直接打开）。若要直接输出到磁盘文件可采用下列代码替换加下划线这部分代码  
File file=new File("D://temp.xls");  
WritableWorkbook wwb = Workbook.createWorkbook(file);   

3.3高级操作

　　3.3.1数据格式化

　　在Excel中不涉及复杂的数据类型，能够比较好的处理字串、数字和日期已经能够满足一般的应用即可。

　　数据的格式化涉及到的是字体、粗细、字号等元素，这些功能主要由 WritableFont和WritableCellFormat类来负责。例如：

① WritableFont font=new WritableFont(WritableFont.createFont("宋体"),12,WritableFont.NO_BOLD );

② WritableCellFormat format1=new WritableCellFormat(font);

③ Label label=new Label(0,0,”data 4 test”,format1);

　　其中

I.指定了字串格式：字体为宋体，字号16，加粗显示。WritableFont有非常丰富的构造子，供不同情况下使用，jExcelAPI的java-doc中有详细列表，这里不再列出。

II. 处代码使用了WritableCellFormat类，这个类非常重要，通过它可以指定单元格的各种属性，如上例代码所示。

III. 处使用了Label类的构造子，指定了显示的位置，文本内容，字串被赋予的格式。

与Label类似的Number、DateTime，区别Label表示文本数据；Number表示数值数据，可使NumberFormat格式化数据；用DateTime表示日期型数据，可应用DateFormat格式化数据。

　　3.3.2单元格操作

　　Excel中很重要的一部分是对单元格的操作，比如行高、列宽、单元格合并等，所幸jExcelAPI提供了这些支持。这些操作相对比较简单，下面只介绍一下相关的API。

　　1、 合并单元格

WritableSheet.mergeCells(int m,int n,int p,int q);  
  
//作用是从(m,n)到(p,q)的单元格全部合并，比如：  
  
WritableSheet sheet=book.createSheet(“第一页”,0);  
  
//合并第一列第一行到第六列第一行的所有单元格  
  
sheet.mergeCells(0,0,5,0);  
  
//合并既可以是横向的，也可以是纵向的。合并后的单元格不能再次进行合并，否则会触发异常。  

 

　　2、 行高和列宽

 writableSheet.setRowView(int i,int height);  
  
//作用是指定第i+1行的高度，比如：  
  
// 将第一行的高度设为200  
  
sheet.setRowView(0,200);  
  
WritableSheet.setColumnView(int i,int width);  
  
//作用是指定第i+1列的宽度，比如：  
  
//将第一列的宽度设为30  
  
sheet.setColumnView(0,30);   

3.4 　从Excel文件读取数据表

　　我们就以导入3.2所产生的excel表为例，掌握如何编写导入Excel代码(该代码封装在业务层方法)

 

public List loadScoreInfo(String xlsPath) throws IOException, BiffException{  
  
        //导入已存在的Excel文件，获得只读的工作薄对象  
        FileInputStream fis=new FileInputStream(xlsPath);  
        Workbook wk=Workbook.getWorkbook(fis);  
        //获取第一张Sheet表   
        Sheet sheet=wk.getSheet(0);  
        //获取总行数  
        int rowNum=sheet.getRows();  
        //从数据行开始迭代每一行  
        for(int i=2;i

 

3.4 　更新已存在的Excel文件

　　将3.2所产生的excel表（temp.xls）的第一条记录（excel文件的指第三行）的班级名称改为As179，代码如下：

    File file=new File("d://temp.xls");  
    //导入已存在的Excel文件，获得只读的工作薄对象  
    Workbook wk=Workbook.getWorkbook(file);  
    //根据只读的工作薄对象（wk）创建可写入的Excel工作薄对象   
    WritableWorkbook wwb=Workbook.createWorkbook(file, wk);  
    //读取第一张工作表   
    WritableSheet sheet=wwb.getSheet(0);  
    //获得要编辑的单元格对象   
    WritableCell cell=sheet.getWritableCell(1, 2);  
    //判断单元格的类型, 做出相应的转化   
        if(cell.getType()==CellType.LABEL){  
            Label lable=(Label)cell;  
            //修改单元格的内容  
            lable.setString("As179");  
        }  
    wwb.write();   
    wwb.close();   
    wk.close();   

　　对于更新已存在的Excel文件实际上就是获取已有工作薄对象（但是只读的），然后将获取的只读的工作薄对象转化为可写入的Excel工作薄对象（WritableWorkbook ），其他部分就是通过可写入WritableSheet 对象和可写入WritableCell 对象进行编辑。