说明:本工具适用大部分导入导出场景,花点时间搞懂怎么用了之后灰常方便,阅读本文前,建议下载源码后参考着阅读。源码地址:https://gitee.com/xwzhang1/excel-util.git
在使用过程中如果有不懂的地方,请随时在项目issue中提问,我会在最短的时间内答复。 如果有好的建议也十分希望不吝赐教。
目录
讲道理,建议结合源码看,源码地址介绍的比这里简单多了,光看这篇文章。。。我自己都不想看!
导语
用户上传一个表格文件的时候,大部分表格中主要包含两类信息,一类我称之为散数据,如:定义在表格开头的 有效开始时间 或者 作者 等,另一类我称之为核心数据,也就是该表格中的主要数据。
对于获取表格数据的想法是这样:
散数据 通过行列参数获取
核心数据 通过表格逐行遍历获取,并且用一个List<T> 装起来。
可能面临的问题:
1. 用户不按照规定的模板写文件,还上传!!!!!我擦!搞个屁,不按照模板还要我处理,处理毛线啊!!!
2. 不按照模板处理也分为两种,一种是数据出现的位置,也就是模板的第一行第二列应该写入作者名字,但是用户偏偏把名字写在了第100行第1000列??还有人性吗? WTF!! 反正我没法搞定。还有一种稍微人性化一点的问题,数据格式不正确,数据重复验证,多列数据组合重复验证,数据能否为空等,像这样人性化一点的问题,我也将尝试着干一下。
3. 如果用户上传的文件中存在明显或者不明显的错误数据,如何告诉用户?
最后再用几句话总结一下,这个工具到底想干嘛:
1 - 将文件流转换成POI可以处理的对象格式
2 - 处理的时候,把核心数据取出来放到预定义的对象中
3 - 在转换过程中对可能出现的人性化的错误进行收集
4 - 对于散数据,提供一个方法,参数为行列值即可返回相应值,至于怎么处理由开发者自己根据业务需求决定。
5 - 将收集到的每一行的错误信息重写到表格文件中,并将得到的文件进行存储(计划使用Redis),提供给用户下载
说这么多空话,我们来开始干吧。
哦对了,POI我不做介绍了吧,还不了解的百度一下就行啦。
开始了。
第一步 创建项目
创建项目不用教程吧。项目结构?帖子最后会贴上源码地址。
我用的是IntelliJ Idea,新建项目
File -> New Project -> Spring Iniyializr ->Project SDK 1.8 -> ......
名字什么的自己起了,我创建的是一个SpringBoot Web项目,因为最后要通过接口从前端获取文件流。
创建完成之后再在启动类的同目录下新建几个文件夹,结构就是如图所示
pom.xml文件是这样
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.1.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.poi</groupId>
<artifactId>excel-deal</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>excel-deal</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<!--start basic-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--end basic-->
<!--start core-->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.9</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.9</version>
</dependency>
<!--end core-->
<!--start tool-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
</dependency>
<!--end tool-->
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
第二步 引入POI依赖(第一步中是所有的依赖)
<dependencies>中添加poi的依赖用于支持表格文件的读取和操作
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.9</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>3.9</version>
</dependency>
第三步 开始撸代码
后边由于内容比较多,细节也比较多,所以大多数需要注意的地方我会在代码中用备注的形式提示,其实逻辑都很简单,如果想了解细节,只需要跟着代码走一遍就清楚了。
3.1 创建类ExcelImportObject,用于定义在转换过程中需要预定义的各类参数。
package com