Java高效实现PPT转PDF的示例详解_Java

在日常工作中，我们常常需要将 ppt 或 pptx 文件转换为 pdf 格式，特别是在生成报表、归档文档或者共享演示文稿时。pdf 格式在排版、兼容性和稳定性方面具有优势，而传统的转换方式通常依赖于 microsoft powerpoint 或 libreoffice 等软件。但在自动化环境（如服务器、docker 容器或 linux 系统）中，这类方法往往面临安装依赖、兼容性问题等限制。因此，很多开发者更倾向于使用无依赖的 java 库来完成 ppt 到 pdf 的转换。

本文将介绍如何通过 spire.presentation for java 库，在不依赖 office 的环境下，实现 ppt/pptx 转 pdf，并支持批量转换与多种定制化设置。

一、安装 spire.presentation for java

在开始使用之前，需要安装 spire.presentation for java。你可以通过 maven 或者手动下载 jar 文件的方式来安装。

使用 maven 安装

在 pom.xml 文件中添加以下依赖：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependency>
    <groupid>e-iceblue</groupid>
    <artifactid>spire.presentation</artifactid>
    <version>10.11.4</version>
</dependency>

手动下载 jar 文件

你也可以从 spire.presentation 官方网站下载最新版本的 jar 文件，并将其添加到项目的 classpath 中。

二、java ppt 转 pdf 基本示例

spire.presentation for java 提供了简单易用的 api，可以在几行代码内完成 ppt 文件的转换。下面是一个基本的示例，展示如何将 ppt 或 pptx 文件转换为 pdf。

import com.spire.presentation.*;

public class ppttopdf {
    public static void main(string[] args) {
        // 创建演示文稿对象
        presentation presentation = new presentation();

        // 加载 pptx 文件
        presentation.loadfromfile("input.pptx");
        
        // 转换并保存为 pdf
        presentation.savetofile("output.pdf", fileformat.pdf);
        
        // 释放资源
        presentation.close();
    }
}

代码说明：

presentation()：创建一个演示文稿对象。
loadfromfile("input.pptx")：加载指定路径的 ppt 或 pptx 文件。
savetofile("output.pdf", fileformat.pdf)：将演示文稿保存为 pdf 格式。
close()：关闭演示文稿，释放资源。

三、批量转换 ppt 文件为 pdf

当有多个 ppt 文件需要转换时，可以将它们放入一个文件夹，并通过遍历文件夹批量转换文件。以下是一个实现批量转换的代码示例：

import java.io.file;
import com.spire.presentation.*;

public class batchconvertppttopdf {
    public static void main(string[] args) {
        string inputdir = "ppt_files";
        string outputdir = "pdf_files";

        file folder = new file(inputdir);
        file[] listoffiles = folder.listfiles();

        // 创建目标文件夹
        new file(outputdir).mkdirs();

        // 遍历目录中的文件
        for (file file : listoffiles) {
            if (file.isfile() && (file.getname().endswith(".ppt") || file.getname().endswith(".pptx"))) {
                try {
                    // 加载并转换文件
                    presentation presentation = new presentation();
                    presentation.loadfromfile(file.getabsolutepath());

                    // 设置输出文件路径
                    string pdfpath = outputdir + "/" + file.getname().replaceall("\.(ppt|pptx)", ".pdf");
                    presentation.savetofile(pdfpath, fileformat.pdf);
                    presentation.close();
                    system.out.println("成功转换: " + file.getname() + " → " + pdfpath);
                } catch (exception e) {
                    system.err.println("转换失败: " + file.getname() + ", 错误信息: " + e.getmessage());
                }
            }
        }
    }
}

代码说明：

file[] listoffiles = folder.listfiles()：获取文件夹中的所有文件。
file.getname().endswith(".ppt") || file.getname().endswith(".pptx")：只处理 ppt 或 pptx 文件。
presentation.loadfromfile(file.getabsolutepath())：加载每个文件并进行转换。
presentation.savetofile(pdfpath, fileformat.pdf)：保存为 pdf 格式。

