如何通过PDFBox获取PDRadioButton或PDCheckBox的可选值？

你遇到的核心问题是PDField是所有表单字段的父类，而getOnValues()是PDButton（及子类如PDCheckBox、PDRadioButton）特有的方法，必须先判断字段类型并正确向下转型，才能调用该方法。

你的代码存在的几个问题 #

• 用field.getClass().getName()做字符串匹配判断类型，这种方式脆弱且不推荐，应该用instanceof关键字
• 转型语法错误：(PDCheckBox)field.getOnValues()写法错误，需先将field转型为PDCheckBox，再调用方法
• 无需新建PDCheckBox实例，直接使用遍历到的现有字段即可

正确的实现方案 #

遍历表单字段时，先判断字段是否属于PDButton的子类（复选框、单选按钮这类有可选值的控件都继承自PDButton），转型后获取可选值集合，再从中随机选择一个值设置到字段上。同时要注意处理分组字段（非终端字段），比如单选按钮组需要递归遍历子字段。

修正后的代码示例：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDDocumentCatalog;
import org.apache.pdfbox.pdmodel.interactive.form.*;

import java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.Random;
import java.util.Set;

public class FormFieldRandomizer {
    public static void main(String args[]) throws IOException {
        File file = new File("government_form.pdf");
        // 使用try-with-resources自动关闭文档，避免资源泄漏
        try (PDDocument formular = PDDocument.load(file)) {
            PDDocumentCatalog pdCatalog = formular.getDocumentCatalog();
            PDAcroForm pdAcroForm = pdCatalog.getAcroForm();
            
            if (pdAcroForm == null) {
                System.out.println("文档中没有AcroForm表单");
                return;
            }

            List<PDField> fields = pdAcroForm.getFields();
            System.out.println(fields.size() + " 个顶层字段被找到");

            Random random = new Random();

            for (PDField field : fields) {
                // 处理分组字段（如单选按钮组），递归遍历子字段
                if (field instanceof PDNonTerminalField) {
                    processNonTerminalField((PDNonTerminalField) field, random);
                } else {
                    processTerminalField(field, random);
                }
            }

            formular.save("C:/PdfBox_Examples/Formular_ausgefüllt.pdf");
        }
    }

    // 递归处理非终端分组字段
    private static void processNonTerminalField(PDNonTerminalField nonTerminalField, Random random) {
        List<PDField> children = nonTerminalField.getChildren();
        for (PDField child : children) {
            if (child instanceof PDNonTerminalField) {
                processNonTerminalField((PDNonTerminalField) child, random);
            } else {
                processTerminalField(child, random);
            }
        }
    }

    // 处理单个终端字段
    private static void processTerminalField(PDField field, Random random) {
        // 处理复选框、单选按钮等PDButton子类
        if (field instanceof PDButton) {
            PDButton buttonField = (PDButton) field;
            Set<String> onValues = buttonField.getOnValues();
            
            if (!onValues.isEmpty()) {
                // 随机选一个可选值
                String[] valuesArray = onValues.toArray(new String[0]);
                String randomValue = valuesArray[random.nextInt(valuesArray.length)];
                
                try {
                    buttonField.setValue(randomValue);
                    System.out.println("为字段 " + field.getPartialName() + " 设置随机值：" + randomValue);
                } catch (IOException e) {
                    System.err.println("设置字段 " + field.getPartialName() + " 值失败：" + e.getMessage());
                }
            } else {
                System.out.println("字段 " + field.getPartialName() + " 无可选值");
            }
        }
        // 额外处理下拉框字段
        else if (field instanceof PDComboBox) {
            PDComboBox comboBox = (PDComboBox) field;
            List<String> options = comboBox.getOptions();
            if (!options.isEmpty()) {
                String randomOption = options.get(random.nextInt(options.size()));
                try {
                    comboBox.setValue(randomOption);
                    System.out.println("为下拉框 " + field.getPartialName() + " 设置随机值：" + randomOption);
                } catch (IOException e) {
                    System.err.println("设置下拉框 " + field.getPartialName() + " 值失败：" + e.getMessage());
                }
            }
        }
    }
}

关键说明 #

1. 递归处理分组字段：单选按钮通常以分组形式存在，必须递归遍历子字段才能获取到具体选项
2. PDButton通用处理：PDCheckBox、PDRadioButton都继承自PDButton，统一转型后即可调用getOnValues()
3. 下拉框适配：如果表单有下拉框（PDComboBox），可通过getOptions()获取可选值，逻辑与按钮类字段一致
4. 资源安全：用try-with-resources语法自动关闭文档，避免IO资源泄漏

内容的提问来源于stack exchange，提问作者KingWatermelon