Aspose.Slides FOSS
Java
如何在 Java 中保存演示文稿

如何在 Java 中保存演示文稿

Aspose.Slides FOSS for Java 将演示文稿仅保存为 .pptx 格式，使用 prs.save(path, SaveFormat.PPTX)。本指南涵盖正确的保存模式、保存到不同路径以及常见的保存相关错误。

分步指南

步骤 1：添加 Maven 依赖 

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

步骤 2：打开或创建演示文稿

始终使用 try-with-resources。save 调用必须在 try 块内部进行。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

// Create new
try (Presentation prs = new Presentation()) {
    prs.save("new.pptx", SaveFormat.PPTX);
}

// Open existing
try (Presentation prs = new Presentation("input.pptx")) {
    prs.save("output.pptx", SaveFormat.PPTX);
}

步骤 3：在所有修改后保存

将 save() 调用放在 try 块内部的最后一条语句，在所有修改完成后。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100
    );
    shape.addTextFrame("Hello, World!");
    prs.save("output.pptx", SaveFormat.PPTX);
}

步骤 4：保存到不同的路径

传递不同的输出路径以创建新文件，而不修改原始文件：

try (Presentation prs = new Presentation("template.pptx")) {
    // modify ...
    prs.save("customized.pptx", SaveFormat.PPTX);
}

template.pptx 文件未被修改；customized.pptx 被创建（如果已存在则会被覆盖）。

步骤 5：验证输出

在 try 块退出后，文件已完成并关闭。检查它是否存在：

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

Path output = Paths.get("output.pptx");
System.out.println("Saved: " + Files.exists(output)
    + ", size: " + Files.size(output) + " bytes");

支持的保存格式

FormatEnum ValueSupported
PPTX (Office Open XML)SaveFormat.PPTX是
PDFN/A否
HTMLN/A否
SVGN/A否
PNG / JPEGN/A否
ODP (OpenDocument)N/A否

仅完全支持 PPTX。将任何其他 SaveFormat 值传递给 prs.save(path, format) 时会静默保存为 PPTX — 不会抛出异常，且格式参数被忽略。UnsupportedOperationException 仅由 prs.save(ISaveOptions options) 抛出，而不是由基于格式的重载抛出。

常见问题及解决方案

java.io.IOException: Permission denied

输出文件已在其他应用程序中打开（例如，PowerPoint 已打开该文件）。在保存之前，请先关闭其他应用程序中的文件。

文件已创建但显示为空或已损坏

确保 prs.save() 在 try 块内部调用，而不是在其后。try-with-resources 块退出后，Presentation 对象已被释放，后续调用将失败。

UnsupportedOperationException 保存时

当使用 prs.save(ISaveOptions options) 时会出现此情况——基于 ISaveOptions 的重载未实现。注意：将非 PPTX SaveFormat 传递给 prs.save(path, format) 不会 抛出此异常；它会静默地保存为 PPTX。

常见问题

我可以保存到我打开的同一个文件吗？

是的。保存到相同路径会覆盖原始文件：

try (Presentation prs = new Presentation("deck.pptx")) {
    // modify ...
    prs.save("deck.pptx", SaveFormat.PPTX);  // overwrites original
}

我可以保存到 OutputStream 吗？

是的。save() 方法接受一个 OutputStream：

import java.io.FileOutputStream;

try (Presentation prs = new Presentation();
     FileOutputStream fos = new FileOutputStream("output.pptx")) {
    prs.save(fos, SaveFormat.PPTX);
}

保存是否会保留我未修改的内容？

是的。原始文件中的未知 XML 部分会原样保留。该库仅序列化其能够理解的文档模型部分，并会直接传递任何它不识别的 XML。

另请参阅

 中文