Ouvrir des présentations en Java
Introduction
Aspose.Slides for Java peut charger des présentations PowerPoint et OpenDocument à partir de fichiers et de flux. Une fois la présentation chargée, vous pouvez inspecter sa structure, modifier les diapositives, gérer les ressources et l’enregistrer dans le format d’origine ou dans un autre format pris en charge.
Le comportement de chargement peut être personnalisé via la classe LoadOptions. Par exemple, vous pouvez fournir un mot‑de‑passe d’ouverture, conserver les gros objets binaires en dehors de la mémoire tampon Java, contrôler les ressources externes ou ignorer les données binaires intégrées.
Ouvrir des présentations
Après avoir chargé un fichier ou un flux, vous pouvez déterminer son format de présentation d’origine afin de choisir la façon dont votre application le traite.
Pour ouvrir une présentation existante, passez son chemin de fichier au constructeur Presentation. Libérez la présentation après utilisation afin que les poignées de fichier, les données temporaires et les autres ressources soient rapidement libérées.
L’exemple Java suivant montre comment ouvrir une présentation et obtenir le nombre de diapositives :
import com.aspose.slides.Presentation;
Presentation presentation = new Presentation("sample.pptx");
try {
System.out.println("Slide count: " + presentation.getSlides().size());
} finally {
presentation.dispose();
}
Ouvrir des présentations protégées par mot‑de‑passe
Un mot‑de‑passe d’ouverture chiffre le contenu de la présentation. Pour charger la présentation complète, transmettez le mot‑de‑passe correct à LoadOptions.setPassword et fournissez les options au constructeur Presentation. Le chargement échoue si le mot‑de‑passe est absent ou incorrect.
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();
}
Pour la détection, la validation et les flux de travail de chiffrement des mots‑de‑passe, consultez Password‑Protect Presentations. Si une présentation chiffrée a été enregistrée délibérément avec des propriétés de document publiques, ces propriétés peuvent être lues sans mot‑de‑passe ; voir Manage Presentation Properties.
Ouvrir de grandes présentations
LoadOptions.getBlobManagementOptions renvoie des options qui contrôlent la façon dont Aspose.Slides gère les gros objets binaires (BLOB) tels que les images, l’audio et la vidéo. Vous pouvez garder le fichier source verrouillé, autoriser les fichiers temporaires et limiter la quantité de données BLOB conservées en mémoire.
Le code Java suivant montre le chargement d’une grande présentation (par exemple, 2 Go) :
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();
}
Note
Avec PresentationLockingBehavior.KeepLocked, le fichier source reste verrouillé jusqu’à ce que l’instance de présentation soit libérée. Ne déplacez pas, n’écrasez pas et ne supprimez pas le fichier source tant que cette instance est vivante.
Aspose.Slides peut copier le contenu d’un flux d’entrée pendant le chargement. Pour les grandes présentations, un chemin de fichier est généralement plus efficace qu’un flux. Consultez Manage BLOBs pour des options supplémentaires de stockage et de gestion de la mémoire.
Contrôler les ressources externes
LoadOptions.setResourceLoadingCallback accepte une implémentation de IResourceLoadingCallback. Le rappel peut fournir des données de remplacement, rediriger une ressource, utiliser le chargeur par défaut ou ignorer la ressource. Cela est utile lorsqu’une présentation contient des images externes qui doivent être résolues selon les règles de sécurité ou de stockage propres à l’application.
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();
}
Charger des présentations sans objets binaires intégrés
Une présentation peut contenir des données binaires incorporées qu’une application n’a pas besoin ou ne veut pas conserver. Exemples :
- projets VBA, accessibles via IPresentation.getVbaProject;
- données OLE intégrées, accessibles via IOleEmbeddedDataInfo.getEmbeddedFileData;
- données de contrôle ActiveX, accessibles via IControl.getActiveXControlBinary.
Définissez LoadOptions.setDeleteEmbeddedBinaryObjects sur true pour supprimer ces données binaires lors du chargement. Enregistrez la présentation chargée pour conserver le résultat désinfecté.
Cette option réduit l’exposition à des charges utiles indésirables intégrées, mais elle ne constitue pas un système complet de détection de logiciels malveillants ou de désinfection de contenu.
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
Comment savoir si un fichier est corrompu et ne peut pas être ouvert ?
Aspose.Slides lève une exception d’analyse ou de format pendant le chargement. Gérez cet échec séparément de l’erreur de mot‑de‑passe incorrect afin que l’application puisse signaler la cause avec précision.
Que se passe-t-il si des polices requises sont manquantes ?
La présentation peut encore être chargée, mais le rendu et l’exportation peuvent substituer les polices. Vous pouvez configurer la substitution de polices ou fournir des polices personnalisées pour rendre la sortie plus prévisible.
Le chargement d’une présentation charge‑t‑il également ses médias intégrés ?
Les audio et vidéo intégrés deviennent accessibles via le modèle d’objet de la présentation. Les ressources externes sont résolues selon le comportement de chargement des ressources configuré et peuvent être indisponibles si leurs emplacements ne sont pas accessibles.