使用 Apache PDFBox 在 Java 中将图像插入 PDF 文档

介绍

在本教程中，我们将学习如何使用 Java 中的 Apache PDFBox 库创建 PDF 文档，然后将图像插入 PDF 文档页面。

Apache PDFBox 概述

Apache PDFBox 是一个开源库，用于在 Java 中处理 PDF 文档。您可以在pdfbox.apache.org获得有关该项目的更多信息

添加 Apache PDFBox 依赖项

如果您使用 Gradle 构建工具，请将以下依赖项添加到 build.gradle 文件中。

compile group: 'org.apache.pdfbox', name: 'pdfbox', version: '2.0.18'

如果您使用的是 Maven 构建工具，请将以下 XML 添加到 pom.xml 文件中。

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.18</version>
</dependency>

或者您可以从pdfbox.apache.org/download.cgi下载 pdfbox-2.0.18.jar 文件

第 1 步 - 创建空 PDF 文档

try(PDDocument document = new PDDocument()) {
			
} catch (IOException e) {
	e.printStackTrace();
}

第 2 步 - 将新的空白页面添加到 PDF 文档

PDPage page = new PDPage();
document.addPage(page);

第 3 步 - 将图像插入页面

例如，我们有一个位于 D:\SimpleSolution\simple_solution.png 的图像文件

PDPageContentStream pageContentStream = new PDPageContentStream(document, page);
PDImageXObject imageXObject = PDImageXObject.createFromFile("D:\\SimpleSolution\\simple_solution.png", document);
pageContentStream.drawImage(imageXObject, 100, 400);
pageContentStream.close();

第 4 步 - 保存 PDF 文档

document.save("D:\\SimpleSolution\\ImageDocument.pdf");

完整的应用程序源代码

package dev.simplesolution;

import java.io.IOException;

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

public class InsertImagePdfDocument {
	
	public static void main(String... args) {
		try(PDDocument document = new PDDocument()) {
			PDPage page = new PDPage();
			document.addPage(page);
			
			PDPageContentStream pageContentStream = new PDPageContentStream(document, page);
			PDImageXObject imageXObject = PDImageXObject.createFromFile("D:\\SimpleSolution\\simple_solution.png", document);
			pageContentStream.drawImage(imageXObject, 100, 400);
            pageContentStream.close();
			
			document.save("D:\\SimpleSolution\\ImageDocument.pdf");
		} catch (IOException e) {
			e.printStackTrace();
		}
		
	}

}

执行上面的应用程序，您将获得 ImageDocument.pdf 文件，如下所示。

使图像位于 PDF 页面的中心

要将图像插入 PDF 页面的中心，我们需要在根据图像大小绘制图像时计算 x 坐标和 y 坐标。例如，下面的 Java 代码将图像插入 PDF 页面的中心。

package dev.simplesolution;

import java.io.IOException;

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

public class InsertCenterImagePdfDocument {
	public static void main(String... args) {
		try(PDDocument document = new PDDocument()) {
			PDPage page = new PDPage();
			document.addPage(page);
			
			PDPageContentStream pageContentStream = new PDPageContentStream(document, page);
			PDRectangle mediaBox = page.getMediaBox();
			PDImageXObject imageXObject = PDImageXObject.createFromFile("D:\\SimpleSolution\\simple_solution.png", document);
			float startX = (mediaBox.getWidth() - imageXObject.getWidth()) / 2;
            float startY = (mediaBox.getHeight() - imageXObject.getHeight()) / 2;
            pageContentStream.drawImage(imageXObject, startX, startY);
            pageContentStream.close();
			
			document.save("D:\\SimpleSolution\\CenterImageDocument.pdf");
		} catch (IOException e) {
			e.printStackTrace();
		}
		
	}

}

执行上面的应用程序，您将得到如下所示的 CenterImageDocument.pdf 文件。 

下载源代码

本文中的源代码可以在以下位置找到：github.com/simplesolutiondev/ApachePDFBoxInsertImagePdfDocument

或下载：

下载源代码

快乐编码😊