微服务 Spring Boot Mybatis-Plus 整合 EasyPOI 实现 Excel 一对多导入

梦里梦外; 2024-05-01 04:37 35阅读 0赞

#### 文章目录 ####

*  ⛄引言
 *  一、EasyPOI 实现Excel 的一对多导入 -- 代码实现
 *   *  ⛅需求说明
     *  ⚡核心源码实现
 *  二、Easy POI 实现一对多导入 -- 测试
 *  三、效果图展示
 *  ⛵小结

## ⛄引言 ##

**Excel导入 是 开发中 很常用的 功能** ，本篇**讲解 如何使用 Spring Boot + MyBatis -Plus 整合 EasyPOI 实现Excel 的一对多导入。**

[EasyPOI官网][EasyPOI]

## 一、EasyPOI 实现Excel 的一对多导入 – 代码实现 ##

### ⛅需求说明 ###

**采用 微服务 Spring Boot、Mybatis-Plus 整合 EasyPOI 实现Excel的一对多导入**

**Excel 导入 实现详细细节**

*  前端采用 **Vue+ElementUI** 实现导入页面展示，要求**弹出上传框**、 **展示导入模板**、 并且**要求文件手动上传**
 *  后端导入 要求实现EasyPOI实现、采用工具类完成导入的集合映射
 *  要求使用 Mybatis-Plus 实现 批量导入

### ⚡核心源码实现 ###

**Excel 一对多导入如下所示**

![在这里插入图片描述][16f4d9454511409b92aa0f1fcff307e4.png_pic_center]

**以上的商品信息该如何进行映射呢？**

EasyPOI为我们提供了专门的映射集合的注解，`@ExcelCollection`

*  **表示一个集合,主要针对一对多的导出,比如一个老师对应多个科目,科目就可以用集合表示**

![在这里插入图片描述][9954d1b1653a4317b13a0653e1962cc4.png_pic_center]

**采用 注解进行映射即可**

> **后端源码**

**SysUserExcel**

package com.chen.excel;
    
    import cn.afterturn.easypoi.excel.annotation.Excel;
    import cn.afterturn.easypoi.excel.annotation.ExcelCollection;
    import com.chen.entity.GoodsEntity;
    import lombok.Data;
    
    import java.util.Date;
    import java.util.List;
    
    
    @Data
    public class SysUserExcel {
        
    
        @Excel(name = "序号", orderNum = "0", format = "isAddIndex")
        private Integer index = 1;
    
        @Excel(name = "用户账号 *")
        private String username;
    
        @Excel(name = "真实姓名 *")
        private String realName;
    
        @Excel(name = "用户性别 *", replace = {
        "男_1", "女_2"})
        private Integer gender;
    
        @Excel(name = "电子邮箱", width = 25)
        private String email;
    
        @Excel(name = "手机号码 *")
        private String mobile;
    
        // 注解映射商品信息集合
        @ExcelCollection(name = "商品信息")
        private List<GoodsExcel> goodsList;
    }

**GoodsExcel**

**SysUserService**

public interface SysUserService extends IService<SysUserEntity> {
        
    
        ResultBean<PageInfo<SysUserDTO>> page(SysUserDTO param);
    
        ResultBean<Integer> insert(SysUserDTO param);
    
        ResultBean<Integer> importExcel(MultipartFile file);
    }

**SysUserServiceImpl**

@Override
    public ResultBean<Integer> importExcel(MultipartFile file) {
        
        ImportParams importParams = new ImportParams();
        //标题行设置为1行，默认是0，可以不设置；依实际情况设置。
        importParams.setTitleRows(0);
        // 表头设置为1行
        importParams.setHeadRows(2);
        try {
        
            //读取excel
            List<SysUserExcel> sysUserExcelList = ExcelImportUtil.importExcel(file.getInputStream(), SysUserExcel.class, importParams);
    
            batchInsert(sysUserExcelList);
            return ResultBean.create(0, "success");
        } catch (Exception e) {
        
            log.error("导入 Excel 异常！ e ==> {}", e);
            return ResultBean.create(10, "导入excel 异常！"+e.getMessage());
        }
    }
    
    public void batchInsert(List<SysUserExcel> param) throws Exception{
        
        //1.转换为dto集合
        List<SysUserEntity> sysUserEntityList = BeanUtil.copyToList(param, SysUserEntity.class);
        //2.转换为商品实体集合
        List<GoodsEntity> goodsEntityList = BeanUtil.copyToList(param.get(0).getGoodsList(), GoodsEntity.class);
        //3.转换集合
        sysUserEntityList.stream().filter(obj -> obj.getUsername() != null)
            .forEach(obj -> obj.setPassword("123"));
        //4.批量保存
        saveBatch(sysUserEntityList);
        // 保存用户id至商品id
        sysUserEntityList.stream().forEach(obj -> {
        
            goodsEntityList.stream().forEach(goods -> {
        
                goods.setUserId(obj.getId());
            });
        });
        goodsService.saveBatch(goodsEntityList);
    }

> **商品业务类**

**GoodsEntity**

