Öppna presentationer i Java

Vad den här sidan handlar om

Lär dig hur du öppnar PowerPoint- och OpenDocument-presentationer i Java, anger öppningslösenord, styr resurshämtning och minskar minnesanvändning med Aspose.Slides för Java.

Introduktion

Aspose.Slides for Java kan ladda PowerPoint- och OpenDocument-presentationer från filer och strömmar. När en presentation har lästs in kan du inspektera dess struktur, redigera bilder, hantera resurser och spara den i originalformatet eller ett annat stödd format.

Inläsningsbeteendet kan anpassas via klassen LoadOptions. Till exempel kan du ange ett öppningslösenord, hålla stora binära objekt utanför Java-heap-minnet, kontrollera externa resurser eller utelämna inbäddade binära data.

Öppna presentationer

För att öppna en befintlig presentation, skicka dess filsökväg till konstruktorn Presentation. Disposera presentationen efter användning så att filhandtag, temporära data och andra resurser frigörs omedelbart.

Följande Java‑exempel visar hur man öppnar en presentation och får antalet bilder:

import com.aspose.slides.Presentation;

Presentation presentation = new Presentation("sample.pptx");
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Öppna lösenordsskyddade presentationer

Ett öppningslösenord krypterar presentationsinnehållet. För att läsa in hela presentationen, skicka rätt lösenord till LoadOptions.setPassword och ge alternativen till konstruktorn Presentation. Inläsning misslyckas när lösenordet saknas eller är felaktigt.

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;

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

Presentation presentation = new Presentation("encrypted-presentation.pptx", loadOptions);
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

För arbetsflöden för lösenorddetektering, validering och kryptering, se Password-Protect Presentations. Om en krypterad presentation avsiktligt sparats med offentliga dokumentegenskaper, kan dessa egenskaper läsas utan lösenord; se Manage Presentation Properties.

Öppna stora presentationer

LoadOptions.getBlobManagementOptions returnerar alternativ som styr hur Aspose.Slides hanterar stora binära objekt som bilder, ljud och video. Du kan hålla källfilen låst, tillåta temporära filer och begränsa mängden BLOB‑data som behålls i minnet.

Följande Java‑kod demonstrerar inläsning av en stor presentation (t.ex. 2 GB):

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.PresentationLockingBehavior;
import com.aspose.slides.SaveFormat;

final String filePath = "large-presentation.pptx";

LoadOptions loadOptions = new LoadOptions();
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024);

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    presentation.getSlides().get_Item(0).setName("Large presentation");
    presentation.save("large-presentation-copy.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obs

Med PresentationLockingBehavior.KeepLocked förblir källfilen låst tills presentation‑instansen har disposerats. Flytta, skriv över eller radera inte källfilen medan den instansen är aktiv.

Aspose.Slides kan kopiera innehållet i en inmatningsström vid inläsning. För stora presentationer är en filsökväg därför generellt mer effektiv än en ström. Se Manage BLOBs för ytterligare lagrings‑ och minneshanteringsalternativ.

Kontrollera externa resurser

LoadOptions.setResourceLoadingCallback accepterar en IResourceLoadingCallback‑implementation. Callback‑en kan leverera ersättningsdata, omdirigera en resurs, använda standardladdaren eller hoppa över resursen. Detta är användbart när presentationer innehåller externa bilder som måste lösas enligt applikationsspecifika säkerhets‑ eller lagringsregler.

import com.aspose.slides.IResourceLoadingArgs;
import com.aspose.slides.IResourceLoadingCallback;
import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.ResourceLoadingAction;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Locale;

class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        boolean isJpeg = args.getOriginalUri().toLowerCase(Locale.ROOT).endsWith(".jpg");
        Path approvedImagePath = Paths.get("approved-image.jpg");
        if (!isJpeg || !Files.exists(approvedImagePath)) {
            return ResourceLoadingAction.Skip;
        }

        try {
            byte[] imageData = Files.readAllBytes(approvedImagePath);
            args.setData(imageData);
            return ResourceLoadingAction.UserProvided;
        } catch (IOException exception) {
            System.err.println("The approved replacement image could not be read.");
            return ResourceLoadingAction.Skip;
        }
    }
}

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

Presentation presentation = new Presentation("presentation-with-external-images.pptx", loadOptions);
try {
    System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Läs in presentationer utan inbäddade binära objekt

En presentation kan innehålla inbäddade binära data som en applikation varken behöver eller vill behålla. Exempel inkluderar:

VBA‑projekt, tillgängliga via IPresentation.getVbaProject;
inbäddad OLE‑data, tillgänglig via IOleEmbeddedDataInfo.getEmbeddedFileData;
ActiveX‑kontrolldata, tillgänglig via IControl.getActiveXControlBinary.

Ställ in LoadOptions.setDeleteEmbeddedBinaryObjects till true för att ta bort dessa binära data vid inläsning. Spara den inlästa presentationen för att bevara det sanerade resultatet.

Detta alternativ minskar exponeringen för oönskade inbäddade payloads, men det är inte ett komplett malware‑detekterings‑ eller innehållssaneringssystem.

import com.aspose.slides.LoadOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

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

Presentation presentation = new Presentation("presentation-with-embedded-data.pptx", loadOptions);
try {
    presentation.save("presentation-without-embedded-data.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Hur kan jag avgöra att en fil är korrupt och inte kan öppnas?

Aspose.Slides kastar ett parse‑ eller formatfel vid inläsning. Hantera det felet separat från ett felaktigt‑lösenord‑fel så att applikationen kan rapportera orsaken korrekt.

Vad händer om nödvändiga typsnitt saknas?

Presentation kan fortfarande läsas in, men rendering och export kan ersätta typsnitt. Du kan konfigurera typsnittssubstitution eller tillhandahålla anpassade typsnitt för att göra resultatet mer förutsägbart.

Laddar inläsning av en presentation även dess inbäddade media?

Inbäddat ljud och video blir tillgängligt via presentationsobjektmodellen. Externa resurser löses upp enligt det konfigurerade resursladdningsbeteendet och kan vara otillgängliga om deras platser inte kan nås.

Skapa presentationer i Java Hämta och uppdatera presentationsinformation i Java