简介

HTML（超文本标记语言）和 PDF（便携式文档格式）是两种常见的文档格式，在不同的场景下都有广泛的应用。有时，我们需要将 HTML 文档转换成 PDF 格式，以便打印、存档或在其他应用程序中使用。本文将详细介绍如何在 Java 中完成 HTML 到 PDF 的转换，并提供实际代码示例。

使用第三方库

iText

iText 是一款流行的 Java PDF 库，提供了以下方法来转换 HTML 到 PDF：

使用 `XMLWorkerHelper.parseXHtml` 方法解析 HTML 文档。

将解析后的 XML 使用 `PdfWriter` 写入 PDF 文件。

使用 `Document` 对象添加元数据、页面设置和内容。

Flying Saucer

Flying Saucer 是另一个基于 iText 的 Java HTML 到 PDF 库，它提供了更简单的 API 来进行转换：

使用 `PDFDocument` 类加载 HTML 文档。

使用 `save()` 方法导出 PDF 文件。

JxBrowser

JxBrowser 是一款基于 Chromium 的商业 Java 库，它提供了将 HTML 渲染为 PDF 文件的功能：

使用 `Browser` 类加载 HTML 文档。

使用 `print()` 方法将 HTML 渲染为 PDF。

手动转换

除了使用第三方库之外，我们还可以手动将 HTML 转换为 PDF：

使用 `DocumentBuilderFactory` 创建一个 DOMBuilderFactory。

然后，使用 DOMBuilderFactory 创建一个 DocumentBuilder。

使用 DocumentBuilder 解析 HTML 文档并生成 PDF 文件。

代码示例

iText

```java

import com.itextpdf.text.Document;

import com.itextpdf.text.DocumentException;

import com.itextpdf.text.PageSize;

import com.itextpdf.text.pdf.PdfWriter;

import com.itextpdf.tool.xml.XMLWorkerHelper;

import java.io.FileOutputStream;

import java.io.StringReader;

public class HtmlToPdf {

public static void main(String[] args) throws Exception {

Hello World!

Document document = new Document(PageSize.A4);

PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("test.pdf"));

document.open();

XMLWorkerHelper.getInstance().parseXHtml(writer, document, new StringReader(html));

document.close();

}

```

Flying Saucer

```java

import com.lowagie.text.pdf.PdfDocument;

import com.lowagie.text.pdf.PdfWriter;

import java.io.File;

import java.io.FileOutputStream;

public class HtmlToPdf {

public static void main(String[] args) throws Exception {

PdfDocument pdf = new PdfDocument();

PdfWriter writer = new PdfWriter(new FileOutputStream("test.pdf"));

pdf.open(writer);

pdf.loadFromFile("test.html");

pdf.close();

}

```

JxBrowser

```java

import com.teamdev.jxbrowser.chromium.Browser;

import com.teamdev.jxbrowser.chromium.PDF;

import com.teamdev.jxbrowser.chromium.pdf.PDFOptions;

import java.awt.Dimension;

import java.io.File;

import java.nio.file.Paths;

public class HtmlToPdf {

public static void main(String[] args) throws Exception {

Browser browser = new Browser();

browser.setSize(new Dimension(400, 300));

browser.loadURL("file://" + Paths.get("test.html").toAbsolutePath().toString());

browser.print(new File("test.pdf"), new PDFOptions());

}

```

手动转换

```java

import javax.xml.parsers.DocumentBuilder;

import javax.xml.parsers.DocumentBuilderFactory;

import java.io.FileOutputStream;

public class HtmlToPdf {

public static void main(String[] args) throws Exception {

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();

DocumentBuilder builder = factory.newDocumentBuilder();

org.w3c.dom.Document document = builder.parse("test.html");

FileOutputStream outputStream = new FileOutputStream("test.pdf");

// Here, we would use a third-party library to convert the DOM document to PDF.

outputStream.close();

}

```

Java HTML 转 PDF 常见问题解答

Q: 如何指定 PDF 的页面大小？

A: `Document` 对象提供了 `setPageSize()` 方法来设置 PDF 页面大小，例如 `PageSize.A4`。

Q: 如何添加元数据到 PDF 文件？

A: `Document` 对象提供了 `addTitle()`、`addAuthor()` 等方法来添加元数据。

Q: 如何设置 PDF 文件的页边距？

A: `Document` 对象提供了 `setMargins()` 方法来设置 PDF 文件的页边距。

Q: 如何使用 CSS 样式？

A: `XMLWorkerHelper` 类提供了 `setStyleSheet()` 方法来设置 CSS 样式。

Q: 如何转换带图像的 HTML 文档？

A: `XMLWorkerHelper` 类提供了 `parseXHtml` 方法的重载，可以传入一个 `ImageProvider` 对象来处理图像。

Q: 如何使用自定义字体？

A: `XMLWorkerHelper` 类提供了 `setFontProvider()` 方法来设置自定义字体，例如 `FontFactory`。

Q: 如何使用第三方库在 Java 中转换 HTML 到 PDF？

A: `iText`、`Flying Saucer` 和 `JxBrowser` 是 Java 中常用的第三方库，提供了简单易用的 API 来转换 HTML 到 PDF。