Itext7中PdfDictionary字体与Stream关联问题及代码咨询

问题背景 #

我有一个关于PdfDictionary字体与Stream之间关系的技术问题，以下是用于向页面字典添加字体的代码：

private void addFonts(PdfDocument pdfa, String fontPath) throws IOException {        
    PdfDictionary font;
    FontProgram fontProgram = FontProgramFactory.createFont(fontPath);
    FontProgramFactory.registerFont(fontPath);
    PdfFont fontNew = PdfFontFactory.createFont(fontProgram, PdfEncodings.IDENTITY_H, EmbeddingStrategy.PREFER_EMBEDDED);
    fontNew.setSubset(true);
    for (int i = 0; i <= pdfa.getNumberOfPdfObjects(); i++) {
        PdfObject obj = pdfa.getPdfObject(i);
        if (obj != null && !obj.isDictionary()) {
            continue;
        }
        font = (PdfDictionary) obj;
        if (font != null) {
            font.put(PdfName.Font, fontNew.getPdfObject()); 
            System.out.println(font);
        }
         
    }
    pdfa.addFont(fontNew);
}

执行代码后得到对应结果截图，我有三个具体疑问：

1. 为什么字体也会被添加到资源之外？（蓝色标注部分）
2. 如何将iText自动生成的字体名称/F47修改为/F1？（因流中存在/F1、/F2、/F3的引用，对应绿色标注部分）
3. 总体来说，如何生成"/F1"、"/F2"、"/F3"这类字体，并修改流中的对应引用？

问题解答 #

1. 字体被添加到资源之外的原因 #

你遍历了PDF中所有对象，只要是PdfDictionary就往里塞PdfName.Font键值对，这不仅包括页面资源字典，还会覆盖其他无关的字典（比如页面字典本身、注释字典、甚至字体字典自己），导致字体对象被错误关联到资源外的字典里。

正确做法是只定位到页面的资源字典（Resources），再往资源下的Fonts字典里添加字体，而非遍历所有对象盲目添加。

2. 修改iText自动生成的字体名称为/F1 #

iText默认按自增数字生成字体名称（比如/F47），要自定义名称，需手动操作字体的引用字典：

• 先获取页面的Resources字典，取出其中的Fonts字典（无则新建）
• 直接用PdfName.F1作为键，将fontNew.getPdfObject()放入Fonts字典
• 无需依赖fontNew自动生成的名称，手动指定键名即可覆盖默认命名

示例代码片段：

// 获取目标页面（以第一页为例，可循环处理所有页面）
PdfPage page = pdfa.getPage(1);
// 获取或创建页面资源字典
PdfDictionary resources = page.getResources();
if (resources == null) {
    resources = new PdfDictionary();
    page.put(PdfName.Resources, resources);
}
// 获取或创建Fonts字典
PdfDictionary fonts = resources.getAsDictionary(PdfName.Font);
if (fonts == null) {
    fonts = new PdfDictionary();
    resources.put(PdfName.Font, fonts);
}
// 手动指定字体名称/F1
fonts.put(PdfName.F1, fontNew.getPdfObject());

3. 生成指定名称的字体并修改流中引用 #

要生成/F1、/F2这类命名的字体并修正内容流引用，需分两步操作：

第一步：正确添加指定名称的字体到资源

参照上述代码，给每个字体指定自定义名称（/F1、/F2等），确保它们被正确放入页面的Resources->Fonts字典中。

第二步：修改内容流中的字体引用

PDF内容流中的字体引用（如/F1 Tf）为文本格式，可通过以下方式修改：

• 简单替换法：直接提取内容流字节数组，将旧字体名替换为目标名称，再重新设置页面内容流
• 解析修改法：使用PdfCanvasProcessor解析内容流，精准定位字体引用后修改（适合复杂PDF）

简单替换法示例代码：

// 获取页面内容流
byte[] contentBytes = page.getContentBytes();
String contentStr = new String(contentBytes, StandardCharsets.ISO_8859_1);
// 替换旧字体名为新名称
contentStr = contentStr.replace("/F47", "/F1");
// 重新设置内容流
page.setContentBytes(contentStr.getBytes(StandardCharsets.ISO_8859_1));

注意：直接字符串替换需确保不会误替换其他内容，复杂场景建议用PdfCanvasProcessor解析后操作。

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