EasyExcel导出表格——下拉筛选

本文介绍如何使用EasyExcel实现在导出Excel时添加下拉筛选功能,包括处理下拉选项不超过50个及超过50个的情况。通过具体代码示例展示了如何设置下拉单元格范围、创建下拉筛选约束,并提供了当选项过多时利用额外Sheet页存储字典项的方法。
EasyExcel导出表格——下拉筛选
单元格添加下拉筛选
  1. 确保输入内容规范和准确
  2. 减少数据查询,提高用户使用感
  3. 根据用户权限,下拉筛选项控制
Controller层
 /**
  * 模板下载
  * @param response
  */
@GetMapping(value = "/download")
public void download(HttpServletResponse response) {
    // 导出模板名称
    String fileName = "负责人批量修改模板.xlsx";
    ClassPathResource classPathResource = new ClassPathResource("template/payment_permission.xlsx");
    try (InputStream inputStream = classPathResource.getInputStream();
         OutputStream out = response.getOutputStream();) {
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        // URLEncoder.encode防止中文乱码
        response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8")
                           + ";filename*=UTF-8" + URLEncoder.encode(fileName, "UTF-8"));
        // 表格填充数据
        List<PermissionExcel> excelList = permissionSettingService.listPermissionExcel();
        ExcelWriterBuilder writerBuilder = EasyExcel.write(out).withTemplate(inputStream);
        // PermissionExcelWriteHandler处理下拉的handler
        writerBuilder.sheet(0).registerWriteHandler(new PermissionExcelWriteHandler()).doFill(excelList);
    } catch (IOException e) {
        log.error(e.getMessage(), e);
        response.setStatus(500);
    }
}
处理字典项的Handler(下拉选项不超过50个)
public class PermissionExcelWriteHandler implements SheetWriteHandler {
    @Override
    public void beforeSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {

    }

    @Override
    public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {
        DataValidationHelper helper = writeSheetHolder.getSheet().getDataValidationHelper();
        // 设置下拉单元格的首行、末行、首列、末列
        CellRangeAddressList accountTypeCellRangeAddressList = new CellRangeAddressList(1, 2000, 2, 2);
        // AccountTypeEnum.dropIndex() 等于 String[] array = new String[]{"账户1", "账户2"};
        DataValidationConstraint accountTypeConstraint = helper.createExplicitListConstraint(AccountTypeEnum.dropIndex());
        DataValidation accountTypeDataValidation = helper.createValidation(accountTypeConstraint, accountTypeCellRangeAddressList);
        writeSheetHolder.getSheet().addValidationData(accountTypeDataValidation);
    }
}

当下拉选项值超过50个时,使用上述方式handler处理,导出的表格中下拉选项不显示,这时候需要将下拉选的内容存在另一个sheet页中。

处理字典项的Handler(下拉选项超过50个)

阿里云参考文档

public class SocialBillExtendExcelWriteHandler implements SheetWriteHandler {
	/**
	 * key 下拉选项需要填充的列序号,value存放对应的下拉选项内容
	 */
    private Map<Integer, List<String>> selectMap;

    private char[] alphabet = new char[]{'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'};
	
    public SocialBillExtendExcelWriteHandler(Map<Integer, List<String>> selectMap) {
        this.selectMap = selectMap;
    }

    @Override
    public void beforeSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {

    }

    @Override
    public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {
        if (CollUtil.isEmpty(selectMap)) {
            return;
        }
        // 需要设置下拉框的sheet页
        Sheet curSheet = writeSheetHolder.getSheet();
        DataValidationHelper helper = curSheet.getDataValidationHelper();
        String dictSheetName = "数据字典";
        Workbook workbook = writeWorkbookHolder.getWorkbook();
        // 创建数据字典的sheet页
        Sheet dictSheet = workbook.createSheet(dictSheetName);
        // 提升用户体验,隐藏数据字典的sheet页
        workbook.setSheetHidden(workbook.getSheetIndex(dictSheet), true);
        for (Map.Entry<Integer, List<String>> entry : selectMap.entrySet()) {
            // 设置下拉单元格的首行、末行、首列、末列
            CellRangeAddressList rangeAddressList = new CellRangeAddressList(2, 100, entry.getKey(), entry.getKey());
            int rowLen = entry.getValue().size();
            // 设置字典sheet页的值 每一列一个字典项
            Iterator<String> iterator = entry.getValue().iterator();
            int rowIndex = 0;
            while (iterator.hasNext()) {
                Row row = dictSheet.getRow(rowIndex);
                if (row == null) {
                    row = dictSheet.createRow(rowIndex);
                }
                row.createCell(entry.getKey()).setCellValue(iterator.next());
                rowIndex++;
            }
            String excelColumn = getExcelColumn(entry.getKey());
            // 下拉框数据来源 eg:字典sheet!$B1:$B2
            String refers = dictSheetName + "!$" + excelColumn + "$1:$" + excelColumn + "$" + rowLen;
            // 创建可被其他单元格引用的名称
            Name name = workbook.createName();
            // 设置名称的名字
            name.setNameName("dict" + entry.getKey());
            // 设置公式
            name.setRefersToFormula(refers);
            // 设置引用约束
            DataValidationConstraint constraint = helper.createFormulaListConstraint("dict" + entry.getKey());
            // 设置约束
            DataValidation validation = helper.createValidation(constraint, rangeAddressList);
            if (validation instanceof HSSFDataValidation) {
                validation.setSuppressDropDownArrow(false);
            } else {
                validation.setSuppressDropDownArrow(true);
                validation.setShowErrorBox(true);
            }
            // 阻止输入非下拉框的值
            validation.setErrorStyle(DataValidation.ErrorStyle.STOP);
            validation.createErrorBox("提示", "此值与单元格定义格式不一致!");
            // 添加下拉框约束
            writeSheetHolder.getSheet().addValidationData(validation);
        }
    }

