你还在用原生 poi 处理 excel？太麻烦了来瞧瞧这个 ~

你还在用原生 poi 处理 excel？太麻烦了来瞧瞧这个 ~

一、easypoi
1.前言
Excel 在日常工作中经常被用来存储用例信息，是一种非常便捷的数据存储工具有着众多的优点，我们就不一一介绍了。
今天来讲讲 Java 操作 Excel，总所周知 Java 是世界上最好的语言（不容反驳），操作一个 Excel 肯定是不在话下，咱们熟知的 POI，Apache 大佬出品的一款非常强大的 office 软件操作包。虽然 POI 强大，但是代码相对比较繁琐，在当前 python 引领的大潮下，简化代码势在必行。
那么如何简化代码呢？其实这些事情早就已经有人帮我们想好和做好了，比如阿里巴巴的 easyexcel，和我们今天的主角 esaypoi 都是非常好的解决方案。那为什么选择 easypoi 而不是阿里的 easyexcel 呢，当然是 easypoi 的读写导入和导出更加简单。接下来大家就跟随着我一起慢慢揭开 easypoi 的神秘面纱。

2.简介
easypoi 功能如同名字 easy，主打的功能就是容易，让一个没见接触过 poi 的人员
就可以方便的写出 Excel 导出，Excel 模板导出，Excel 导入，Word 模板导出，通过简单的注解和模板。

官网：https://opensource.afterturn.cn/doc/easypoi.html

3.maven 坐标

<dependency>
	<groupId>cn.afterturn</groupId>
	<artifactId>easypoi-annotation</artifactId>
	<version>4.0.0</version>
</dependency>
<dependency>
	<groupId>cn.afterturn</groupId>
	<artifactId>easypoi-base</artifactId>
	<version>4.0.0</version>
</dependency>
<dependency>
	<groupId>org.hibernate</groupId>
	<artifactId>hibernate-validator</artifactId>
	<version>5.2.4.Final</version>
</dependency>

<dependency>
	<groupId>javax.el</groupId>
	<artifactId>javax.el-api</artifactId>
	<version>2.2.4</version>
</dependency>

4.最简单的导入
完成最简单的导入，只需要两步：一使用注解配置实体类，二调用工具类。

实体类（省略 get/set 方法）：

public class API implements Serializable {

	@Excel(name = "接口名称")
	private String name;
	@Excel(name = "接口编号")
	private String id;
	@Excel(name = "接口提交方式")
	private String type;
	@Excel(name = "接口地址")
	private String url;
	@Excel(name = "参数类型")
	private String contentType;
｝

@Excel(name = “接口名称”)这个注解是啥意思呢？name 属性表示 Excel 表头。如图：

当我们导入 Excel 时，就会按照@Excel 注解的映射关系封装 API 实体类。

工具类：

FileInputStream fis = new FileInputStream(EXCEL_PATH);
//导入参数设置类
ImportParams params = new ImportParams();
List<API> importExcel = ExcelImportUtil.importExcel(fis, API.class, params);

总共三行代码，第一行加载 Excel 文件，第二行设置导入参数，第三行根据导入参数返回对应结果并封装成 List 集合。这三个代码中主要讲解第二行和第三行，第二行是导入参数设置，它能给我们提供什么设置呢？
参考下表：

对照完这张表之后，你会发现即使我们不对 ImportParams 做任何设置，也会有对应的默认值。那么第二句代码就能翻译成：读取第一个 Sheet 且只读取第一个，表头是 Sheet 的第一行且只有一行。最终我们就能得到第一个 Sheet 中每一行数据，并且每一行被封装成了 API 对象也就是一个 List。有了这个集合之后我们需要导入的数据就能任由我们如何处理了，是不是很简单。

5.最简单的导出

List<API> list = new ArrayList<API>();
ExportParams exportParams = new ExportParams();
Workbook workbook = ExcelExportUtil.exportExcel(exportParams, API.class, list);
workbook.write(new FileOutputStream(EXCEL_PATH));

导出也只有四句代码。第一句是需要导出的数据集合，第二句导出参数，第三句获取导出 workbook 对象，第四句通过输出流导出数据到 Excel 中。其中第二句也是有很多设置的，我们就用默认设置也能是导出的。第三句也要用到 API 实体类中的注解映射关系。

6.## 标题最后
通过 esaypoi 我们能够使用最少的代码完成基本的导入和导出，基本上能够应对实际工作中 80% 的需求了，如果需要对 Excel 修改的话，目前来说市面上的工具包都做的不太简单，所以还是需要通过编写原生 poi 代码完成，如果你需要修改 Excel 的代码可以留言哦~