Java文件操作系列[2]——使用JXL操作Excel文件

由于java流无法实现对Excel文件的读写操作，因此在项目中经常利用第三方开源的组件来实现。支持Excel文件操作的第三方开源组件主要有Apache的POI和开源社区的JXL。

总体来说，二者的区别是：JXL较为轻量级，如果是对Excel文件的简单操作，建议使用JXL；POI的功能相当强大，但同时处理问题也相当的繁琐。

1.准备工作

　　【必需】下载JXL的jar包：jxl.jar

　　【非必需】JXL API  （提取密码：zgqj）

2.一些必要的说明

　　主要是对Excel结构的说明：

• 　　Excel后缀为xls或者xlsx  —— Excel文件对应JXL的WritableWorkbook类。
• 　　Excel中可以有多个工作表（也就是左下角的sheet*，见下表） —— 对应JXL的WritableSheet类。

　　　　　　

• 　　Excel单元格相当于矩阵，有自己的行、列 —— 对应JXL的Cell类。

3.开始编程

　　封装了4个方法：

public static void writeExcel(String fileName); —— 写Excel文件
public static String readExcel(File file); —— 读取Excel文件
public static Boolean searchKeyWord(File file, String keyWord); —— 搜索Excel文件中是否包含关键字
public static void insertImage(WritableSheet sheet,int col, int row,int width, int height,File imageFile); —— 向Excel中插入图片(仅限png格式的图片，其余格式如jgp、gif等暂不支持)

package com.myeclipse;

import java.io.File;
import java.io.IOException;

import jxl.Cell;
import jxl.Sheet;
import jxl.Workbook;
import jxl.read.biff.BiffException;
import jxl.write.Label;
import jxl.write.WritableImage;
import jxl.write.WritableSheet;
import jxl.write.WritableWorkbook;
import jxl.write.WriteException;
import jxl.write.biff.RowsExceededException;

/**
 * 使用JXL对Excel文件进行操作
 * @author MrChen
 *
 */
