excel导入及验证

    不管你用什么前端框架，excel的导入就和导入文件格式一样，只不过要判断文件后缀格式属于哪一种。这边先集成一个工具类，稍作修改后便可以直接使用，当然，我这里会做相应的检查和优化。

     1.准备

           1.准备好相关的依赖，这里需要poi和poi-ooxml两个jar包，版本是3.17

       <dependency>
			<groupId>org.apache.poi</groupId>
			<artifactId>poi</artifactId>
			<version>${poi.version}</version>
		</dependency>
		<!-- https://mvnrepository.com/artifact/org.apache.poi/poi-ooxml -->
		<dependency>
			<groupId>org.apache.poi</groupId>
			<artifactId>poi-ooxml</artifactId>
			<version>${poi.version}</version>
		</dependency>

           2.准备好你的excel表格和相关的业务逻辑，因为我这里只记录excel导入的部分。

     2.开发工具类------POIUtil

package com.youfuli.apimanager.utils;

import lombok.extern.slf4j.Slf4j;
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;

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

/**
 * Created by lxt on 2018/10/9.
 */
@Slf4j
public class POIUtil {
    private final static String xls = "xls";
    private final static String xlsx = "xlsx";

    /**
     * 读入excel文件，解析后返回
     * @param file
     * @throws IOException
     */
    public static List<String[]> readExcel(MultipartFile file) throws IOException {
        //检查文件
        checkFile(file);
        //获得Workbook工作薄对象
        Workbook workbook = getWorkBook(file);
        //创建返回对象，把每行中的值作为一个数组，所有行作为一个集合返回
        List<String[]> list = new ArrayList<String[]>();
        if(workbook != null){
            for(int sheetNum = 0;sheetNum < workbook.getNumberOfSheets();sheetNum++){
                //获得当前sheet工作表
                Sheet sheet = workbook.getSheetAt(sheetNum);
                if(sheet == null){
                    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.getLastCellNum();
                    String[] cells = new String[lastCellNum];
                    //循环当前行
                    for(int cellNum = firstCellNum; cellNum < lastCellNum;cellNum++){
                        Cell cell = row.getCell(cellNum);
                        cells[cellNum] = getCellValue(cell);
                    }
                    list.add(cells);
                }
            }
            // workbook.close();
        }
        return list;
    }
    public static void checkFile(MultipartFile file) throws IOException{
        //判断文件是否存在
        if(null == file){
            log.error("文件不存在！");
            throw new FileNotFoundException("文件不存在！");
        }
        //获得文件名
        String fileName = file.getOriginalFilename();
        //判断文件是否是excel文件
        if(!fileName.endsWith(xls) && !fileName.endsWith(xlsx)){
            log.error(fileName + "不是excel文件");
            throw new IOException(fileName + "不是excel文件");
        }
    }
    public static Workbook getWorkBook(MultipartFile file) {
        //获得文件名
        String fileName = file.getOriginalFilename();
        //创建Workbook工作薄对象，表示整个excel
        Workbook workbook = null;
        try {
            //获取excel文件的io流
            InputStream is = file.getInputStream();
            //根据文件后缀名不同(xls和xlsx)获得不同的Workbook实现类对象
            if(fileName.endsWith(xls)){
                //2003
                workbook = new HSSFWorkbook(is);
            }else if(fileName.endsWith(xlsx)){
                //2007 及2007以上
                workbook = new XSSFWorkbook(is);
            }
        } catch (IOException e) {
            log.info(e.getMessage());
        }
        return workbook;
    }
    public 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;
    }
}

  对于文中代码的小细节大家可以细细研究，这边定义好工具类，那么就需要去调用了

  首先是前台页面,给一个按钮点击事件

<div class="layui-inline">
            <input type="button" id="uploadExcel" class="layui-btn"value="上传Excel"></input>
        </div>

    然后通过ajax方法调用即可----这边采用layui的内置方法

layui.use(['element','upload'], function() {
        element = layui.element;
        upload = layui.upload;
        var gasC = $("#ids").val();
        //指定允许上传的文件类型
        upload.render({
            elem: '#uploadExcel'
            ,url: contextPath+'/batch/uploadBatch?gasCode='+gasC
            ,accept: 'file' //普通文件
            ,multiple: true
            ,done: function(res){
                if(res.rcode=='0000'){
                    $("#cardText").show();
                    var resData = res.data;
                    //salert(JSON.stringify(res.data[0][0]));
                    var tableStr = "<table border='1' align='center' width='98%' id='shows'>";
                    tableStr = tableStr + "<tr align='center'><th align='center'>卡号</th><th>面额</th><th>区域</th></tr>";
                    var len = resData.length;
                    $("#cardNum").val(len);
                   var prices;
                    for(var i=0 ;i<len ; i++){
                        tableStr = tableStr + "<tr align='center'><td id='cardNo'>"+ resData[i][0] +"</td>"+"<td id='face'>"+resData[i][1] + "</td>"+"<td id='region'>"+resData[i][2] +"</td></tr>";
                        if(prices==null){
                            prices =parseInt(resData[i][1]);
                        }else{
                            prices = parseInt(prices)+parseInt(resData[i][1]);
                        }

                    }
                    $("#faceAmount").val(prices);
                    //alert(prices);
                    tableStr = tableStr + "</table>";
                    $("#showExcel").html(tableStr);
                }else{
                    layer.msg(res.desc,{shift: -1, time: 1000});
                }
            }
        });
    });

