在线问题反馈模块实战 (十八): 实现 excel 台账文件记录批量导入功能

👨‍🎓作者：bug 菌

✏️博客：​​CSDN​​​、​​掘金​​等

💌公众号：​​猿圈奇妙屋​​

🚫特别声明：原创不易，转载请附上原文出处链接和本文声明，谢谢配合。

🙏版权声明：文章里可能部分文字或者图片来源于互联网或者百度百科，如有侵权请联系 bug 菌处理。

一、概述🔥

        时间犹如白驹过隙，一转眼已是六月中旬，高考也告一段落，曾忆起自己当年这个时候已是放飞自我，整天到处约同学戏耍，然而，时过境迁，我以一名社会人的身份坐在办公室，怀揣着当时的心情一起为你们祈祷，能在这场无硝烟的战场上一举成名，金榜题名，寒窗苦读十二载，不就为了这一次，希望高考结果如你所愿，而我却只能站在你们的前面，以回忆做酒，来祭奠我那逝去的青春。作罢作罢！咱们说正事儿。

       接下来的这几期，bug 菌想跟大家分享一下自己昨天刚接到一个临时的需求，热乎着呢，想分享一下自己是如何面对临时需求并制定整个开发周期，其中包括从梳理业务到创建业务表再到实现业务逻辑形成闭环再到与前端对接，其中会穿插一些业务拓展及功能性拓展，这一条龙流程在线与大家一起见证，分享给刚入门的小伙伴，希望对你们有所帮助。

环境说明：idea2019.3 + springboot2.3.1.REALSE + mybati-plus3.2.0 + mysql5.6 + jdk1.8

       若小伙伴们在批阅文章的过程中觉得文章对您有一丝丝帮助，还请别吝啬您手里的赞呀，大胆的把文章点亮👍吧，您的点赞三连(收藏⭐️+关注👨‍🎓+留言📃)就是对 bug 菌我创作道路上最好的鼓励与支持😘。时光不弃🏃🏻‍♀️，创作不停💕，加油☘️ 

二、正文🔥

        由于上一期我给大家演示了如何从服务器下载 excel 模板文件，你们就可能猜到了，会有此期业务场景的诞生，由于考虑前期问题及需求迭代比较多，借此就提出了需要满足用户能够通过 excel 文件导入问题数据，那么，既然要满足该需求，第一点就是需要按我们所给的台账模块来填写，唯有这样，我们才能通过代码方式来读取 excel 文件数据，从而将记录保存入库即可。

        该场景在现实中也是很常见的一种，所以对于大家而言，也是司空见惯，借此，这期就跟大家一起聊聊如何实现的事儿吧。

三、如何代码实现 excel 导入功能🔥

0️⃣依赖引入

        对于 excel 的导入导出功能，我们这里用到的是 easypoi 的开源组件，也推荐大家使用。简单介绍一下，easyPoi 是一种专门用于做 poi 的工具集，使用起来简单且易上手，而且它提供了很多简单的注解和模板语言(熟悉的表达式语法)来完成以前 poi 复杂的写法。

        so，只需要在你们的 pom 依赖配置文件中加上如下依赖配置，你们就能使用它啦。

<!--easypoi依赖，excel导入导出-->        <dependency>            <groupId>cn.afterturn</groupId>            <artifactId>easypoi-spring-boot-starter</artifactId>            <version>4.3.0</version>        </dependency>

1️⃣定义 Controller 请求

        由于 excel 文件导入，即我们只需要开个口子将用户上传的 excel 接收即可。所以我们对于文件类的处理统一都是用 MultipartFile 类来接收即可。

