PDFBox 2.0.16创建PDF作品集：设置首个附件为封面

要解决打开作品集时显示空白页的问题，核心是配置Collection字典的初始启动项，让PDF打开时直接加载并显示首个附件，同时移除默认生成的空白页。

关键修改步骤 #

• 确保首个附件已正确添加到PDF的嵌入式文件列表
• 配置Collection字典的Initial属性，指定打开时启动的附件
• 移除默认生成的空白页

完整代码示例 #

// 创建空PDF文档
PDDocument pdfDoc = new PDDocument();

// 添加首个附件到PDF
PDComplexFileSpecification firstAttachmentSpec = new PDComplexFileSpecification();
firstAttachmentSpec.setFile("portfolio_cover.pdf");
try (InputStream attachmentStream = new FileInputStream(new File("path/to/portfolio_cover.pdf"))) {
    PDFileEmbedded embeddedFile = new PDFileEmbedded(pdfDoc, attachmentStream, "portfolio_cover.pdf", "application/pdf");
    firstAttachmentSpec.setEmbeddedFile(embeddedFile);
    // 将附件加入文档的嵌入式文件名称字典
    PDNames names = pdfDoc.getDocumentCatalog().getNames();
    if (names.getEmbeddedFiles() == null) {
        names.setEmbeddedFiles(new PDEmbeddedFilesNameTreeNode());
    }
    names.getEmbeddedFiles().addEntry("portfolio_cover.pdf", firstAttachmentSpec);
}

// 配置Collection字典
COSDictionary collectionDict = new COSDictionary();
collectionDict.setName(COSName.TYPE, "Collection");
collectionDict.setName(COSName.VIEW, "T"); // 可选"T"(平铺视图)或"D"(详情视图)

// 设置初始启动项：打开PDF时直接加载首个附件
COSDictionary initialLaunchDict = new COSDictionary();
initialLaunchDict.setName("Type", "Launch");
initialLaunchDict.setItem("F", firstAttachmentSpec.getCOSObject()); // 关联到附件的文件规范
collectionDict.setItem("Initial", initialLaunchDict);

// 移除默认生成的空白页
if (!pdfDoc.getPages().isEmpty()) {
    pdfDoc.removePage(0);
}

// 将Collection字典关联到文档目录
PDDocumentCatalog catalog = pdfDoc.getDocumentCatalog();
catalog.getCOSObject().setItem("Collection", collectionDict);

// 保存并关闭文档
pdfDoc.save(new File("output_portfolio.pdf"));
pdfDoc.close();

关键说明 #

• VIEW属性：指定作品集的显示模式，按需选择"T"或"D"即可。
• Initial字典：通过Launch类型配置，直接关联到首个附件的文件规范对象，实现打开PDF时自动加载该附件内容。
• 移除空白页：从零创建的PDDocument默认会生成一页空白页，必须删除，否则会先显示空白页再切换到附件。

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