Jak načíst prezentace v Javě
Aspose.Slides FOSS for Java vám umožňuje otevřít libovolný soubor .pptx, prozkoumat jeho obsah a buď jej uložit zpět do PPTX, nebo z něj extrahovat data. Tento průvodce pokrývá otevření souboru, procházení snímků, čtení textu tvarů a zpětné uložení.
Průvodce krok za krokem
Krok 1: Přidejte Maven závislost
<dependency>
<groupId>org.aspose.slides.foss</groupId>
<artifactId>aspose-slides-foss</artifactId>
<version>1.0.0</version>
</dependency>Krok 2: Otevřít existující prezentaci
Předávejte cestu k souboru do konstruktoru Presentation. Použijte try-with-resources k zajištění úklidu.
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);
}Neznámé části XML ve zdrojovém souboru jsou zachovány doslovně: knihovna nikdy neodstraňuje obsah, který ještě nerozumí.
Krok 3: Prohlédněte snímky
Iterujte přes všechny snímky a vypište počet jejich tvarů:
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: Přečíst text tvaru
Iterujte přes tvary a načtěte text z tvarů, které 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: Načíst vlastnosti dokumentu
Přístup k základním vlastnostem 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: Uložení v režimu round‑trip
Po prohlédnutí nebo úpravě prezentace ji uložte zpět do PPTX:
prs.save("output.pptx", SaveFormat.PPTX);Ukládání do jiné cesty vytvoří nový soubor. Ukládání do stejné cesty přepíše původní.
Časté problémy a opravy
java.io.FileNotFoundException
Zkontrolujte, že cesta k souboru .pptx je správná vzhledem k pracovnímu adresáři. Použijte java.nio.file.Paths pro robustní konstrukci cesty:
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
Knihovna podporuje pouze .pptx (Office Open XML). Starší .ppt (binární PowerPoint 97-2003) soubory nejsou podporovány.
Tvary nemají metodu getTextFrame()
Některé tvary (Connectors, PictureFrames, GroupShapes) nemají textový rámec. Zkontrolujte pomocí instanceof IAutoShape před převodem a přístupem k textu.
Často kladené otázky
Zachovává načítání veškerý původní obsah?
Ano. Neznámé části XML jsou při uložení v režimu round‑trip zachovány doslovně. Knihovna serializuje pouze části modelu dokumentu, které rozumí, a propouští jakékoli XML, které nepozná.
Mohu načíst PPTX chráněný heslem?
Prezentace chráněné heslem (šifrované) nejsou v této edici podporovány.
Je načítání z InputStream podporováno?
Ano. Konstruktor Presentation přijímá InputStream:
import java.io.FileInputStream;
try (FileInputStream fis = new FileInputStream("deck.pptx");
Presentation prs = new Presentation(fis)) {
System.out.println("Slides: " + prs.getSlides().size());
}