Java PDF 支持中文字体

在使用 Java 生成 PDF 文件时，往往会遇到中文字体显示问题。由于 PDF 文件的特殊性，直接使用系统默认的中文字体可能会导致显示异常或乱码。本文将介绍如何在 Java 中实现对中文字体的支持，并提供相应的代码示例。

1. 概述

通常，Java 生成 PDF 文件可以使用诸如 Apache PDFBox、iText 等开源库。然而，这些库在处理中文字体时存在一些限制。为了能够正常显示中文字符，我们需要引入相应的中文字体文件，并将其注册到 Java 虚拟机中。

2. 准备工作

首先，我们需要选择合适的中文字体文件。一些常用的中文字体文件包括宋体（SimSun）、微软雅黑（Microsoft YaHei）、黑体（SimHei）等。这些字体文件通常可以在操作系统的字体目录中找到，比如 Windows 系统下的 C:\Windows\Fonts 文件夹。

在选择完合适的字体文件后，我们将其拷贝到 Java 应用程序的资源目录下，比如 src/main/resources/fonts 目录。

3. 导入字体文件

在 Java 中，我们可以使用 java.awt.Font 类来导入字体文件。下面是一个简单的代码示例，展示如何导入字体文件并注册到 Java 虚拟机中：

import java.awt.Font;
import java.awt.FontFormatException;
import java.io.File;
import java.io.IOException;

public class ChineseFontSupport {
    public static void importFont(String fontPath) throws FontFormatException, IOException {
        File fontFile = new File(fontPath);
        Font customFont = Font.createFont(Font.TRUETYPE_FONT, fontFile);
        GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
        ge.registerFont(customFont);
    }
}

在上述代码中，importFont 方法接受一个字体文件路径作为参数，然后使用 Font.createFont 方法将字体文件导入为一个自定义字体对象。最后，使用 GraphicsEnvironment 类的 registerFont 方法将自定义字体对象注册到 Java 虚拟机中。

4. 使用中文字体

一旦成功导入并注册了中文字体，我们就可以在生成 PDF 文件时使用它。下面是一个使用 Apache PDFBox 生成包含中文字符的 PDF 文件的示例代码：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.font.PDType0Font;
import org.apache.pdfbox.pdmodel.PDPageContentStream;

public class PDFGenerator {
    public static void generatePDF(String outputPath) throws IOException {
        PDDocument document = new PDDocument();
        PDPage page = new PDPage();
        document.addPage(page);

        PDPageContentStream contentStream = new PDPageContentStream(document, page);
        PDType0Font font = PDType0Font.load(document, new File("src/main/resources/fonts/SimSun.ttf"));
        contentStream.setFont(font, 12);
        contentStream.beginText();
        contentStream.newLineAtOffset(100, 700);
        contentStream.showText("你好，世界！");
        contentStream.endText();
        contentStream.close();

        document.save(outputPath);
        document.close();
    }
}

上述代码中，我们首先创建一个 PDDocument 对象表示整个 PDF 文档，然后创建一个 PDPage 对象表示一个页面。接下来，我们创建一个 PDPageContentStream 对象来操作页面内容，使用 PDType0Font.load 方法加载我们之前导入的中文字体文件，并将其设置为所需的字体和字号。

最后，我们可以使用 PDPageContentStream 的方法来添加文本内容等，如在示例中我们添加了一个中文字符串 "你好，世界！"。

5. 类图

下面是本文所介绍的主要类的类图：

classDiagram
    class ChineseFontSupport {
        + importFont(fontPath: String) : void
    }

    class PDFGenerator {
        + generatePDF(outputPath: String) : void
    }

    ChineseFontSupport --> PDFGenerator

6. 甘特图

下面是使用 Java 导入中文字体并生成 PDF 文件的甘特图：

gantt
    title Java 导入中文字体并生成 PDF 文件
    dateFormat  YYYY-MM-DD