四、转换设置与优化

在不同的应用场景中，生成的 pdf 可能需要不同的设置，例如文件大小优化、内容排版、pdf/a 合规性等。spire.presentation for java 提供了多种可调节的设置，满足不同需求。

1. 设置幻灯片尺寸

根据打印或文档格式要求，可以调整幻灯片的尺寸，以确保 pdf 输出符合预期。以下是设置幻灯片为 a4 尺寸的代码示例：

import com.spire.presentation.*;

public class adjustslidesizeforpdf {
    public static void main(string[] args) {
        // 创建演示文稿对象
        presentation presentation = new presentation();

        // 加载 pptx 文件
        presentation.loadfromfile("input.pptx");

        // 设置幻灯片尺寸为标准 a4
        presentation.getslidesize().settype(slidesizetype.a4);

        // 自动调整内容以适应新尺寸
        presentation.setslidesizeautofit(true);

        // 保存为 pdf
        presentation.savetofile("resized_output.pdf", fileformat.pdf);
        
        // 释放资源
        presentation.close();
    }
}

2. 包含隐藏幻灯片

默认情况下，隐藏的幻灯片不会被转换为 pdf。如果需要将隐藏幻灯片也包含在内，可以启用相应选项：

import com.spire.presentation.*;

public class includehiddenslidesinpdf {
    public static void main(string[] args) {
        // 创建演示文稿对象
        presentation presentation = new presentation();

        // 加载 pptx 文件
        presentation.loadfromfile("input.pptx");

        // 获取保存设置对象
        savetopdfoption option = presentation.getsavetopdfoption();

        // 启用包含隐藏幻灯片选项
        option.setcontainhiddenslides(true);

        // 保存为 pdf
        presentation.savetofile("include_hidden_slides.pdf", fileformat.pdf);
        
        // 释放资源
        presentation.close();
    }
}

3. 生成 pdf/a 合规文件

对于需要归档保存的文件，可以生成符合 pdf/a 标准的 pdf 文件：

import com.spire.presentation.*;

public class generatepdfacompliance {
    public static void main(string[] args) {
        // 创建演示文稿对象
        presentation presentation = new presentation();

        // 加载 pptx 文件
        presentation.loadfromfile("input.pptx");

        // 获取保存设置对象
        savetopdfoption option = presentation.getsavetopdfoption();

        // 设置 pdf 合规性为 pdf/a-1a
        option.setpdfconformancelevel(pdfconformancelevel.pdf_a1a);

        // 保存为 pdf
        presentation.savetofile("pdf_a_output.pdf", fileformat.pdf);
        
        // 释放资源
        presentation.close();
    }
}

五、异常处理

在批量转换 ppt 文件时，可能会遇到各种异常情况。可以使用 try...catch 语句来捕获并处理这些异常，确保程序稳定运行：

import java.io.file;
import com.spire.presentation.*;

public class safeconvertppttopdf {
    public static void main(string[] args) {
        string inputdir = "ppt_files";
        string outputdir = "pdf_files";

        file folder = new file(inputdir);
        file[] listoffiles = folder.listfiles();

        // 创建目标文件夹
        new file(outputdir).mkdirs();

        // 遍历目录中的文件
        for (file file : listoffiles) {
            if (file.isfile() && (file.getname().endswith(".ppt") || file.getname().endswith(".pptx"))) {
                try {
                    // 加载并转换文件
                    presentation presentation = new presentation();
                    presentation.loadfromfile(file.getabsolutepath());

                    // 设置输出文件路径
                    string pdfpath = outputdir + "/" + file.getname().replaceall("\.(ppt|pptx)", ".pdf");
                    presentation.savetofile(pdfpath, fileformat.pdf);
                    presentation.close();
                    system.out.println("成功转换: " + file.getname() + " → " + pdfpath);
                } catch (exception e) {
                    system.err.println("转换失败: " + file.getname() + ", 错误信息: " + e.getmessage());
                }
            }
        }
    }
}