使用 Java 的 PdfRendererBuilder 处理 PDF 文档
在现代软件开发中，生成 PDF 文档是一项常见的需求。Java 提供了一些库来简化这一过程，其中之一就是 PdfRendererBuilder。该工具可以将 HTML 文件或字符串转换为 PDF 文件。在使用 PdfRendererBuilder 时，我们可以通过一些配置选项来调整生成的 PDF 文档的属性，包括页面大小。
PdfRendererBuilder 简介
PdfRendererBuilder 是一个基于 Flying Saucer 的 PDF 渲染库，它使用 XHTML（或者 HTML）作为输入格式，并且能够输出高质量的 PDF 文档。使用此库的典型场景包括将网页内容转换为 PDF，生成报表等。
要开始使用 PdfRendererBuilder，首先需要在你的 Java 项目中引入相应的依赖。通常情况下，我们可以通过 Maven 来引入：
<dependency>
<groupId>com.github.jhonnymichel</groupId>
<artifactId>pdf-renderer</artifactId>
<version>1.0.0</version>
</dependency>
如何设置页面大小
在生成 PDF 时，我们通常需要指定页面尺寸，包括宽度和高度。使用 PdfRendererBuilder，我们可以设置这些参数。例如，以下代码展示了如何设置页面为 A4 大小：
PdfRendererBuilder builder = new PdfRendererBuilder();
builder.useFastMode(); // 提高渲染性能
builder.withUri("
builder.toStream(new FileOutputStream("output.pdf"));
builder.run();
上面的代码段中，我们没有设置页面尺寸，将自动使用默认值（通常为 A4）。但是，有些情况下，我们可能希望动态调整页面大小，尤其是在处理不同布局的页面时。
不设置高度的情况下的影响
useDefaultPageSize 这个方法可以帮我们简化页面大小的配置。根据文档，若不设置高度，PdfRendererBuilder 将会自动计算适合您的内容的高度。换句话说，如果你只设置了宽度，它会根据 HTML 内容的实际布局来推断页面的高度。这样的设计使得我们在生成 PDF 时更加灵活，而无需为每个内容单独指定页面大小。
以下是一些代码示例，使用 useDefaultPageSize 方法：
PdfRendererBuilder builder = new PdfRendererBuilder();
builder.useDefaultPageSize(210, -1); // 只设置宽度，-1 表示自动计算高度
builder.withUri("
builder.toStream(new FileOutputStream("output.pdf"));
builder.run();
在这个例子中，页面的宽度被设置为210mm，而高度则被传递为-1，这意味着将由库自动计算。这样的设计非常适合那些内容高度变化不定的页面。
自定义页面尺寸
如果你需要控制 PDFs 的每个页面尺寸，可以使用 useDefaultPageSize 来明确指定宽度和高度。例如，创建一个自定义页面大小的 A5 页面：
builder.useDefaultPageSize(148, 210); // A5 页面，宽148mm，高210mm
同时，你也可以使用其他单位，例如英寸，只需指定相应转换。
示例：生成不同页面大小的 PDF
下面的示例展示了如何为不同的内容生成各种页面大小的 PDF 文件：
public class PdfGenerator {
public static void main(String[] args) {
try {
createPdf(" "output1.pdf", 210, -1); // A4
createPdf(" "output2.pdf", 148, 210); // A5
createPdf(" "output3.pdf", 100, 150); // 自定义大小
} catch (Exception e) {
e.printStackTrace();
}
}
private static void createPdf(String uri, String outputFile, int width, int height) throws Exception {
PdfRendererBuilder builder = new PdfRendererBuilder();
builder.useDefaultPageSize(width, height);
builder.withUri(uri);
builder.toStream(new FileOutputStream(outputFile));
builder.run();
}
}
在这个示例中，我们通过调用 createPdf 方法来生成不同页面大小的 PDF。这种方法整洁且易于管理。
总结
Java 的 PdfRendererBuilder 提供了一种简便的方式来生成高质量的 PDF 文档，支持多种页面配置选项。尽管可以在使用时设置高度，但不设置高度的情况会让生成过程更灵活。通过合理利用 useDefaultPageSize，我们可以轻松地控制输出 PDF 的页面尺寸，使其能够适应不同内容的需要。无论是在生成正式报告或是自定义文档时，这种灵活性都显得尤为重要。
希望这篇文章能够对你理解 PdfRendererBuilder 的使用有所帮助，特别是在设置页面大小方面的应用。