@Data
    @TableName("tb_goods")
    public class GoodsEntity {
        
    
        private Long id;
    
        private Long userId;
    
        private String goodsName;
    
        private Double goodsPrice;
    
        private String address;
    
        private Date createTime;
    
        private Date updateTime;
    }

**GoodsService**

import com.baomidou.mybatisplus.extension.service.IService;
    import com.chen.entity.GoodsEntity;
    
    /**
     * @author whc
     */
    public interface GoodsService extends IService<GoodsEntity> {
        
    
    }

**GoodsServiceImpl**

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
    import com.chen.entity.GoodsEntity;
    import com.chen.mapper.GoodsMapper;
    import com.chen.service.GoodsService;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.stereotype.Service;
    
    /**
     * @author whc
     */
    @Slf4j
    @Service
    public class GoodsServiceImpl extends ServiceImpl<GoodsMapper, GoodsEntity> implements GoodsService {
        
    
    }

> **前端源码**

**SysUserList Vue 部分**

<el-dialog :visible.sync="userVisibleOnly" width="780px" title="新增/编辑">
        <el-form :model="sysUser" :rules="rules" ref="sysUserForm"  label-width="120px">
            <el-row>
                <el-form-item style="font-weight: bold" label="模板下载">
                    <el-button type="text">导入用户模板</el-button>
                </el-form-item>
            </el-row>
            <el-row>
                <el-form-item style="font-weight: bold" label="相关附件">
                    <el-upload
                               class="upload-demo"
                               :action="importUrl"
                               :on-success="uploadSuccess"
                               accept=".xlsx"
                               ref="upload"
                               multiple
                               :limit="3"
                               :auto-upload="false"
                               :on-exceed="handleExceed">
                        <el-button type="primary" icon="el-icon-upload2" size="small">导入</el-button>
                    </el-upload>
                    
                </el-form-item>
            </el-row>
        </el-form>
        <span slot="footer" class="dialog-footer">
            <el-button type="primary" size="mini" @click="clkBtnUpload">确定</el-button>
            <el-button type="warning" size="mini" @click="userVisibleOnly = false">取消</el-button>
        </span>
    </el-dialog>

**SysUserList JS 部分**

data(){
        
    	return:{
        
    		userVisibleOnly: false
    	}
    }
    metheds:{
        
    	uploadSuccess(val) {
        
          if (val.code == 0) {
        
            this.$message.success("导入成功~");
            this.getSysUserList();
          }
        },
        handleExceed(val) {
        
    
        },
        clkBtnUpload() {
        
          this.submitUpload();
          this.$message({
        
            showClose: true,
            message: '上传成功，正在导入...'
          });
          this.userVisibleOnly = false;
        },
        submitUpload() {
        
          this.$refs.upload.submit();
        },
    }

**代码编写完毕，进行测试**

## 二、Easy POI 实现一对多导入 – 测试 ##

**启动后端、前端 访问 ：** 127.0.0.1:80

![在这里插入图片描述][467a9c478ac9437cba44f4dcbf96033d.png_pic_center]

**导入测试**

![在这里插入图片描述][25fcd6de926243d4a7928af1b044016e.png_pic_center]

**导入采用手动导入，点击确定后，将表单提交至后端**

**断点进入**

![在这里插入图片描述][5019e4cab6374f2f8528c0d891a80097.png_pic_center]

**我们看到已经完成了对象映射，直接进行映射对象，插入数据库即可**

扩展知识：**IDEA 断点快捷键 f8 按行进行断点调试、f9 进入下一次断点位置，若没有，直接结束**

## 三、效果图展示 ##

![在这里插入图片描述][58661c3297a1497386531d884e9d4218.gif_pic_center]

## ⛵小结 ##

以上就是【**Bug 终结者**】对 **微服务 Spring Boot Mybatis-Plus 整合 EasyPOI 实现 Excel 一对多 导入** 的简单介绍，**Excel一对多导入其实如此简单，Excel导入也是很常见的功能，希望带来这个案例，大家可以遇到需求时，进行举一反三，感谢支持！**

> 如果这篇【文章】有帮助到你，希望可以给【**Bug 终结者**】点个赞?，创作不易，如果有对【**后端技术**】、【**前端领域**】感兴趣的小可爱，也欢迎关注❤️❤️❤️ 【**Bug 终结者**】❤️❤️❤️，我将会给你带来巨大的【收获与惊喜】???！

[EasyPOI]: http://doc.wupaas.com/docs/easypoi/easypoi-1c0u6ksp2r091
[16f4d9454511409b92aa0f1fcff307e4.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/867f192b614f4e49ae11ec54abe21027.png
[9954d1b1653a4317b13a0653e1962cc4.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/4f63ed6827b84f718a5e2efc833e3774.png
[467a9c478ac9437cba44f4dcbf96033d.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/4a1afe6173634173b60704c54a8abaa4.png
[25fcd6de926243d4a7928af1b044016e.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/56f8b453e9f241459708878b9533513b.png
[5019e4cab6374f2f8528c0d891a80097.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/61a020d672304bdbafe3dea66fcd94a5.png
[58661c3297a1497386531d884e9d4218.gif_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/01/f0ef0b7496bf4ab6a7590764ca8c5cc5.gif