看似很长，其实只需要关注url下面contextPath这个路径。也就是后台逻辑。

public BaseResponse uploadImg(@RequestParam MultipartFile file, String gasCode) throws Exception {
        List<String[]> list = POIUtil.readExcel(file); //这里得到的是一个集合，里面的每一个元素是String[]数组
        Set<String> set = new HashSet<String>();
        List<String> arrayList = new ArrayList<String>();

        if (list.size() > 0) {
            log.info("导入excel长度:"+list.size());
            for (int i=0; i<list.size() ; i++) {
                String[] strings = list.get(i);
                if(strings.length != 3) {
                    return BaseResponse.fail("9999", "excel格式不正确");
                }
                if(StringUtils.isEmpty(strings[0])) {
                    return BaseResponse.fail("9999", "第"+(i+2)+"行卡号不能为空");
                }
                if(StringUtils.isEmpty(strings[1])) {
                    return BaseResponse.fail("9999", "第"+(i+2)+"行面值不能为空");
                }
                if(StringUtils.isEmpty(strings[2])) {
                    return BaseResponse.fail("9999", "第"+(i+2)+"行地区不能为空");
                }
                if(!UserConstants.A_.equals(strings[2]) && !UserConstants.B_.equals(strings[2])) {
                    return BaseResponse.fail("9999", "第"+(i+2)+"行地区错误，地区只能是A区和B区");
                }

                try {
                    new BigDecimal(strings[1]);
                }catch (Exception  e){
                    return BaseResponse.fail("9999", "第"+(i+2)+"面值格式错误");
                }

                String cardNo = strings[0];
                arrayList.add(cardNo);
            }
            for (String string : arrayList) {
                boolean b = set.add(string);
                if (!b) {
                    return BaseResponse.fail("9999", "excel中存在重复卡号");
                }
            }
            return BaseResponse.success(list);
        } else {
            return BaseResponse.fail("9999","表格内容为空");
        }
        // return gasBatchService.saveBatch(list);
    }

通过接收POIUtil里面方法的返回值来做相应的处理，包括验证参数，因为我只是单纯的验证一下，所以对返回code码写的很随意。

如果有这样一个需求，导入数据前需要回显页面进行展示,最后确认导入，大家可以看一下，poi工具类的接收格式是List<String[]>，前台回显后，想要确认导入需要获取整个表格，这边我定义了一个数组去接收，然后后台去解析，上方代码直接在导入后将数据回显了，这边采用的是拼接表格然后循环的形式，下面是获取整个表格的代码。

function add() {
        //获取下拉框的最新值
        var gasC = $("#ids").val();
        var arr2 = new Array();
        var tr = document.getElementsByTagName('tr');                    //获取HTML中表格的tr
        var td = document.getElementsByTagName('td');

        for (var i = 0; i < tr.length-1; i++) {                          //因为忽略了表头th，所以少了一组tr，故i<tr.length-1
            arr2[i] = new Array();
            for (var j = 0; j < td.length/(tr.length-1); j++) {          //每一组tr中有的td个数：td.length/(tr.length-1)
                arr2[i][j] = "";                                         //初始化二位数组为空字符串
            }
        }
        for (var x = 0; x < tr.length-1; x++) {
            for (var y = 0; y < td.length/(tr.length-1); y++) {
                arr2[x][y] = td[x*(td.length/(tr.length-1))+y].innerText; 　　　　//td[?].innerText获取第？个td中的值，？= x*(td.length/(tr.length-1))+y
            }
        }
        //alert(arr2[0]);
        if(gasC== null ||gasC=='') {
            layer.alert('请选择供应商');
            return ;
        }
        layer.load();
        $.ajax({
            type : 'post',
            url :contextPath+ '/batch/saveExcel/'+gasC,
            contentType: "application/json; charset=utf-8",
            data:JSON.stringify({arr2:arr2}),
            success : function(data) {
                layer.closeAll('loading');
                if(data.rcode=='0000'){
                    layer.msg("添加成功", {shift: -1, time: 1000}, function(){
                        var index = parent.layer.getFrameIndex(window.name);
                        parent.layer.close(index);
                        location.reload();
                    });
                }else {
                    layer.msg(data.desc,{shift: -1, time: 1000});
                }
            },end: function () {
                location.reload();
            }
        });
    }

