打开 Java 中的演示文稿

概述

除了从头创建 PowerPoint 演示文稿外，Aspose.Slides 还允许您打开现有的演示文稿。加载演示文稿后，您可以检索其信息，编辑幻灯片内容，添加新幻灯片，删除已有幻灯片，等等。

打开演示文稿

要打开现有演示文稿，请实例化 Presentation 类并将文件路径传递给其构造函数。

以下 Java 示例展示了如何打开演示文稿并获取其幻灯片数量：

// 实例化 Presentation 类并将文件路径传递给其构造函数。
Presentation presentation = new Presentation("Sample.pptx");
try {
    // 打印演示文稿中的幻灯片总数。
    System.out.println(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

打开受密码保护的演示文稿

当需要打开受密码保护的演示文稿时，请通过 LoadOptions 类的 setPassword 方法传入密码以解密并加载它。以下 Java 代码演示了此操作：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setPassword("YOUR_PASSWORD");

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
    // 对解密后的演示文稿执行操作。
} finally {
    presentation.dispose();
}

打开大型演示文稿

Aspose.Slides 提供了选项——尤其是 LoadOptions 类中的 getBlobManagementOptions 方法——帮助您加载大型演示文稿。

以下 Java 代码演示了加载大型演示文稿（例如 2 GB）：

final String filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions();
// 选择 KeepLocked 行为——演示文稿文件将在整个生命周期内保持锁定
// Presentation 实例，但无需将其加载到内存或复制到临时文件中。
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    // 大型演示文稿已加载并可使用，且内存消耗保持低水平。

    // 对演示文稿进行更改。
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // 将演示文稿保存到另一个文件。此操作期间内存消耗仍保持低。
    presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // 不要这样做！因为文件在演示稿对象释放之前被锁定，会抛出 I/O 异常。
    //Files.delete(Paths.get(filePath));
} finally {
    presentation.dispose();
}

// 这里可以执行此操作。源文件已不再被演示文稿对象锁定。
Files.delete(Paths.get(filePath));

Info

为了解决在使用流时的某些限制，Aspose.Slides 可能会复制流的内容。从流加载大型演示文稿会导致演示文稿被复制，从而减慢加载速度。因此，当需要加载大型演示文稿时，我们强烈建议使用演示文稿文件路径而不是流。

在创建包含大型对象（视频、音频、高分辨率图像等）的演示文稿时，您可以使用 BLOB management 来降低内存消耗。

控制外部资源

Aspose.Slides 提供了 IResourceLoadingCallback 接口，允许您管理外部资源。以下 Java 代码展示了如何使用 IResourceLoadingCallback 接口：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setResourceLoadingCallback(new ImageLoadingHandler());

Presentation presentation = new Presentation("Sample.pptx", loadOptions);

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // 加载替代图像。
                byte[] imageData = Files.readAllBytes(new File("aspose-logo.jpg").toPath());
                args.setData(imageData);
                return ResourceLoadingAction.UserProvided;
            } catch (RuntimeException ex) {
                return ResourceLoadingAction.Skip;
            }  catch (IOException ex) {
                ex.printStackTrace();
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // 设置替代 URL。
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction.Default;
        }
        // 跳过所有其他图像。
        return ResourceLoadingAction.Skip;
    }
}

加载不含嵌入二进制对象的演示文稿

PowerPoint 演示文稿可能包含以下类型的嵌入二进制对象：

VBA 项目（可通过 IPresentation.getVbaProject 访问）；
OLE 对象嵌入数据（可通过 IOleEmbeddedDataInfo.getEmbeddedFileData 访问）；
ActiveX 控件二进制数据（可通过 IControl.getActiveXControlBinary 访问）。

使用 ILoadOptions.setDeleteEmbeddedBinaryObjects 方法，您可以在不包含任何嵌入二进制对象的情况下加载演示文稿。

此方法有助于移除潜在的恶意二进制内容。以下 Java 代码演示了如何在没有任何嵌入二进制内容的情况下加载演示文稿：

LoadOptions loadOptions = new LoadOptions();
loadOptions.setDeleteEmbeddedBinaryObjects(true);

Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
    // 在演示文稿上执行操作。
} finally {
    presentation.dispose();
}

常见问题

如何判断文件已损坏且无法打开？

在加载期间会抛出解析/格式验证异常。此类错误通常会提到无效的 ZIP 结构或损坏的 PowerPoint 记录。

打开时如果缺少必需的字体会怎样？

文件仍会打开，但随后在渲染/导出时可能会替换字体。请在运行时环境中配置字体替换或添加所需字体。

打开时嵌入的媒体（视频/音频）怎么办？

它们将作为演示文稿资源可用。如果媒体通过外部路径引用，请确保这些路径在您的环境中可访问；否则在渲染/导出时可能会省略这些媒体。

使用 Java 创建 PowerPoint 演示文稿检查演示文稿