Java POI 名称管理器 多级联动

最近做的一个项目设计到了Excel表格的多级联动，大致需求如下：通过收费项目联动带出收费标准，做完项目做个总结，颗粒归仓，源代码就不附上了，设计到公司的一些内容

 public static void main(String[] args) {
        String newFilePath="/Users/yangguangcai/Downloads/test1666.xls";
        String sheetTitle="ceshi";
        List<String> headers = Arrays.asList("手机号", "所在年级", "所在班级");
        Map<String, String[]> gradeMap = new HashMap<>();
        gradeMap.put("一年级",new String[]{"yi","一"});
        gradeMap.put("二年级",new String[]{"er","二"});
        String[] gradeInfo=new String[]{"一年级","二年级"};
        Cascade(newFilePath,sheetTitle,headers,gradeMap,gradeInfo);
    }

    public static void Cascade(String filePath, String sheetTitle, List<String> headers, Map<String,String[]> map, String[] fatherOption) {
        // 创建一个excel
        @SuppressWarnings("resource")
        Workbook book = new XSSFWorkbook();

        // 创建需要用户填写的sheet
        XSSFSheet sheetPro = (XSSFSheet) book.createSheet(sheetTitle);
        Row row0 = sheetPro.createRow(0);
        for (int i = 0;i<headers.size();i++){
            row0.createCell(i).setCellValue(headers.get(i));
        }
        //创建一个专门用来存放地区信息的隐藏sheet页
        //因此也不能在现实页之前创建，否则无法隐藏。
        Sheet hideSheet = book.createSheet("hideSheet");
        //这一行作用是将此sheet隐藏，功能未完成时注释此行,可以查看隐藏sheet中信息是否正确
        book.setSheetHidden(book.getSheetIndex(hideSheet), true);

        int rowId = 0;
        // 设置第一行，
        Row oneRow = hideSheet.createRow(rowId++);
        oneRow.createCell(0).setCellValue(sheetTitle);
        for(int i = 0; i < fatherOption.length; i ++){
            Cell provinceCell = oneRow.createCell(i + 1);
            provinceCell.setCellValue(fatherOption[i]);
        }
        // 将具体的数据写入到每一行中，行开头为父级区域，后面是子区域。
        for(int i = 0;i < fatherOption.length;i++){
            String key = fatherOption[i];
            String[] son = map.get(key);
            Row row = hideSheet.createRow(rowId++);
            row.createCell(0).setCellValue(key);
            for(int j = 0; j < son.length; j ++){
                Cell cell = row.createCell(j + 1);
                cell.setCellValue(son[j]);
            }
            // 添加名称管理器
            String range = getRange(1, rowId, son.length);
            Name name = book.createName();
            //key不可重复
            name.setNameName(key);
            String formula = "hideSheet!" + range;
            name.setRefersToFormula(formula);
        }
        XSSFDataValidationHelper dvHelper = new XSSFDataValidationHelper((XSSFSheet)sheetPro);
        // 省规则
        DataValidationConstraint provConstraint = dvHelper.createExplicitListConstraint(fatherOption);
        // 四个参数分别是：起始行、终止行、起始列、终止列
        CellRangeAddressList provRangeAddressList = new CellRangeAddressList(1, 20, 6, 6);
        DataValidation provinceDataValidation = dvHelper.createValidation(provConstraint, provRangeAddressList);
        //验证
        provinceDataValidation.createErrorBox("error", "请选择正确数据");
        provinceDataValidation.setShowErrorBox(true);
        provinceDataValidation.setSuppressDropDownArrow(true);
        sheetPro.addValidationData(provinceDataValidation);

        //对前20行设置有效性
        for(int i = 2;i < 20;i++){
            setDataValidation("G" ,sheetPro,i,8);
        }
        FileOutputStream os = null;
        try {
            os = new FileOutputStream(filePath);
            book.write(os);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            IOUtils.closeQuietly(os);
        }
    }

    /**
     * 设置有效性
     * @param offset 主影响单元格所在列，即此单元格由哪个单元格影响联动
     * @param sheet
     * @param rowNum 行数
     * @param colNum 列数
     */
    public static void setDataValidation(String offset,XSSFSheet sheet, int rowNum,int colNum) {
        XSSFDataValidationHelper dvHelper = new XSSFDataValidationHelper(sheet);
        DataValidation data_validation_list;
        data_validation_list = getDataValidationByFormula(
                "INDIRECT($" + offset + (rowNum) + ")", rowNum, colNum,dvHelper);
        sheet.addValidationData(data_validation_list);
    }

    /**
     * 加载下拉列表内容
     * @param formulaString
     * @param naturalRowIndex
     * @param naturalColumnIndex
     * @param dvHelper
     * @return
     */
    private static  DataValidation getDataValidationByFormula(
            String formulaString, int naturalRowIndex, int naturalColumnIndex,XSSFDataValidationHelper dvHelper) {
        // 加载下拉列表内容
        // 举例：若formulaString = "INDIRECT($A$2)" 表示规则数据会从名称管理器中获取key与单元格 A2 值相同的数据，
        //如果A2是江苏省，那么此处就是江苏省下的市信息。
        XSSFDataValidationConstraint dvConstraint = (XSSFDataValidationConstraint) dvHelper.createFormulaListConstraint(formulaString);
        // 设置数据有效性加载在哪个单元格上。
        // 四个参数分别是：起始行、终止行、起始列、终止列
        int firstRow = naturalRowIndex -1;
        int lastRow = naturalRowIndex - 1;
        int firstCol = naturalColumnIndex - 1;
        int lastCol = naturalColumnIndex - 1;
        CellRangeAddressList regions = new CellRangeAddressList(firstRow,
                lastRow, firstCol, lastCol);
        // 数据有效性对象
        // 绑定
        XSSFDataValidation data_validation_list = (XSSFDataValidation) dvHelper.createValidation(dvConstraint, regions);
        data_validation_list.setEmptyCellAllowed(false);
        if (data_validation_list instanceof XSSFDataValidation) {
            data_validation_list.setSuppressDropDownArrow(true);
            data_validation_list.setShowErrorBox(true);
        } else {
            data_validation_list.setSuppressDropDownArrow(false);
        }
        // 设置输入信息提示信息
        data_validation_list.createPromptBox("下拉选择提示", "请使用下拉方式选择合适的值！");
        // 设置输入错误提示信息

        return data_validation_list;
    }

    /**
     *  计算formula
     * @param offset 偏移量，如果给0，表示从A列开始，1，就是从B列
     * @param rowId 第几行
     * @param colCount 一共多少列
     * @return 如果给入参 1,1,10. 表示从B1-K1。最终返回 $B$1:$K$1
     *
     */
    public static String getRange(int offset, int rowId, int colCount) {
        char start = (char)('A' + offset);
        if (colCount <= 25) {
            char end = (char)(start + colCount - 1);
            return "$" + start + "$" + rowId + ":$" + end + "$" + rowId;
        } else {
            char endPrefix = 'A';
            char endSuffix = 'A';
            if ((colCount - 25) / 26 == 0 || colCount == 51) {// 26-51之间，包括边界（仅两次字母表计算）
                if ((colCount - 25) % 26 == 0) {// 边界值
                    endSuffix = (char)('A' + 25);
                } else {
                    endSuffix = (char)('A' + (colCount - 25) % 26 - 1);
                }
            } else {// 51以上
                if ((colCount - 25) % 26 == 0) {
                    endSuffix = (char)('A' + 25);
                    endPrefix = (char)(endPrefix + (colCount - 25) / 26 - 1);
                } else {
                    endSuffix = (char)('A' + (colCount - 25) % 26 - 1);
                    endPrefix = (char)(endPrefix + (colCount - 25) / 26);
                }
            }
            return "$" + start + "$" + rowId + ":$" + endPrefix + endSuffix + "$" + rowId;
        }
    }

分析：
Excel名称管理器的多级联动实际上就是再创建一个sheet，把内容先放到这个隐藏的sheet中，然后再联动地去取值，建议：先通过Excel自己创建多级联动，理解了它的原理之后也更方便去理解代码

遇到的坑：
1.名称管理器的时候不能识别一些特殊字符比如：“- （）”还有中文的括号
2.刚开始的时候没有先自己通过Excel去创建名称管理器，上来就看代码，有点瞎了，所以知道原理的重要性
3.第一次接触这个东西，所以整起来有些慢，平时应该多接触，多了解

参考：
POI 导出Excel 下拉列表多级联动（以省市县三级联动为例）
Java POI生成带有下拉框&级联下拉框的Excel
poi利用“名称管理器”构建excel级联下拉框的时候，一共有2级，一级列表包含数据类型为数字的数据，请问该怎么处理
Excel多级下拉菜单联动自动匹配内容