如何在 Java 中将 PNG 转换为 PDF（教程）

本文将使用 IronPDF for Java 库以编程方式从图像文件格式创建 PDF 文档。

IronPDF - 一个Java库

Iron Software 工程师现已开发 IronPDF Library for Java，帮助 Java 开发人员创建新文档、编辑、编写、调整大小和操作 PDF 文档。 IronPDF 允许处理 PDF 文件或 PDF 转换的各个方面。 它为开发人员提供了在 Java 中创建和自定义 PDF 的各种功能。 它还帮助控制PDF的布局和格式。

IronPDF for Java 基于 .NET Framework 的功能而构建，与其他开源库相比，是处理 PDF 的多功能工具。 除了创建和操作PDF，它主要帮助将图像和HTML文件转换为PDF及其他文件格式。

在 Java 中将 PNG 转换为 PDF 的步骤

先决条件

要创建将 PNG 转换为 PDF 的应用程序，您需要下载并安装以下先决条件：

1. Java开发工具包（JDK）： 您的计算机上必须安装最新版本的JDK，才能编译和运行将PNG转换为PDF的应用程序。 可以从Oracle网站下载JDK。

2. Maven: 需要安装 Maven，因为它是主要用于 Java 项目的构建自动化工具。 Maven可以从Apache Maven网站下载。

3. IronPDF Java 库：现在，您需要将最新版本的 IronPDF 添加为 PNG 到 PDF 转换项目的依赖项。 将以下 IronPDF 依赖项添加到项目的pom.xml文件中：

   <dependency>
      <groupId>com.ironsoftware</groupId>
      <artifactId>com.ironsoftware</artifactId>
      <version>2025.3.6</version>
   </dependency>

   XML
4. 您还需要在pom.xml文件中添加Slf4j依赖。

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.5</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.5</version>
    </dependency>

一旦下载并安装了所有前提条件，就可以在Java应用程序中使用该项目将PNG图片转换为PDF文档。

在 Java 主文件中添加导入

首先，在 Java 应用程序中使用 IronPDF 将 PNG 图像转换为 PDF 文件需要以下导入。

import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

添加导入内容后，就可以进行图像到 PDF 的转换了。

将单个 PNG 转换为 PDF 文件

IronPdf 可帮助开发人员通过几个简单的步骤将单张 PNG 或 JPG 图像转换为 PDF 文件。 Java 代码片段如下所示：

// Reference to the image that we want to convert
List<Path> paths = new ArrayList<>();
paths.add(Paths.get("example.png"));

// Save the image into a new PDF document.
PdfDocument.fromImage(paths).saveAs(Paths.get("example.pdf"));

// Reference to the image that we want to convert
List<Path> paths = new ArrayList<>();
paths.add(Paths.get("example.png"));

// Save the image into a new PDF document.
PdfDocument.fromImage(paths).saveAs(Paths.get("example.pdf"));

在此，您首先需要获取要转换为 PDF 的图像文件的路径。 然后，您将该图像路径添加到一个List中，并调用fromImage方法。 最后，调用saveAs方法将转换后的PNG文件保存到文件系统。

将多个 PNG 转换为 PDF 文件

IronPDF 还允许开发人员将多个 PNG 或 JPG 图像合并到一个 PDF 文档中，如以下代码示例所示。

// Reference to the directory containing the images that we desire to convert
Path imageDirectory = Paths.get("assets/images");

// Create an empty List to contain Paths to images from the directory.
List<Path> imageFiles = new ArrayList<>();

// Use a DirectoryStream to populate the List with paths for each image in the directory
try (DirectoryStream<Path> stream = Files.newDirectoryStream(imageDirectory, "*.{png, jpg, gif}")) {
    for (Path entry : stream) {
        imageFiles.add(entry);
    }

    // Render all targeted images as PDF content and save them together in one PDF document.
    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("multiple_images.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

// Reference to the directory containing the images that we desire to convert
Path imageDirectory = Paths.get("assets/images");

// Create an empty List to contain Paths to images from the directory.
List<Path> imageFiles = new ArrayList<>();

// Use a DirectoryStream to populate the List with paths for each image in the directory
try (DirectoryStream<Path> stream = Files.newDirectoryStream(imageDirectory, "*.{png, jpg, gif}")) {
    for (Path entry : stream) {
        imageFiles.add(entry);
    }

    // Render all targeted images as PDF content and save them together in one PDF document.
    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("multiple_images.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

上面代码中的fromImage方法也可以接受一组PNG图像路径对象。 每个路径对象都引用了本地存储的图像的有效路径。 在这种情况下，图像来自同一目录，因此迅速使用java.nio.file类中的DirectoryStream来构建目录中包含的所有图像的列表。

现在，fromImage 方法将列表中的每个 PNG 或 JPG 图像渲染在 PDF 文档的单独页面上。 最后，使用 saveAs 方法将转换后的图像保存到 multiple_images.pdf 输出。

使用上述任何代码示例运行项目后，输出将以 PDF 文件格式生成。 此处显示的是 "将 PNG 转换为 PDF "多个图像的输出结果。

PNG 转换为 PDF 输出

您可以查看更多关于使用 IronPDF 的图像转换代码示例，并从IronPDF 官方网站下载 IronPDF for Java。

IronPDF for Java

IronPdf 可高质量地呈现所有图像和文本，且不会丢失任何格式。 PDF中的表单组件在转换后的PDF文件中也是可编辑的。

摘要

本文演示了如何使用 IronPDF 的图像转换为 PDF 功能生成 PDF。 总之，IronPDF 是为 Java 开发人员开发的一个功能强大的库，可用于处理 PDF 文件格式。 它允许开发人员轻松从多个图像创建PDF文档。 它还支持将 XML 文档翻译成 PDF 以及 HTML 和图像文件。 IronPDF 是一个优秀的 PDF API，帮助软件工程师从 PDF 文件中提取和写入内容。

IronPDF for Java 可以免费使用，但用于部署目的时，商业许可证起价为 $liteLicense。 您还可以访问 IronPDF完整版的免费试用版，以在生产模式下测试其功能。