iText7中如何按添加时间调整PDF附件的显示顺序？

看起来你遇到的问题是iText默认会对嵌入文件的名称树进行排序，导致你按顺序添加的附件最终还是按名称排列。下面我来帮你解决这个问题：

问题根源 #

PdfDocument.addFileAttachment()方法内部会自动维护一个排序后的名称树（Name Tree），它会根据附件文件名的字母顺序重新排列，所以即使你按attachmentpaths的顺序添加，最终PDF里的附件列表还是会被重新排序。

解决方案：手动构建未排序的名称树 #

要让附件按添加时间（即你传入的attachmentpaths的顺序）显示，我们需要绕过iText的自动排序逻辑，手动构建并设置嵌入文件的名称树，保持插入顺序。

修改后的代码实现 #

@Override 
public boolean attachFile(String src, String dest, List<SysItemfile> attachmentpaths) { 
    try { 
        PdfDocument pdfDoc = new PdfDocument(new PdfReader(src), new PdfWriter(dest)); 
        List<String> descs = new ArrayList<>(); 
        int i = 0; 

        // 1. 使用LinkedHashMap保持附件的插入顺序
        Map<String, PdfObject> attachmentMap = new LinkedHashMap<>();

        for (SysItemfile attachmentpath : attachmentpaths) { 
            String filename = attachmentpath.getFilename(); 
            System.out.println("filename:"+filename); 

            // 处理重复文件名
            if (descs.contains(filename)) { 
                String suffix = filename.substring(filename.lastIndexOf(".") + 1); 
                String realname = filename.substring(0,filename.lastIndexOf(".")); 
                filename = realname + i + "." + suffix; 
                i++; 
            } else { 
                descs.add(filename); 
            } 

            // 创建嵌入文件规范
            PdfFileSpec spec = PdfFileSpec.createEmbeddedFileSpec(
                pdfDoc, 
                attachmentpath.getFileurl(), 
                filename, 
                filename, 
                null, // 不需要自定义PdfName，用默认即可
                null
            ); 

            // 将附件加入有序Map中
            attachmentMap.put(filename, spec.getPdfObject());
        } 

        // 2. 手动构建嵌入文件的名称树
        PdfNameTree embeddedFilesTree = new PdfNameTree(PdfName.EmbeddedFiles);
        embeddedFilesTree.setNames(attachmentMap);

        // 3. 将名称树写入PDF并关联到Catalog
        PdfDictionary catalog = pdfDoc.getCatalog().getPdfObject();
        PdfDictionary namesDict = catalog.getAsDictionary(PdfName.Names);
        if (namesDict == null) {
            namesDict = new PdfDictionary();
            catalog.put(PdfName.Names, namesDict);
        }

        PdfIndirectReference treeRef = embeddedFilesTree.writeTree(pdfDoc);
        PdfDictionary embeddedFilesDict = new PdfDictionary();
        embeddedFilesDict.put(PdfName.Names, treeRef);
        namesDict.put(PdfName.EmbeddedFiles, embeddedFilesDict);

        pdfDoc.close(); 
    } catch (IOException e) { 
        logger.error("attachFile unsuccess!"); 
        logger.error(e.getLocalizedMessage()); 
        return false; 
    } 
    return true; 
}

关键说明 #

• LinkedHashMap的作用：它会严格保持元素的插入顺序，确保我们添加附件的顺序不会被打乱。
• 手动构建名称树：绕过iText自动排序的逻辑，直接将有序的附件列表写入PDF的名称树中。
• 阅读器兼容性：部分PDF阅读器（比如Adobe Acrobat）默认会按名称排序附件，此时你需要在阅读器的附件面板中手动切换排序方式：右键附件列表 → 选择「排序方式」→「添加顺序」，就能看到我们设置的顺序了。

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