首页 / 新闻资讯 / 使用PDFBox将图片转换为PDF：Java开发者指南

使用PDFBox将图片转换为PDF：Java开发者指南

发布时间：2026-06-22 作者：汪刚 阅读量：9

引言

在数字文档处理中，将图片转换为PDF是一种常见需求，例如创建扫描文档、电子相册或报告附件。PDFBox作为Apache开源的Java库，提供了强大的PDF操作功能，无需依赖Adobe Acrobat即可实现高质量转换。

环境准备

首先，在项目中集成PDFBox依赖。如果使用Maven，可在pom.xml中添加：

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

确保项目使用Java 8或更高版本。

基础转换：单张图片转PDF

以下代码示例展示如何将一张PNG图片转换为PDF：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.common.PDRectangle;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;
import java.io.File;
import java.io.IOException;

public class ImageToPdf {
    public static void main(String[] args) throws IOException {
        PDDocument document = new PDDocument();
        PDPage page = new PDPage(PDRectangle.A4); // 设置A4页面尺寸
        document.addPage(page);
        
        // 加载图片并定义在页面中的位置
        PDImageXObject image = PDImageXObject.createFromFile("input.png", document);
        float scale = 1f; // 缩放比例
        page.getResources().addXObject(image, "img");
        
        // 绘制图片到页面
        PDPageContentStream contentStream = new PDPageContentStream(document, page);
        contentStream.drawImage(image, 0, 0, image.getWidth() * scale, image.getHeight() * scale);
        contentStream.close();
        
        document.save("output.pdf");
        document.close();
    }
}

关键点：使用PDRectangle定义页面大小，通过PDImageXObject加载图片，再利用PDPageContentStream绘制到页面。

批量处理：多张图片合并为单个PDF

实际应用中常需将多张图片合并。可通过循环遍历文件列表，为每张图片创建新页面：

File folder = new File("images/");
File[] listOfFiles = folder.listFiles();

for (File file : listOfFiles) {
    if (file.isFile() && file.getName().toLowerCase().endsWith(".png")) {
        PDImageXObject pdImage = PDImageXObject.createFromFile(file.getAbsolutePath(), document);
        PDPage page = new PDPage(new PDRectangle(pdImage.getWidth(), pdImage.getHeight()));
        document.addPage(page);
        
        PDPageContentStream contentStream = new PDPageContentStream(document, page);
        contentStream.drawImage(pdImage, 0, 0);
        contentStream.close();
    }
}

建议：根据图片尺寸动态调整页面大小，或统一转换为标准页面（如A4）并居中显示。

高级优化技巧

  • 图片压缩：使用PDImageXObject.createFromFileByContent或预处理图片以减少PDF文件大小。
  • 页面旋转：通过page.setRotation(90)调整横向图片方向。
  • 元数据添加：设置PDF文档标题、作者等属性，提升可读性。
  • 异常处理：捕获IOException并处理文件读写错误，确保程序健壮性。

常见问题与解决方案

问题1：图片显示模糊
解决方案：确保使用高分辨率原图，并在绘制时避免过度缩放。可参考image.getWidth() * scale的scale值设为1。

问题2：PDF文件过大
解决方案：降低图片DPI（如从300降至150），或使用PDFBox的压缩选项。

问题3：中文文件名乱码
解决方案：在读取文件路径时使用UTF-8编码，例如new File(URLEncoder.encode(path, "UTF-8"))。

总结

利用PDFBox库，开发者可以灵活、高效地将图片转换为PDF，适用于各种自动化文档处理场景。通过上述代码和优化方法，您可以轻松实现从简单单张转换到复杂批量处理的需求。建议在实际项目中结合具体业务逻辑调整参数，并参考官方文档深入探索更多功能。

相关文章