如何用PDFBox获取PDF文件的初始视图放大属性

核心思路 #

PDF的初始视图放大率配置主要存储在文档目录的OpenAction中，部分无OpenAction的文档会使用页面默认视图配置，需分两种情况检测：

1. 检测文档的OpenAction配置 #

初始视图的跳转动作通常是PDActionGoTo类型，其目标PDPageDestination如果是PDPageFitWidthDestination实例，就说明设置了Fit Width。如果OpenAction是动作序列，需要解析内部的GoTo动作：

public static boolean isInitialViewFitWidth(PDDocument document) {
    PDDocumentCatalog catalog = document.getDocumentCatalog();
    PDAction openAction = catalog.getOpenAction();

    // 处理直接是GoTo动作的情况
    if (openAction instanceof PDActionGoTo) {
        PDPageDestination dest = ((PDActionGoTo) openAction).getDestination();
        return dest instanceof PDPageFitWidthDestination;
    }
    // 处理OpenAction本身就是Destination的情况
    else if (openAction instanceof PDPageFitWidthDestination) {
        return true;
    }
    // 处理动作序列（嵌套动作）
    else if (openAction instanceof PDActionSequence) {
        List<PDAction> actions = ((PDActionSequence) openAction).getActions();
        for (PDAction action : actions) {
            if (action instanceof PDActionGoTo) {
                PDPageDestination dest = ((PDActionGoTo) action).getDestination();
                if (dest instanceof PDPageFitWidthDestination) {
                    return true;
                }
            }
        }
    }
    return false;
}

2. 处理无OpenAction的文档 #

如果文档未设置OpenAction，阅读器会使用页面的默认视图配置，需要读取页面字典的/View条目，判断其类型是否为/FIT_H（对应Fit Width）：

public static boolean isPageDefaultFitWidth(PDDocument document) {
    PDPage firstPage = document.getPage(0);
    COSDictionary pageDict = firstPage.getCOSObject();
    COSBase viewEntry = pageDict.getDictionaryObject(COSName.VIEW);
    
    if (viewEntry instanceof COSDictionary) {
        COSDictionary viewDict = (COSDictionary) viewEntry;
        COSName viewType = viewDict.getName(COSName.S);
        return COSName.FIT_H.equals(viewType);
    }
    // 无页面默认视图时，阅读器会用Default，不属于Fit Width
    return false;
}

3. 批量检测文件夹内PDF #

结合上述两个方法，遍历文件夹下所有PDF文件，筛选出不符合Fit Width的文件：

public static void batchCheckPdfFolder(String folderPath) {
    File folder = new File(folderPath);
    File[] pdfFiles = folder.listFiles((dir, name) -> name.toLowerCase().endsWith(".pdf"));
    if (pdfFiles == null) return;

    for (File pdfFile : pdfFiles) {
        try (PDDocument doc = PDDocument.load(pdfFile)) {
            boolean isFitWidth = isInitialViewFitWidth(doc);
            // 无OpenAction时检查页面默认视图
            if (!isFitWidth) {
                isFitWidth = isPageDefaultFitWidth(doc);
            }
            if (!isFitWidth) {
                System.out.println("初始视图非Fit Width的文件：" + pdfFile.getAbsolutePath());
            }
        } catch (IOException e) {
            System.err.println("处理文件失败：" + pdfFile.getName() + "，错误：" + e.getMessage());
        }
    }
}

注意事项 #

• 确保使用PDFBox 2.x及以上版本，旧版本API可能存在差异
• 部分PDF的配置可能存在特殊嵌套，需根据实际情况扩展动作解析逻辑
• /FIT_H是PDF官方规范中定义的Fit Width对应操作符，PDFBox的PDPageFitWidthDestination底层映射该类型

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