# excel-spring-boot-starter
**Repository Path**: zn-coding/excel-spring-boot-starter
## Basic Information
- **Project Name**: excel-spring-boot-starter
- **Description**: EasyExcel spring boot 封装
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 66
- **Created**: 2021-11-24
- **Last Updated**: 2021-11-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## EasyExcel
EasyExcel是一个基于Java的简单、省内存的读写Excel的开源项目。在尽可能节约内存的情况下支持读写百M的Excel。
64M内存1分钟内读取75M(46W行25列)的Excel,当然还有急速模式能更快，但是内存占用会在100M多一点
## spring boot stater依赖
- 方便在 web 环境下使用 `easyexcel` ，已上传至 maven 仓库
```xml
com.pig4cloud.excel
excel-spring-boot-starter
0.4.1
```
## 读取 Excel
- 接口类定义List 接受表格对应的数据 使用 @RequestExcel 标记
```java
@PostMapping
public String req(@RequestExcel List demoList, BindingResult bindingResult) {
// demoList 自动注入校验通过的数据
// bindingResult 获取到不合法的数据 其中 key 对应行号
Map>> errorMap = (Map>>) bindingResult.getTarget();
return "success";
}
```
- 实体声明
```java
@Data
public class Demo {
@ExcelProperty(index = 0)
private String username;
@ExcelProperty(index = 1)
private String password;
}
```
- 测试表格
## Excel 读取（解析）
只需要在 `Controller` 层方法便增加 `@RequestExcel` 注解即可，该注解上可自定义 `readListener`。
```java
@PostMapping("/upload")
public void upload(@RequestExcel List dataList) {
}
```
## Excel 生成
只需要在 `Controller` 层返回 List 并增加 `@ResponseExcel`注解即可
```java
@Documented
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ResponseExcel {
String name() default "";
ExcelTypeEnum suffix() default ExcelTypeEnum.XLSX;
String password() default "";
Sheet[] sheets() default @Sheet(sheetName = "sheet1");
boolean inMemory() default false;
String template() default "";
String[] include() default {};
String[] exclude() default {};
Class[] writeHandler() default {};
Class[] converter() default {};
Class headGenerator() default HeadGenerator.class;
}
```
## 基础用法
- 返回单 `sheet`, 全部字段导出
```java
@ResponseExcel(name = "test", sheets = @Sheet(sheetName = "testSheet1"))
@GetMapping("/e1")
public List e1() {
List dataList = new ArrayList<>();
for (int i = 0; i < 100; i++) {
DemoData data = new DemoData();
data.setUsername("tr1" + i);
data.setPassword("tr2" + i);
dataList.add(data);
}
return dataList;
}
// 实体对象
@Data
public class DemoData {
private String username;
private String password;
}
```
- 自定义字段属性
```java
@Data
public class DemoData {
@ColumnWidth(50) // 定义宽度
@ExcelProperty("用户名") // 定义列名称
@ContentStyle(fillPatternType = FillPatternType.SOLID_FOREGROUND, fillForegroundColor = 40)
private String username;
@ExcelProperty("密码")
private String password;
}
```
- 忽略部分字段
```java
@Data
public class DemoData {
@ColumnWidth(50) // 定义宽度
@ExcelProperty("用户名") // 定义列名称
@ContentStyle(fillPatternType = FillPatternType.SOLID_FOREGROUND, fillForegroundColor = 40)
private String username;
@ExcelProperty("密码")
private String password;
}
```
## 自定义导出头信息
**测试实体类：**
```java
@Data
public class SimpleData {
@ExcelProperty("字符串标题")
private String string;
@ExcelProperty("日期标题")
private Date date;
@ExcelProperty("数字标题")
private Integer number;
/**
* 忽略这个字段
*/
@ExcelIgnore
private String ignore;
}
```
**自定义头信息生成器**：
> 注意需要实现 `HeadGenerator` 接口，且注册为一个 spring bean.
```java
@Component
public class SimpleDataHeadGenerator implements HeadGenerator {
@Override
public HeadMeta head(Class clazz) {
HeadMeta headMeta = new HeadMeta();
headMeta.setHead(simpleDataHead());
// 排除 number 属性
headMeta.setIgnoreHeadFields(new HashSet<>(Collections.singletonList("number")));
return headMeta;
}
private List> simpleDataHead() {
List> list = new ArrayList<>();
List head0 = new ArrayList<>();
head0.add("自定义字符串标题" + System.currentTimeMillis());
List head1 = new ArrayList<>();
head1.add("自定义日期标题" + System.currentTimeMillis());
list.add(head0);
list.add(head1);
return list;
}
}
```
该头生成器，将固定返回 自定义字符串标题 和 自定义日期标题 两列头信息，实际使用时可根据业务动态处理，方便在一些权限控制和国际化处理时动态修改列头。
**测试代码：**
```java
@RequestMapping("/head")
@RestController
public class ExcelHeadTestController {
@ResponseExcel(name = "customHead", headGenerator = SimpleDataHeadGenerator.class)
@GetMapping
public List multi() {
List list = new ArrayList<>();
for (int i = 0; i < 10; i++) {
SimpleData simpleData = new SimpleData();
simpleData.setString("str" + i);
simpleData.setNumber(i);
simpleData.setDate(new Date());
list.add(simpleData);
}
return list;
}
}
```
## 导出多sheet
```java
@ResponseExcel(name = "lengleng", sheets = {
@Sheet(sheetName = "第一个Sheet"),
@Sheet(sheetName = "第二个sheet")
})
@GetMapping("/e1")
public List> e1() {
List> lists = new ArrayList<>();
lists.add(list());
lists.add(list());
return lists;
}
```
## 导出多 Sheet 并定制 Sheet
这里两个 sheet 导出不同类型的对象，只导出 DemoData 中的 username 属性，且将 testData 中的 number 属性排除。
```java
@ResponseExcel(name = "lengleng", sheets = {
@Sheet(sheetName = "demoData", includes = {"username"}),
@Sheet(sheetName = "testData", excludes = {"number"})
})
@GetMapping("/diffrent")
public List multiDiffrent() {
List lists = new ArrayList<>();
lists.add(demoDatalist());
lists.add(testDatalist());
return lists;
}
```
```java
@Data
public class TestData {
private String str;
private Integer number;
@ColumnWidth(50) // 定义宽度
private LocalDateTime localDateTime;
}
```
## 设置导出加密码
```java
@ResponseExcel(name = "lengleng", password = "lengleng")
@GetMapping("/e1")
public List e1() {
return list();
}
```
## 添加全局自定义转换器（Converter）
`0.0.7` 版本开始添加了全局自定义转换器注入的功能，你只需要将自定义的 `Converter` 注册成 `Spring bean` 即可。
示例代码如下（对 set 类型转换）：
```java
@Data
public class TestModel {
@ExcelProperty("名称集合")
private Set nameSet;
}
/**
* 集合转换器
*
* @author L.cm
*/
@Component
public class SetConverter implements Converter> {
private final ConversionService conversionService;
SetConverter() {
this.conversionService = DefaultConversionService.getSharedInstance();
}
@Override
public Class supportJavaTypeKey() {
return Set.class;
}
@Override
public CellDataTypeEnum supportExcelTypeKey() {
return CellDataTypeEnum.STRING;
}
@Override
public Set convertToJavaData(CellData cellData, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {
String[] value = StringUtils.delimitedListToStringArray(cellData.getStringValue(), ",");
return (Set) conversionService.convert(value, TypeDescriptor.valueOf(String[].class), new TypeDescriptor(contentProperty.getField()));
}
@Override
public CellData convertToExcelData(Set value, ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {
return new CellData<>(StringUtils.collectionToCommaDelimitedString(value));
}
}
```
## 高级用法模板导出
```java
@ResponseExcel(name = "模板测试excel", sheet = "sheetName",template = "example.xlsx")
@GetMapping("/e1")
public List e1() {
return list();
}
```
## 其他用法
- 理论上支持 [alibaba/easyexcel](https://github.com/alibaba/easyexcel) v2.2.10 版本的大部分配置
- 支持 [alibaba/easyexcel](https://www.yuque.com/easyexcel/doc/write) 原生的配置注解
- [github stater 地址，可fork 魔改](https://github.com/pigxcloud/excel-spring-boot-starter)