Jak ładować prezentacje w Java

Aspose.Slides FOSS for Java lets you open any .pptx plik, sprawdź jego zawartość i albo zapisz go ponownie jako PPTX, albo wyodrębnij z niego dane. Ten przewodnik opisuje otwieranie pliku, iterowanie slajdów, odczytywanie tekstu kształtów oraz zapisywanie w trybie round‑tripping.

Przewodnik krok po kroku

Krok 1: Dodaj zależność Maven

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

Krok 2: Otwórz istniejącą prezentację

Przekaż ścieżkę do pliku do Presentation konstruktora. Użyj try-with-resources, aby zapewnić sprzątanie.

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);
}

Nieznane części XML w pliku źródłowym są zachowywane dosłownie: biblioteka nigdy nie usuwa treści, której jeszcze nie rozumie.

Krok 3: Przeglądaj slajdy

Iteruj po wszystkich slajdach i wypisz liczbę ich kształtów:

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");
    }
}

Krok 4: Odczytaj tekst kształtu

Iteruj po kształtach i odczytuj tekst z kształtów, które mają 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());
                }
            }
        }
    }
}

Krok 5: Odczytaj właściwości dokumentu

Uzyskaj dostęp do podstawowych właściwości dokumentu z 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());
}

Krok 6: Zapisz w trybie round‑trip

Po przeglądzie lub modyfikacji prezentacji zapisz ją ponownie jako PPTX:

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

Zapis pod inną ścieżką tworzy nowy plik. Zapis pod tą samą ścieżką nadpisuje oryginał.

Typowe problemy i rozwiązania

java.io.FileNotFoundException

Sprawdź, czy ścieżka do .pptx pliku jest poprawna względem katalogu roboczego. Użyj java.nio.file.Paths do solidnej konstrukcji ścieżki:

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

Biblioteka obsługuje .pptx (Office Open XML) tylko. Starsze .ppt (binarne pliki PowerPoint 97-2003) nie są obsługiwane.

Kształty nie mają metody getTextFrame()

Niektóre kształty (Connectors, PictureFrames, GroupShapes) nie mają ramki tekstowej. Sprawdź z instanceof IAutoShape przed rzutowaniem i dostępem do tekstu.

Najczęściej zadawane pytania

Czy wczytywanie zachowuje całą oryginalną zawartość?

Tak. Nieznane części XML są zachowywane dosłownie przy zapisie w trybie round‑trip. Biblioteka serializuje tylko te części modelu dokumentu, które rozumie, a pozostałe XML‑y przepuszcza dalej.

Czy mogę wczytać zabezpieczony hasłem plik PPTX?

Prezentacje zabezpieczone hasłem (zaszyfrowane) nie są obsługiwane w tej edycji.

Czy ładowanie z InputStream jest obsługiwane?

Tak. Ten Presentation konstruktor przyjmuje InputStream:

import java.io.FileInputStream;

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