POI异步导入Excel兼容xsl和xlsx

项目架构：spring+struts2+hibernate4+oracle

需求：用户导入excel文件，导入到相应的数据表中，要求提供导入模板，支持xls和xlsx文件

思路分析：

1、提供一个下载链接，点击下载，可以使超链接，src直接是项目路径加文件名。

2、通过上传文件，服务器接收上传，返回一个上传后的服务器本地路径，通过ajax异步赋值到jsp的路径隐藏域。

3、ajax异步提交导入请求，后台处理，将路径转换成File，File转换成MultipartFile，将文件读取转换成一个数组类型的集合。

4、循环集合这种的数据，每一行excel数据，是一个元素，将元素转换成相应的java对象进行保存。

一、所需jar包

一共是6个jar包。

二、前端jsp代码部分

<input type="hidden" id="excelFilePath" name="excelFilePath" value="" />
                <tr>
                    <td>选择文件：</td>
                    <td><input type="file" name="uploadFile" id="excelFile"></input></input>
                    <span id="uploadMsg"></span></td>
                </tr>
                <tr>
                    <td></td>
                    <td> <input type="button" value="上传" onclick="fileUpload()">
                    &nbsp;
                    <input type="button" value="导入" id="btnOk" disabled="true" onclick="importEmp()"/>
                    </td>
                </tr>

<script type="text/javascript">
    // 文件上传
    function fileUpload(){
        $("#fileTypeError").html("");
        $("#btnOk").attr("disabled",true);
        var fileName = $("#excelFile").val();
        var fileType = fileName.substr(fileName.length-4,fileName.length);
        if(fileType == ".xls" || fileType == "xlsx"){
            
            var uploadFileUrl = "${basePath}/public/uploadFile.action";
            var formData = new FormData($("#mainForm")[0]);
            $.ajax({
                type: "POST",  
                url: uploadFileUrl, 
                data: formData,
                cache: false,
                processData: false,  
                contentType: false, 
                dataType : "json",
                success: function(data){
                    if(null != data){
                        if (data.dataStatus == "1") {
                            $("#uploadMsg").html("<font color='green'>上传成功!</font>");
                            $("#btnOk").attr("disabled",false);
                            $("#excelFilePath").attr("value",data.dataMain);
                            //alert($("#excelFilePath").val());
                        } else {
                            if (data.errorMsg != null
                                    && data.errorMsg.length > 0) {
                                alert(data.errorMsg);
                                $("#uploadMsg").html("<font color='red'>" +data.errorMsg + "请仔细阅读操作说明！</font>");
                            }
                        }
                    }
                },
                error : function(XMLHttpRequest, textStatus,
                        errorThrown) {
                    alert("系统异常[" + textStatus + "]:" + errorThrown);
                }
            });
        }else{
            $("#uploadMsg").html("<font color='red'>上传文件类型错误,支持类型: .xls .xlsx</font>");
            
        }
    }
    //Excel文件导入到数据库中       
    function importEmp(){  
        var importExcelURL = "${basePath}/public/importResultExaminee.action";
        var excelFilePath = $("#excelFilePath").val();
        $.ajax({
            type: "POST",  
            url: importExcelURL, 
            data: {"excelFilePath":excelFilePath},
            cache: false,
            dataType : "json",
            success: function(data){
                if(null != data){
                    if (data.dataStatus == "1") {
                        $("#btnOk").attr("disabled",false);
                        alert("本次成功导入数量：" + data.dataMain);
                    }else{
                        if (data.errorMsg != null
                                && data.errorMsg.length > 0) {
                            alert(data.errorMsg);
                        }
                    }
                }
            },
            error : function(XMLHttpRequest, textStatus,
                    errorThrown) {
                alert("系统异常[" + textStatus + "]:" + errorThrown);
            }
            
        })
    } 
</script>

三、核心处理类POIUtils代码：

package com.sinotn.utils;

import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

import org.apache.log4j.Logger;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.springframework.web.multipart.MultipartFile;

/**
 * excel导出导入工具类
 * Copyright (c) 2018 by Sinotn
 * @author Libin
 * @date 2018年4月8日 上午9:39:50
 */
public class POIUtils {

    private static Logger logger = Logger.getLogger(POIUtils.class);
    private final static String XLS = "xls";
    private final static String XLSX = "xlsx";
    /**
     * 读取excel文件
     * @param formFile
     * @return
     * @throws IOException
     */
    public static List<String[]> readExcel(MultipartFile  formFile) throws IOException {
        // 检查文件
        checkFile(formFile);
        //获得Workbook工作薄对象
        Workbook workbook = getWorkBook(formFile);
        //创建返回对象，把每行中的值作为一个数组，所有行作为一个集合返回  
        List<String[]> list = new ArrayList<String[]>();
        if (null != workbook) {
            for (int sheetNum  = 0; sheetNum < workbook.getNumberOfSheets();sheetNum++) {
                //获得当前sheet工作表  
                Sheet sheet = workbook.getSheetAt(sheetNum);
                if (null == sheet) {
                    continue;
                }
                //获得当前sheet的开始行  
                int firstRowNum  = sheet.getFirstRowNum();  
                //获得当前sheet的结束行  
                int lastRowNum = sheet.getLastRowNum();  
                //循环除了第一行的所有行 
                for (int rowNum = firstRowNum + 1;rowNum <= lastRowNum;rowNum++) {
                     //获得当前行  
                    Row row = sheet.getRow(rowNum);  
                    if(row == null){  
                        continue;  
                    }  
                    //获得当前行的开始列  
                    int firstCellNum = row.getFirstCellNum();  
                    //获得当前行的列数  
                    int lastCellNum = row.getPhysicalNumberOfCells();  
                    String[] cells = new String[row.getPhysicalNumberOfCells()];  
                    //循环当前行  
                    for (int cellNum = firstCellNum; cellNum < lastCellNum;cellNum++) {
                        Cell cell = row.getCell(cellNum);  
                        cells[cellNum] = getCellValue(cell);
                    }
                    list.add(cells);
                }
            }
             workbook.close();  
        }
        return list;

    }
    
