使用Java实现图片转PDF的方法及示例代码

介绍

在许多情况下，我们可能需要将多个图片文件转换为一个PDF文件，以便于存储、传输或打印。本文将介绍如何使用Java编程语言实现将图片文件转换为PDF文件的方法，并给出相应的示例代码。

准备工作

在开始编写代码之前，我们需要确保电脑上已经安装了Java开发环境（JDK）。如果没有安装，可以从Oracle的官方网站下载并安装最新版本的JDK。

另外，我们还需要一个用于图片转换的Java类库。在本文中，我们将使用一个名为PDFBox的类库，它是一个流行的开源Java类库，用于处理PDF文件。我们可以从PDFBox的官方网站下载并导入该类库。

实现步骤

步骤1：导入类库

在开始编写代码之前，我们需要在Java代码中导入需要使用的类库。在这个示例中，我们将导入PDFBox类库，以便于使用其中的方法。

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.LosslessFactory;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

步骤2：创建PDF文档

在将图片转换为PDF之前，我们需要创建一个空白的PDF文档对象。使用PDDocument类的newInstance()方法可以创建一个新的空白文档。

PDDocument document = PDDocument.newInstance();

步骤3：添加图片到PDF页面

接下来，我们需要将图片添加到PDF页面中。对于每个图片，我们需要创建一个新的PDF页面，并将图片添加到页面中。

首先，我们需要使用PDPage类的newInstance()方法创建一个新的页面，并将其添加到文档中。

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

然后，我们需要创建一个新的PDImageXObject对象，用于存储图片数据。使用PDImageXObject类的createFromByteArray()方法可以从图片文件中读取数据并创建一个新的对象。

PDImageXObject image = PDImageXObject.createFromByteArray(document, imageData, fileName);

其中，imageData是图片文件的字节数组，fileName是图片文件的名称。

接下来，我们需要通过PDPage对象的getContentStream()方法获取一个用于绘制图形的PDPageContentStream对象。

PDPageContentStream contentStream = new PDPageContentStream(document, page);

最后，我们可以使用PDPageContentStream对象的drawImage()方法将图片绘制到页面中。

contentStream.drawImage(image, x, y, width, height);

其中，x和y表示图片在页面上的位置，width和height表示图片的大小。

步骤4：保存PDF文档

在完成所有的图片添加操作之后，我们需要将PDF文档保存到磁盘上。使用PDDocument类的save()方法可以将文档保存到指定的文件路径。

document.save(outputFileName);

其中，outputFileName是保存的文件路径。

步骤5：关闭文档

最后，我们还需要确保在使用完毕后关闭文档，以释放资源。

document.close();

示例代码

下面是一个完整的示例代码，演示了如何使用Java将多个图片文件转换为一个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.LosslessFactory;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

import java.io.File;
import java.io.IOException;
import java.nio.file.Files;

public class ImageToPdfConverter {

    public static void main(String[] args) {
        try {
            // 创建一个空白PDF文档
            PDDocument document = PDDocument.newInstance();

            // 获取图片文件夹路径
            String imagesFolder = "./images";
            // 获取所有图片文件
            File[] imageFiles = new File(imagesFolder).listFiles();

            // 遍历图片文件
            for (File imageFile : imageFiles) {
                byte[] imageData = Files.readAllBytes(imageFile.toPath());
                String fileName = imageFile.getName();

                // 将图片添加到PDF页面
                addImageToPdf(document, imageData, fileName);
            }

            // 保存PDF文档
            String outputFileName = "./output.pdf";
            document.save(outputFileName);

            // 关闭文档
            document.close();

            System.out.println("图片转PDF成功：" + outputFileName);
        } catch (IOException e) {
            System.out.println("图片转PDF失败：" + e.getMessage());
        }
    }

    private static void addImageToPdf(PDDocument document, byte[] imageData, String fileName) throws IOException {
        // 创建一个新的页面
        PDPage page = PDPage.newInstance();

        // 将页面添加到文档
        document.addPage(page);

        // 创建一个包含图片的PDImageXObject对象
        PDImageXObject image = PDImageXObject.createFromByteArray(document, imageData, fileName);

        // 获取页面的大小
        PDRectangle pageSize = page.getMediaBox();

        // 计算图片的缩放比例，保持宽高比不变
        float scale = Math.min(pageSize.getWidth() / image.getWidth(), pageSize.getHeight() / image.getHeight());

        // 计算图片在页面上的位置
        float x = (pageSize.getWidth() - image.getWidth() * scale) / 2;
        float y = (pageSize.getHeight() - image.getHeight() * scale) / 2;

        // 获取绘制图形的PDPageContentStream对象
        PDPageContentStream contentStream = new PDPageContentStream(document, page);

        // 绘制图片
        contentStream.drawImage(image, x, y, image.getWidth() * scale, image.getHeight() * scale);

        // 关闭PDPageContentStream对象
        contentStream.close();
    }
}