使用 iTextPDF 在 Java 中处理中文字体

引言

iTextPDF 是一个用于处理 PDF 文件的 Java 库。它提供了许多功能，使得我们可以在 Java 程序中生成和操作 PDF 文件。然而，由于 PDF 文件的特殊性，处理中文字符的方式与处理英文字符有所不同。本文将介绍如何在 iTextPDF 中使用中文字体，并给出相应的代码示例。

iTextPDF 中的字体

在 iTextPDF 中，字体是用于显示文本内容的关键组件。可以使用 iTextPDF 内置的几种字体，也可以自定义字体。然而，对于中文字符来说，我们通常需要使用特定的字体来确保正确的显示。

iTextPDF 提供了两种方法来加载字体：使用系统字体或者使用自定义字体文件。

使用系统字体

iTextPDF 默认使用系统字体来显示文本内容。对于大多数情况下，这是足够的。但是对于中文字符来说，系统字体可能无法正确显示，因此我们需要指定一个支持中文字符的字体。

通过以下代码，我们可以查看当前系统中可用的字体：

import java.awt.Font;

public class FontExample {
    public static void main(String[] args) {
        GraphicsEnvironment e = GraphicsEnvironment.getLocalGraphicsEnvironment();
        Font[] allFonts = e.getAllFonts();
        for (Font font : allFonts) {
            System.out.println(font.getFontName());
        }
    }
}

需要注意的是，iTextPDF 中使用的字体名称可能与系统中的字体名称不完全一致。可以通过在字体名称后面加上 -Bold 或者 -Italic 来指定字体的粗细和样式。

使用自定义字体文件

如果系统字体不能满足我们的需求，我们可以使用自定义字体文件。通常，我们可以从字体提供商处获得 TrueType 或 OpenType 格式的字体文件。以下是使用自定义字体文件的示例代码：

import com.itextpdf.text.BaseFont;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Element;
import com.itextpdf.text.Font;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfWriter;

public class CustomFontExample {
    public static void main(String[] args) {
        Document document = new Document();
        try {
            PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("output.pdf"));
            document.open();

            BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);
            Font fontChinese = new Font(bfChinese, 12, Font.NORMAL);
            Paragraph paragraph = new Paragraph("这是一段中文文本", fontChinese);
            document.add(paragraph);

            document.close();
            writer.close();
        } catch (DocumentException | IOException e) {
            e.printStackTrace();
        }
    }
}

代码中，我们首先通过 BaseFont.createFont 方法创建了一个中文字体对象 bfChinese。参数中的 "STSong-Light" 是字体的名称，"UniGB-UCS2-H" 是编码格式。然后，我们创建了一个使用该字体的文本段落，并将其添加到 PDF 文档中。

使用 iTextPDF 处理中文字符的注意事项

在使用 iTextPDF 处理中文字符时，还需要注意以下几点：

字体文件的引入

无论是使用系统字体还是自定义字体文件，都需要将字体文件正确地引入到项目中。如果使用自定义字体文件，需要将字体文件放在项目的资源文件夹中，并在代码中指定正确的字体文件路径。

字体文件的嵌入

如果希望生成的 PDF 文件能够正确显示中文字符，需要将字体文件嵌入到 PDF 文件中。这样，无论在何种环境下打开 PDF 文件，都能够正常显示中文字符。

在使用自定义字体文件时，我们可以通过将 BaseFont 对象的第三个参数设为 BaseFont.EMBEDDED 来嵌入字体文件。以下是示例代码：

BaseFont baseFont = BaseFont.createFont(fontPath, BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
Font font = new Font(baseFont, 12);

如果使用系统字体