Aspose.Slides FOSS
Java
Как загружать презентации в Java

Как загружать презентации в Java

Aspose.Slides FOSS for Java позволяет открыть любой файл .pptx, просмотреть его содержимое и либо сохранить его обратно в PPTX, либо извлечь из него данные. Это руководство охватывает открытие файла, перебор слайдов, чтение текста фигур и сохранение с обратным преобразованием.

Пошаговое руководство

Шаг 1: Добавьте зависимость Maven 

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

Шаг 2: Открыть существующую презентацию

Передайте путь к файлу в конструктор Presentation. Используйте try‑with‑resources, чтобы обеспечить очистку.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("input.pptx")) {
    System.out.println("Slide count: " + prs.getSlides().size());
    prs.save("output.pptx", SaveFormat.PPTX);
}

Неизвестные XML‑части в исходном файле сохраняются дословно: библиотека никогда не удаляет содержимое, которое она ещё не понимает.

Шаг 3: Проверка слайдов

Итерировать по всем слайдам и вывести количество фигур:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (int i = 0; i < prs.getSlides().size(); i++) {
        ISlide slide = prs.getSlides().get(i);
        int shapeCount = slide.getShapes().size();
        System.out.println("Slide " + i + ": " + shapeCount + " shapes");
    }
}

Шаг 4: Чтение текста формы

Итерировать по фигурам и считывать текст из фигур, которые имеют TextFrame:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (ISlide slide : prs.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof IAutoShape) {
                IAutoShape autoShape = (IAutoShape) shape;
                ITextFrame tf = autoShape.getTextFrame();
                if (tf != null && !tf.getText().isEmpty()) {
                    System.out.println("  Shape text: " + tf.getText());
                }
            }
        }
    }
}

Шаг 5: Чтение свойств документа

Получить доступ к основным свойствам документа из prs.getDocumentProperties():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    IDocumentProperties props = prs.getDocumentProperties();
    System.out.println("Title:   " + props.getTitle());
    System.out.println("Author:  " + props.getAuthor());
    System.out.println("Subject: " + props.getSubject());
}

Шаг 6: Сохранение в обратном направлении

После проверки или изменения презентации сохраните её обратно в PPTX:

prs.save("output.pptx", SaveFormat.PPTX);

Сохранение в другой путь создаёт новый файл. Сохранение в тот же путь перезаписывает оригинал.

Общие проблемы и решения

java.io.FileNotFoundException

Проверьте, что путь к файлу .pptx правильный относительно рабочей директории. Используйте java.nio.file.Paths для надёжного построения пути:

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

Path path = Paths.get("assets", "deck.pptx");
try (Presentation prs = new Presentation(path.toString())) {
    // ...
}

Exception: File format is not supported

Библиотека поддерживает только .pptx (Office Open XML). Файлы устаревшего формата .ppt (binary PowerPoint 97-2003) не поддерживаются.

У объектов Shapes нет метода getTextFrame()

Некоторые фигуры (Connectors, PictureFrames, GroupShapes) не имеют текстового кадра. Проверьте instanceof IAutoShape перед приведением типов и доступом к тексту.

Часто задаваемые вопросы

Сохраняет ли загрузка весь оригинальный контент?

Да. Неизвестные части XML сохраняются дословно при сохранении в обратном проходе. Библиотека сериализует только те части модели документа, которые она понимает, и пропускает любой XML, который она не распознает.

Могу ли я загрузить PPTX, защищённый паролем?

Презентации, защищённые паролем (зашифрованные), не поддерживаются в этой версии.

Поддерживается ли загрузка из InputStream?

Да. Конструктор Presentation принимает InputStream:

import java.io.FileInputStream;

try (FileInputStream fis = new FileInputStream("deck.pptx");
     Presentation prs = new Presentation(fis)) {
    System.out.println("Slides: " + prs.getSlides().size());
}

См. также

 Русский