/**     * excel批量导入问题反馈     */    @GetMapping("/import")    @ApiOperation(value = "excel批量导入问题反馈", notes = "excel批量导入问题反馈")    public ResultResponse<Boolean> importUsers(@ApiParam("excel文件") {        return new ResultResponse<>(userQuestionsService.importQuestions(file));    }

2️⃣定义接口方法 importQuestions()

        对于该接口，我们也是只需要返回一个 boolean 值即可。因为最后执行结果就是记录的批量写入，返回结果就是一个布尔值。

/**     * excel批量导入问题反馈     */    Boolean importQuestions(MultipartFile file);

3️⃣实现方法 importQuestions()

        想要实现该方法，我们还要定义一个导入 pojo，它是对应于你 excel 文件中的列名，底层如何实现的你们可以去看看，一一对应是有先后顺序的，这里我给大家做个示例，具体如何定义请看如下样例，这也是我整期内容所用到的导入类。

ImportQuestions.java

@Datapublic class ImportQuestions implements Serializable {    private static final long serialVersionUID = 1L;
    /**     * @Excel 作用在一个filed上面，对列的描述     * @param name 列名     * @param    @Excel(name = "姓名", orderNum = "0",width = 10.0)    private String creatorName;
    @Excel(name = "域账号", orderNum = "1",width = 10.0)    private String creatorAccountId;
    @Excel(name = "部门名称", orderNum = "2",width = 5.0)    private String creatorDeptName;
    @Excel(name = "反馈问题类型", orderNum = "3",width = 30.0)    private String questionType;
    @Excel(name = "反馈问题详情", orderNum = "4",width = 20.0)    private String questionContent;
    @Excel(name = "问题所在页面", orderNum = "4",width = 20.0)    private

不会定义的你们跟着我给出的 excel 模板文件来写，就能知道它是如何进行确定字段类型，及 @Excel 注解中的属性了。

        定义好了导入 pojo，接下来就是要实现如何从 excel 文件中读取数据且 insert 入库了。这里分为两步，第一步获取 excel 文件数据，第二步就是将获取到的数据进行保存入库。

接下来我先给大家演示第一步的实现代码。

/**     * excel批量导入问题反馈     */    @Override    public Boolean importQuestions(MultipartFile file) {
        ImportParams importParams = new ImportParams();        //标题行设置为1行，默认是0，可以不设置；依实际情况设置。        importParams.setTitleRows(1);        // 表头设置为1行        importParams.setHeadRows(1);        // 第几个sheet页        importParams.setStartSheetIndex(0);        try {            List<ImportQuestions> questions = ExcelImportUtil.importExcel(file.getInputStream(), ImportQuestions.class, importParams);            //批量插入            boolean isSuccess = this.saveQuestions(questions);            return isSuccess;        } catch (Exception e) {            e.printStackTrace();        }        return false;    }

如上写法，你们就按照我写的逻辑直接用就可以了。对于其中的 savaQuestions()方法，也就是我所提到的第二步，实现逻辑有二，第一将 pojo 导入类转成 Entity 实体，第二将执行 saveBatch()批量插入方法，最终目的是将 excel 中的所有记录成功保存入库。

/**     * 批量保存问题反馈记录     *     * @param    boolean saveQuestions(List<ImportQuestions> questions) {        //存放UserQuestionsEntity        List<UserQuestionsEntity> questionsEntityList = new ArrayList<>();
        //转成UserQuestionsEntity实体        for (ImportQuestions question : questions) {            //验空            if (question != null) {                UserQuestionsEntity questionsEntity = new UserQuestionsEntity(question);
                questionsEntityList.add(questionsEntity);            }        }        //批量插入        return this.saveBatch(questionsEntityList);    }

如上代码就已经实现了从上传 excel 到读取 excel 记录再到批量插入记录入库几步，接下来就是要测试这个接口是否能完美运行通过了。 

4️⃣接口测试

        我们先来通过下载好的台账模板，给随便造点数据进去，接着我们就来测试我们上面写好的 excel 导入接口，看看是否满足业务要求？

如上我是造了三条数据，我们还是通过 postman 来进行接口测试，将刚创建好数据的 excel 文件进行添加，然后点击【send】模拟接口请求。

具体传参及步骤演示如下：

我们可以看到请求成功了，返回了 code200.而且打开控制台也可以查看控制台实际 SQL 执行语句，具体如下：

最后我们再来看下数据库刚写入的数据，给大家校验一波，是否与 excel 内容一致？

写条 sql 按时间倒序排序查询一下，从库里也准确查出了我们刚导入的那部分数据，这下你们总该可以放心 copy 了吧。

        说实在的，我对自己要求还是很高的，一般如果是对于有功能问题或逻辑问题的代码，我都不会拿出来演示，以免误人子弟，既然要教学，那就要做到起码代码运行正常，且符合当时业务场景要求，否则就不写不分享。 

5️⃣总结

        对于越简单的逻辑接口而言，我们都要百分百用心写。

 ... ...

        好啦，以上就是这期的所有内容啦，你们学废了么？如果对你有所帮助，还请不要忘记给 bug 菌[三连支持]哟。如果想获得更多的学习资源或者想和更多的技术爱好者一起交流，可以关注我的公众号『​​猿圈奇妙屋​​』，后台回复关键词领取学习资料、大厂面经、面试模板等海量资源，就等你来拿。

四、往期热文推荐🔥

        对于问题反馈模块实战开发，我完整的梳理了每一期的教学及链接地址，仅供参考：希望能对你们有所帮助。

• ​​在线问题反馈模块实战(一):梳理业务需求并创建数据库表​​

• ​​在线问题反馈模块实战(二):封装代码自动生成类文件器​​

• ​​在线问题反馈模块实战(三):自动生成所有Controller、Service、Mapper等文件​​

• ​​在线问题反馈模块实战(四):封装通用字段类​​

• ​​在线问题反馈模块实战(五):实现对通用字段内容自动填充功能​​

• ​​在线问题反馈模块实战(六):接口文档定义​​

• ​​在线问题反馈模块实战(七):安装部署swagger2​​

• ​​在线问题反馈模块实战(八):实现图片上传功能-上篇​​

• ​​在线问题反馈模块实战(九):实现图片上传功能-下篇​​

• ​​在线问题反馈模块实战(十):实现图片预览功能​​

• ​​在线问题反馈模块实战(十一):实现图片下载功能​​

• ​​在线问题反馈模块实战(十二):实现图片删除功能​​

• ​​在线问题反馈模块实战(十三):实现多参数分页查询列表​​

• ​​在线问题反馈模块实战(十四):实现在线答疑功能​​

• ​​在线问题反馈模块实战(十五):实现在线更新反馈状态功能​​

• ​​在线问题反馈模块实战(十六):实现查详情功能​​

• ​​在线问题反馈模块实战(十七):实现excel模板在线下载功能​​

• ​​在线问题反馈模块实战(十八):实现excel台账文件记录批量导入功能​​

• ​​在线问题反馈模块实战(十九):实现数据批量导出到excel文件中功能​​

• ​​在线问题反馈模块实战(二十):实现文件批量导出到zip压缩包中功能​​

• ​​在线问题反馈模块实战(二十一):完结篇​​

        如上是整整二十期内容，每一期都是干货，对于一个模块的开发，如何一点一滴打造并测试部署上线，我再说一遍，这不是演习，是实战！是实战！是实战！

        若你们觉得只是需要了解其中某个知识点或者业务的话，也不反对，你就选择其中的几期进行学习就好，反正都已经完结啦；我只希望你们能有所收获，有所成长，也就不枉我苦心每天下班后给大家总结更新。

五、文末🔥

​​《springboot零基础入门教学》​​，都是我一手打下的江山，持续更新中，希望能帮助到更多小伙伴们。

我是 bug 菌，一名想走👣出大山改变命运的程序猿。接下来的路还很长，都等待着我们去突破、去挑战。来吧，小伙伴们，我们一起加油！未来皆可期，fighting！

        最后送大家两句我很喜欢的话，与诸君共勉！

☘️做你想做的人，没有时间限制，只要愿意，什么时候都可以开始。

🍀你能从现在开始改变，也可以一成不变；这件事，没有规矩可言，你可以活出最精彩的自己。

💌如果文章对您有所帮助，就请留下您的赞吧！(#^.^#)；

💝如果喜欢 bug 菌分享的文章，就请给 bug 菌点个关注吧！(๑′ᴗ‵๑)づ╭❤～；

💗如果对文章有任何疑问，还请文末留言或者加群吧【QQ 交流群:708072830】；

💞鉴于个人经验有限，所有观点及技术研点，如有异议，请直接回复参与讨论(请勿发表攻击言论，谢谢）；

💕版权声明：原创不易，转载请附上原文出处链接和本文声明，版权所有，盗版必究！！！谢谢。