public class JXLOperateExcel {
    /**
     * 写入Excel
     * @param fileName  要生成的Excel文件名字
     */
    public static void writeExcel(String fileName) {
        //1.使用Workbook类的工厂方法创建一个可写入的工作薄(Workbook)对象
        WritableWorkbook wwb = null;
        try {
            wwb = Workbook.createWorkbook(new File(fileName));
        } catch (IOException e) {
            e.printStackTrace();
        }
        
        if(wwb == null) {
            return;
        }
        
        //2.创建一个可写入的工作表
        //workbook的createSheet方法有两个参数：第一个是工作表的名称，第二个是工作表在工作薄中的位置
        WritableSheet sheet = wwb.createSheet("sheet1", 0);
        
        //3.添加单元格
        for(int i=0; i<10; i++) {
            for(int j=0; j<5; j++) {
                //Label label = new Label(col, row, title);
                //三个参数分别表示col+1列，row+1行，标题内容是title。
                Label label = new Label(j, i, "这是第"+(i+1)+"行,第"+(j+1)+"列");
                
                //将生成的单元格添加到工作表中
                try {
                    sheet.addCell(label);
                } catch (RowsExceededException e) {
                    e.printStackTrace();
                } catch (WriteException e) {
                    e.printStackTrace();
                }
                
            }
        }
        
        try {
            //4.从内存写入到文件中
            wwb.write();
            //5.关闭资源，释放内存
            wwb.close();
        } catch (WriteException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        
    }
    
    /**
     * 读取Excel文件
     * @param file    要读取的Excel文件
     * @return     Excel每个单元格的内容（按照一定格式）
     */
    public static String readExcel(File file) {
        StringBuffer sb = new StringBuffer();
        Workbook wb = null;
        //1.获取工作薄对象（Workbook）
        try {
            wb = Workbook.getWorkbook(file);
        } catch (BiffException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        if(wb==null) {
            return null;
        }
        
        //2.得到工作表对象（Sheet）
        Sheet[] sheets = wb.getSheets();
        
        //3.循环操作单元格
        if(sheets!=null && sheets.length>0) {
            //对每个工作表进行循环
            for(int i=0; i<sheets.length; i++) {
                //得到当前工作表的行数
                int rowNum = sheets[i].getRows();
                for(int j=0; j<rowNum; j++) {
                    //得到当前行的所有单元格
                    Cell[] cells = sheets[i].getRow(j);
                    if(cells != null && cells.length > 0) {
                        //对每个单元格进行循环
                        for(int k=0; k<cells.length; k++) {
                            //读取当前单元格的值
                            String cellValue = cells[k].getContents();
                            sb.append(cellValue+"	");
                        }
                    }
                    sb.append("
");
                }
                sb.append("
");
            }
        }
        
        //4.关闭资源，释放内存
        wb.close();
        return sb.toString();
    }
    
    /**
     * 搜索Excel文件中是否包含关键字
     * @param file 要搜索的Excel文件
     * @param keyWord    要搜索的关键字
     * @return    是否包含关键字  
     */
    public static Boolean searchKeyWord(File file, String keyWord) {
        //构建一个开关，用来保存搜索成功与否的状态
        Boolean res = false;
        Workbook wb = null;
        //1.获取工作薄对象（Workbook）
        try {
            wb = Workbook.getWorkbook(file);
        } catch (BiffException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        if(wb == null) {
            return res;
        }
        
        //2.得到工作表对象（Sheet）
        Sheet[] sheets = wb.getSheets();
        if(sheets == null || sheets.length == 0) {
            return res;
        }
        
        //3.循环比对单元格
        Boolean breakSheet = false;  //开关
        for(int i=0; i<sheets.length; i++) {
            if( breakSheet ) {
                break;
            }
            
            //得到当前工作表的行数
            Integer rowNum = sheets[i].getRows();
            Boolean breakRow = false;
            for(int j=0; j<rowNum; j++) {
                if(breakRow) {
                    break;
                }
                //得到当前行的所有单元格
                Cell[] cells = sheets[i].getRow(j);
                if(cells==null || sheets.length==0) {
                    return res;
                }
                //对每个单元格进行循环
                Boolean breakCell = false;
                for(int k=0; k<cells.length; k++) {
                    if(breakCell){
                        break;
                    }
                    //读取当前单元格的值
                    String cellValue = cells[k].getContents();
                    if(cellValue == null) {
                        continue;
                    }
                    if(cellValue.contains(keyWord)) {
                        breakCell = true;
                        breakRow = true;
                        breakSheet = true;
                        res = true;
                    }
                }
            }
        }
        //4.关闭资源，释放内存
        wb.close();
        return res;
    }
    
    /**
     * 向Excel中插入图片(仅限png格式的图片，其余格式如jgp、gif等暂不支持)
     * @param sheet      待插入的工作表
     * @param col       图片从该列开始
     * @param row        图片从该行开始
     * @param width        图片所占的宽度
     * @param height    图片所占的高度
     * @param imageFile    要插入的图片文件
     */
    public static void insertImage(WritableSheet sheet,
            int col, int row,
            int width, int height,
            File imageFile) {
        WritableImage img = new WritableImage(col, row, width, height, imageFile);
        sheet.addImage(img);
    }
    
    
    /**
     * @param args
     */
    public static void main(String[] args) {
        //4.测试insertImage方法
        WritableWorkbook wwb = null;
        try{
            wwb = Workbook.createWorkbook(new File("E:\testexcel.xls"));
            WritableSheet sheet = wwb.createSheet("image", 0);
            File imageFile = new File("E:\1.png");
            JXLOperateExcel.insertImage(sheet, 1, 4, 6, 18, imageFile);
            wwb.write();
        } catch(Exception e) {
            e.printStackTrace();
        } finally {
            //如果不关闭WorkWritablebook，打开生成的Excel文件会出现”Excel格式与文件扩展名指定格式不一致“的错误。
            if(wwb != null) {
                try {
                    wwb.close();
                } catch (WriteException e) {
                    e.printStackTrace();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        
        //3.测试searchKeyWord方法
//        File file = new File("E:\testexcel.xls");
//        String keyWord = "1";
//        System.out.println(JXLOperateExcel.searchKeyWord(file, keyWord));
        
        //2.测试readExcel方法
//        File file = new File("E:\testexcel.xls");
//        System.out.println(JXLOperateExcel.readExcel(file));
        
        //1.测试writeExcel方法
//        String fileName = "E:\testexcel.xls";
//        JXLOperateExcel.writeExcel(fileName);
    }

}

4.总结

　　(1) 类比我们平时对Excel的操作：①找到Excel文件；②找到要操作的工作表(sheet)；③找到要操作的行；④操作当前行的单元格。程序中也是这种操作顺序。

　　(2)WorkWritablebook一定要及时关闭。如果不关闭WorkWritablebook，打开生成的Excel文件会出现”Excel格式与文件扩展名指定格式不一致“的错误。