这边定义的是一个数组，那么后台就需要定义一个相应的二维数组进行接收，我们走到后台---》

@RequestMapping("/saveExcel/{gasCode}")
    public BaseResponse saveExcel(@RequestBody GasExcelDto excelDto, @PathVariable("gasCode") String gasCode) {
        List<String[]> list = new ArrayList<>();
        String[] excelStr = new String[3];

        String[][] excel = excelDto.getArr2();
        String excel2 = excel[0][0];
        for (int i = 0; i < excel.length; i++) {
            String a = null;
            for (int j = 0; j < excel[i].length; j++) {
                if (a == null) {
                    a = excel[i][j] + ",";
                } else {
                    a = a + excel[i][j] + ",";
                }

            }
            excelStr = a.split(",");
            list.add(excelStr);
        }
        return gasBatchService.saveBatch(list, gasCode);
    }

GasExcelDto中定义一个参数

private String[][] arr2;

最终遍历集合数组插入数据

 

@Override
    public BaseResponse saveBatch(List<String[]> list, String gasCode) {
        log.info("传入供应商编号{}", gasCode);
        User user = UserUtil.getCurrentUser();
        String batchId = gasBatchMapper.queryMaxBatchId();
        String orderNo = null;
        if (StringUtils.isEmpty(batchId)) {
            orderNo = OrderNoUtil.yyyymmddhhmmss() + "001";
        } else {
            int num = Integer.parseInt(batchId.substring(batchId.length() - 3)) + 1;
            Integer num2 = num;
            String strNum = null;
            if (num2.toString().length() == 1) {
                strNum = "00" + num2;
            } else if (num2.toString().length() == 2) {
                strNum = "0" + num2;
            } else {
                strNum = num2.toString();
            }
            orderNo = OrderNoUtil.yyyymmddhhmmss() + strNum;
        }
        log.info("生成批次号{}", orderNo);
        //判断是否和数据库中加油卡卡号重复
        for (String[] strings : list) {
            String cardNo = strings[0];
            List<ApiGasOillCard> card = gasDetailMapper.queryCountDetail(cardNo);
            if (card.size() > 0) {
                return BaseResponse.fail("9908", "数据库中存在重复卡号");
            }
        }

        //1.生成批次号并插入加油卡明细表
        for (String[] strings : list) {
            ApiGasOillCard gasDetail = new ApiGasOillCard();
            gasDetail.setBatchId(orderNo);
            //卡号
            gasDetail.setCardNo(strings[0]);
            //面值
            gasDetail.setCardFace(new BigDecimal(strings[1]));
            //地区
            gasDetail.setRegion(strings[2]);
            //卡状态    1--导入
            gasDetail.setCardState(UserConstants.CARD_STATE_IMPORT);
            //出库状态 未出库
            gasDetail.setDeliveryState("0");
            //卡状态 默认 0 中石化
            gasDetail.setCardType("0");
            int count = gasDetailMapper.insertSelective(gasDetail);
            log.info("成功插入卡号为{}的数据{}条", strings[0], count);
        }
        //2.插入加油卡批次表
        //根据批次号获取相应的信息
        GasDetailDto gasDetailDto = gasDetailMapper.queryGasDetailTotal(orderNo);
        ApiGasBatch gasBatch = new ApiGasBatch();
        gasBatch.setBatchId(orderNo);
        //总笔数
        gasBatch.setGasCardTotal(gasDetailDto.getTotalSize());
        //总金额
        gasBatch.setGasCardTotalAmount(new BigDecimal(gasDetailDto.getTotal()));
        //供应商
        gasBatch.setGasCode(gasCode);
        //财务登录id--由于没有财务表所以暂时空缺
        //直接在数据库中将该批次状态设置为导入完成--‘1’
        int count = gasBatchMapper.insertExcelBatch(gasBatch);
        log.info("插入批次号为{}的数据共{}条", orderNo, count);
        return BaseResponse.success();
    }

其实最主要的是学习这些技术是怎么综合运用的，主要是下面几点：

1.前台知道如何运用ajax上传文件到后台

2.后台通过代码验证上传文件合法性，判断是否重复和非空验证，合法参数验证，如果要插入数据库，还需要验证数据库中是否有重复数据。

3.前台页面回显数据，用拼接的形式循环去添加

4.获取表格中除开表头的数据，并能够传递后台正常接收

5.后台接收数据进行格式转换，此处为二维数组转一维数组，然后遍历数据插入数据库

6.前台能正确接收返回值做出相应的处理