    /**
     * 将数字列转化成为字母列
     * @param num
     */
    private String getExcelColumn(int num) {
        String column = "";
        int len = alphabet.length - 1;
        int first = num / len;
        int second = num % len;
        if (num <= len) {
            column = alphabet[num] + "";
        } else {
            column = alphabet[first - 1] + "";
            if (second == 0) {
                column = column + alphabet[len] + "";
            } else {
                column = column + alphabet[second - 1] + "";
            }
        }
        return column;
    }
}
### 如何在EasyExcel中配置导出模板的下拉选择功能 要在EasyExcel中实现导出带有下拉选择功能的Excel模板,可以通过自定义`WriteHandler`来完成。以下是详细的说明和代码示例。 #### 实现原理 通过继承`AbstractCellWriteHandler`并重写其方法,可以实现在特定单元格位置插入下拉列表的功能。具体来说,需要创建一个名为`SpinnerWriteHandler`的类,在该类中处理下拉选项的数据,并将其绑定到目标单元格[^3]。 #### 依赖引入 确保项目的pom.xml文件中有如下依赖项以支持EasyExcel操作: ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency> ``` #### 自定义SpinnerWriteHandler类 下面是一个用于设置下拉菜单的处理器实例: ```java import com.alibaba.excel.write.handler.CellWriteHandler; import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFDataValidationHelper; import java.util.List; public class SpinnerWriteHandler implements CellWriteHandler { private final List<String> spinnerValues; public SpinnerWriteHandler(List<String> spinnerValues) { this.spinnerValues = spinnerValues; } @Override public void beforeCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Row row, Head head, Integer columnIndex, Integer relativeRowIndex, Boolean isHead) { // 不做任何事 } @Override public void afterCellCreated(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { Sheet sheet = writeSheetHolder.getSheet(); if (!isHead && relativeRowIndex == 0) { // 只针对第一行数据应用下拉框逻辑 DataValidationConstraint constraint = new XSSFDataValidationHelper(sheet).createExplicitListConstraint(spinnerValues.toArray(new String[0])); int firstRow = relativeRowIndex; // 起始行索引 int lastRow = firstRow + 100; // 结束行索引(假设最多有100条记录) int firstCol = cell.getColumnIndex(); // 当前列作为起始列 int lastCol = firstCol; // 同样结束于当前列 CellRangeAddressList regions = new CellRangeAddressList(firstRow, lastRow, firstCol, lastCol); DataValidation validation = sheet.getDataValidation(constraint, regions); sheet.addValidationData(validation); } } } ``` 此部分实现了对指定区域内的单元格添加下拉列表约束的操作[^3]。 #### 控制器层调用示例 当客户端请求下载带下拉框的Excel模板时,服务器端可通过以下方式响应: ```java @GetMapping(value = "/exportExcelTemplate") public void exportExcel(HttpServletResponse response) throws Exception { String fileName = "导入xxxx模板.xlsx"; // 获取建筑名称列表作为下拉框的内容源 List<String> buildingNames = adsBuildingChildService.getBuildingNameList() .stream() .map(AdsBuildingChildName::getBuildingChildName) .collect(Collectors.toList()); // 设置HTTP响应头信息 response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setCharacterEncoding("utf-8"); response.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode(fileName, "UTF-8")); try ( OutputStream out = response.getOutputStream(); InputStream templateStream = this.getClass().getResourceAsStream("/excelTemplate/" + fileName)) ) { EasyExcel.write(out) .withTemplate(templateStream) .registerWriteHandler(new SpinnerWriteHandler(buildingNames)) // 注册下拉框处理器 .sheet() .doWrite(Collections.emptyList()); // 如果只是导出模板,则无需实际数据填充 } catch (IOException e) { throw new RuntimeException(e.getMessage(), e); } } ``` 以上代码片段展示了如何利用Spring MVC框架中的控制器方法返回一个包含预设下拉框的Excel文档给前端用户下载[^3]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值