[Java]_[初级]_[使用easyexcel生成或下载Excel文件]

Posted 2021-12-14 infoworld

场景

1. 最近在开发JavaWeb网站时，有时候需要导出查询的数据为Excel数据. 使用POI库的话需要自己写每一列每一行，很麻烦. 如何能快速编码生成一个带表格数据Excel文件，但是性能也需要足够高，不能耗费太多内存。阿里的开源库easyexcel可以做到.

2. easyexcel是基于Java对象的成员变量映射到每行数据的，而大部分例子都是通过配置成员变量的注解属性来确定列名，忽略的列，合并列，字段输出格式等。那么如果不想用注解来说明成员变量，有什么办法？

说明

1. easyexcel这种基于Java对象输出数据到xlsx文件上也是有缺陷的，因为有些查询的数据并不是基于setter和getter方式的，最好能提供一个接口，类似Cocoa里的TableView, 可以重载一个代理，而这里代理有只有在显示数据时才会通过代理调用get方法取某行某列的数据，而不管原数据元如何存储.

   # 伪代码
   string get(int column,int row)
   

2. 模块化开发时，如果使用easyexcel对Java对象注解，那么就会对easyexcel有依赖，而用到这些对象的其他模块也会对easyexcel产生依赖。所以，不建议使用注解的方式来声明列属性。所幸easyexcel也提供了List作为参数对每列名进行声明的head()方法.

3. easyexcel也有包含需要输出的成员变量名includeColumnFiledNames()或排除输出的成员变量名excludeColumnFiledNames方法.

4. 常见的输出到文件的做法是传入一个文件字符串路径参数EasyExcel.write(fileName)创建一个ExcelWriterBuilder, 但是也支持传入流. 比如使用jfinal JavaWeb框架时，需要下载excel文件，那么可以通过传入输出流EasyExcel.write(response.getOutputStream())来直接输出，而不需要生成临时文件。有一点要注意， 在有些框架如jfinal里，输出流的关闭是由框架最后进行关闭的，而easyexcel默认会在数据输出完之后关闭输出流，所以会出问题。easyexcel也提供了一个设置是否自动关闭流的方法,可以设置为false, 这样框架关闭输出流时不会出问题.

   EasyExcel.write(response.getOutputStream()).autoCloseStream(false)
   

例子

1. 这里有生成文件和输出到流的例子，如果是想让easyexcel自动关闭输出流，那么方法autoCloseStream可以不调用.

生成文件

1. 输出到临时文件夹的simple-excel.xlsx里.

package com.example.excel;

import java.net.URL;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;

import com.alibaba.excel.EasyExcel;

import org.junit.jupiter.api.Test;

public class ExcelTest 
    
    public void print(String key,String str)
        System.out.println("*"+key+"*: ["+str+"]");
    

    @Test
    public void testNativeExcelGenerate()
        print("Excel","BEGIN");

        //URL resource = ExcelTest.class.getResource("");
        //print("Dir",resource.getPath());

        String tempPath =System.getProperty("java.io.tmpdir");
        String fileName = tempPath+"simple-excel.xlsx";
        print("FileName",fileName);

        Set<String> excludeColumnFiledNames = new HashSet<>();
        excludeColumnFiledNames.add("attrs");
        excludeColumnFiledNames.add("modifyFlag");
        excludeColumnFiledNames.add("configName");

        Set<String> includeColumnFiledNames = new HashSet<>();
        includeColumnFiledNames.add("string");
        includeColumnFiledNames.add("doubleData");

        List<String> stringTitle = new ArrayList<>();
        stringTitle.add("字符串");

        List<String> doubleDateTitle = new ArrayList<>();
        doubleDateTitle.add("数值");
        List<List<String>> list = new ArrayList<List<String>>();
        list.add(stringTitle);
        list.add(doubleDateTitle);

        EasyExcel.write(fileName)
                .excludeColumnFiledNames(excludeColumnFiledNames)
                .includeColumnFiledNames(includeColumnFiledNames)
                .sheet("模板")
                .head(list)
                .doWrite(() -> 
                    // 分页查询数据
                    return data();
                );
        
        print("Excel","END");
    

    private List<DemoData> data() 
        List<DemoData> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) 
            DemoData data = new DemoData();
            data.setString("字符串" + i);
            data.setDoubleData(0.56+i);
            list.add(data);
        
        return list;
    

输出到流

1. 部分参数创建省略，和输出到文件基本一样.

HttpServletResponse response = oc.getResponse();
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setCharacterEncoding("utf-8");
List<List<String>> headers = new ArrayList<List<String>>();
for (String one :tableHeaders) 
    List<String> l1 = new ArrayList<>();
    l1.add(one);
    headers.add(l1);


Set<String> excludeColumnFiledNames = new HashSet<>();
excludeColumnFiledNames.add("attrs");
excludeColumnFiledNames.add("modifyFlag");
excludeColumnFiledNames.add("configName");

boolean result = false;
try 
    String fileNameNew = URLEncoder.encode(fileName, "UTF-8");
    response.setHeader("Content-disposition", "attachment;filename=" + fileNameNew + ".xlsx");

    EasyExcel.write(response.getOutputStream()).autoCloseStream(false)
            .excludeColumnFiledNames(excludeColumnFiledNames)
            .includeColumnFiledNames(fields)
            .head(headers).sheet(fileName).doWrite(items);
    result = true;
 catch (UnsupportedEncodingException e) 
    logger.error("Excel encode fileName error "+fileName,e.getCause());
 catch (IOException e) 
    logger.error("Response getOutputStream fail ",e.getCause());

参考

1. easyexcel 写excel

2. easyexcel