    /**
     * 获取当前行数据
     * @param cell
     * @return
     */
    @SuppressWarnings("deprecation")
    private static String getCellValue(Cell cell) {
        String cellValue = "";  
        if(cell == null){  
            return cellValue;  
        }  
        //把数字当成String来读，避免出现1读成1.0的情况  
        if(cell.getCellType() == Cell.CELL_TYPE_NUMERIC){  
            cell.setCellType(Cell.CELL_TYPE_STRING);  
        }  
      //判断数据的类型  
        switch (cell.getCellType()){  
            case Cell.CELL_TYPE_NUMERIC: //数字  
                cellValue = String.valueOf(cell.getNumericCellValue());  
                break;  
            case Cell.CELL_TYPE_STRING: //字符串  
                cellValue = String.valueOf(cell.getStringCellValue());  
                break;  
            case Cell.CELL_TYPE_BOOLEAN: //Boolean  
                cellValue = String.valueOf(cell.getBooleanCellValue());  
                break;  
            case Cell.CELL_TYPE_FORMULA: //公式  
                cellValue = String.valueOf(cell.getCellFormula());  
                break;  
            case Cell.CELL_TYPE_BLANK: //空值   
                cellValue = "";  
                break;  
            case Cell.CELL_TYPE_ERROR: //故障  
                cellValue = "非法字符";  
                break;  
            default:  
                cellValue = "未知类型";  
                break;  
        }  
        return cellValue;  
    }
    
    /**
     * 获得Workbook工作薄对象
     * @param formFile
     * @return
     */
    private static Workbook getWorkBook(MultipartFile  formFile) {
         //获得文件名  
        String fileName = formFile.getName();
        //创建Workbook工作薄对象，表示整个excel  
        Workbook workbook = null;  
        try {  
            //获取excel文件的io流  
            InputStream is = formFile.getInputStream();
            //根据文件后缀名不同(xls和xlsx)获得不同的Workbook实现类对象  
            if(fileName.endsWith(XLS)){  
                //2003  
                workbook = new HSSFWorkbook(is);  
            }else if(fileName.endsWith(XLSX)){  
                //2007  
                workbook = new XSSFWorkbook(is);  
            }  
        } catch (IOException e) {  
            logger.info(e.getMessage());  
        }  
        return workbook;  
    }
    /**
     * 检查文件
     * @param formFile
     * @throws IOException
     */
    private static void checkFile(MultipartFile  formFile) throws IOException {
        //判断文件是否存在  
        if(null == formFile){  
            logger.error("文件不存在！");  
            throw new FileNotFoundException("文件不存在！");  
        }  
        //获得文件名  
        String fileName = formFile.getName();
        //判断文件是否是excel文件  
        if(!fileName.endsWith(XLS) && !fileName.endsWith(XLSX)){  
            logger.error(fileName + "不是excel文件");  
            throw new IOException(fileName + "不是excel文件");  
        }  
        
    }

}

四、action层代码

POIUtil.readExcel方法读取excel文件后，把一行中的值按先后顺序组成一个数组，所有的行作为一个集合返回。我们可以在代码中循环这个集合，把数组赋值到实体类对象中。

我在前台用form表单提交file文件，因为用的SpringMVC框架，后台用MultipartFile接收，代码如下：

/**
 * 读取excel文件中的用户信息，保存在数据库中
 * @param excelFile
 */
@RequestMapping("/readExcel")
public void readExcel(@RequestParam(value = "excelFile") MultipartFile excelFile,HttpServletRequest req,HttpServletResponse resp){
    Map<String, Object> param = new HashMap<String, Object>();
    List<User> allUsers = new ArrayList<User>();
    try {
        List<String[]> userList = POIUtil.readExcel(excelFile);
        for(int i = 0;i<userList.size();i++){
          String[] users = userList.get(i);
          User user = new User();
          user.setUserName(users[0]);
          user.setPassword(users[1]);
          user.setAge(Integer.parseInt(users[2]));
          allUsers.add(user);
         }
       } catch (IOException e) {
        logger.info("读取excel文件失败", e);
       }
     param.put("allUsers", allUsers);
     this.userService.insertUsers(param);
}

调用的service层方法就不贴代码了，下面就是往数据库插入数据了。

excel文件内容：