wu-easy-excel-starter 数据快速导入导出

r囧r小猫 2021-09-21 23:36 287阅读 0赞

# wu-easy-excel-starter #

wu-easy-excel-starte是一个简单的Excel数据封装框架，具有以下优势

*  使用简单，只需一个注解即可搞定
 *  支持数据自动分割成多个sheet
 *  注解支持二次开发

# 快速入门 #

## 1.导入依赖 ##

框架默认使用poi-ooxml版本可有外层控制

<dependency>
                <groupId>top.wu2020</groupId>
                <artifactId>wu-easy-excel-starter</artifactId>
                <version>1.0.4</version>
            </dependency>

[最新版本][Link 1]

## 2.使用 ##

### 原生注解使用 ###

@EasyExcel(fileName = "导出数据")
        @ApiOperation(tags = "导出注解测试", value = "使用原生注解有效")
        @GetMapping("/run/{size}")
        public List<UseExcel> run(@PathVariable Integer size) {
            List<UseExcel> useExcelList = new ArrayList<>();
            for (int i = 0; i < size; i++) {
                UseExcel useExcel = new UseExcel();
                useExcel.setCurrentTime(LocalDateTime.now());
                useExcel.setDesc("默认方式导出数据");
                useExcel.setExcelId(i);
                useExcel.setType("默认方式双注解导出");
                useExcelList.add(useExcel);
            }
            return useExcelList;
        }

### 多sheet数据导出 ###

@EasyExcel(fileName = "导出数据多个工作簿", multipleSheet = true)
        @ApiOperation(tags = "导出注解测试", value = "使用原生注解有效多个工作簿")
        @GetMapping("/run1/{size}")
        public List<UseExcel> run1(@PathVariable Integer size) {
            return run(size);
        }

### 非原生注解导出 ###

@EasyExcel(fileName = "非原生注解导出数据", fieldColumnAnnotation = JSONField.class, fieldColumnAnnotationAttribute = "tableName", multipleSheet = true, limit = 1000, sheetShowContext = EasyExcel.SheetShowContext.TEXT)
        @ApiOperation(tags = "导出注解测试", value = "非原生注解导出数据")
        @GetMapping("/run2/{size}")
        public List<UseExcel> run2(@PathVariable Integer size) {
            List<UseExcel> useExcelList = new ArrayList<>();
            for (int i = 0; i < size; i++) {
                UseExcel useExcel = new UseExcel();
                useExcel.setCurrentTime(LocalDateTime.now());
                useExcel.setDesc("自定义字段注解方式导出数据");
                useExcel.setExcelId(i);
                useExcel.setType("自定义字段注解导出");
                useExcelList.add(useExcel);
            }
            return useExcelList;
        }

### 导出所有字段 ###

@EasyExcel(fileName = "导出所有字段", useAnnotation = false)
        @ApiOperation(tags = "导出注解测试", value = "导出所有字段")
        @GetMapping("/run3/{size}")
        public List<UseExcel> run3(@PathVariable Integer size) {
            List<UseExcel> useExcelList = new ArrayList<>();
            for (int i = 0; i < size; i++) {
                UseExcel useExcel = new UseExcel();
                useExcel.setCurrentTime(LocalDateTime.now());
                useExcel.setDesc("不使用注解导出所有字段");
                useExcel.setExcelId(i);
                useExcel.setType("导出所有字段");
                useExcelList.add(useExcel);
            }
            return useExcelList;
        }

### 自定义一注解导出 ###

@EasyExcelTemp(fileName = "自定义注解导出")
        @ApiOperation(tags = "导出注解测试", value = "自定义注解导出")
        @GetMapping("/run4/{size}")
        public List<UseExcel> run4(@PathVariable Integer size) {
            List<UseExcel> useExcelList = new ArrayList<>();
            for (int i = 0; i < size; i++) {
                UseExcel useExcel = new UseExcel();
                useExcel.setCurrentTime(LocalDateTime.now());
                useExcel.setDesc("自定义注解导出");
                useExcel.setExcelId(i);
                useExcel.setType("自定义注解导出");
                useExcelList.add(useExcel);
            }
            return useExcelList;
        }

### 自定义导出文件名 ###

@EasyExcel(fileName = "导出数据")
        @ApiOperation(tags = "导出注解测试", value = "使用原生注解有效(自定义一导出文件名称)")
        @GetMapping("/run6/{size}")
        public List<UseExcel> run6(@PathVariable Integer size, @RequestParam String fileName) {
            EasyExcelUtil.modifyCurrentMethodEasyExcelFileName(this.getClass(), fileName);
            return run(size);
        }

### 导入指定实体对应数据 ###

@ApiOperation(tags = "导入注解测试", value = "导入Excel并转换成对象")
        @PostMapping("/imp1")
        public String import1(@RequestPart MultipartFile multipartFile) {
            List<UseExcel> userLogList = FastExcelImp.parseExcel(multipartFile, UseExcel.class);
            return userLogList.toString();
        }

### 导入常规Excel数据 ###

@ApiOperation(tags = "导入注解测试", value = "导入Excel并转换成EasyHashMap对象")
        @PostMapping("/imp1/hash-map")
        public List<EasyHashMap> implMap(@RequestPart MultipartFile file) {
            List<EasyHashMap> easyHashMapList = FastExcelImp.parseExcel(file, EasyHashMap.class);
            if (ObjectUtils.isEmpty(easyHashMapList)) {
                return easyHashMapList;
            }
            return easyHashMapList;
        }

[模版学习][Link 2]

[Link 1]: https://search.maven.org/search?q=a:wu-easy-excel-starter
[Link 2]: https://gitee.com/wujiawei1207537021/wu-framework-parent/blob/master/wu-easy-parent/wu-easy-temple/src/main/java/com/wu/framework/easy/temple/controller/EasyExcelController.java