Abrir presentaciones en Java

Visión general

Más allá de crear presentaciones de PowerPoint desde cero, Aspose.Slides también le permite abrir presentaciones existentes. Después de cargar una presentación, puede obtener información sobre ella, editar el contenido de las diapositivas, agregar nuevas diapositivas, eliminar las existentes y mucho más.

Abrir presentaciones

Para abrir una presentación existente, instancie la clase Presentation y pase la ruta del archivo a su constructor.

El siguiente ejemplo en Java muestra cómo abrir una presentación y obtener el número de diapositivas:

// Instanciar la clase Presentation y pasar una ruta de archivo a su constructor.
Presentation presentation = new Presentation("Sample.pptx");
try {
    // Imprimir el número total de diapositivas en la presentación.
    System.out.println(presentation.getSlides().size());
} finally {
    presentation.dispose();
}

Abrir presentaciones protegidas con contraseña

Cuando necesite abrir una presentación protegida con contraseña, pase la contraseña mediante el método setPassword de la clase LoadOptions para descifrarla y cargarla. El siguiente código Java demuestra esta operación:

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

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
try {
    // Realizar operaciones en la presentación descifrada.
} finally {
    presentation.dispose();
}

Abrir presentaciones grandes

Aspose.Slides ofrece opciones—en particular el método getBlobManagementOptions en la clase LoadOptions—para ayudarle a cargar presentaciones de gran tamaño.

El siguiente código Java muestra cómo cargar una presentación grande (por ejemplo, 2 GB):

final String filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions();
// Elija el comportamiento KeepLocked—el archivo de la presentación permanecerá bloqueado durante la vida útil de
// la instancia Presentation, pero no es necesario cargarlo en memoria ni copiarlo a un archivo temporal.
loadOptions.getBlobManagementOptions().setPresentationLockingBehavior(PresentationLockingBehavior.KeepLocked);
loadOptions.getBlobManagementOptions().setTemporaryFilesAllowed(true);
loadOptions.getBlobManagementOptions().setMaxBlobsBytesInMemory(10 * 1024 * 1024); // 10 MB

Presentation presentation = new Presentation(filePath, loadOptions);
try {
    // La gran presentación se ha cargado y puede utilizarse, mientras el consumo de memoria se mantiene bajo.

    // Realice cambios en la presentación.
    presentation.getSlides().get_Item(0).setName("Large presentation");

    // Guarde la presentación en otro archivo. El consumo de memoria sigue bajo durante esta operación.
    presentation.save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // ¡No haga esto! Se lanzará una excepción de E/S porque el archivo está bloqueado hasta que se elimine el objeto Presentation.
    //Files.delete(Paths.get(filePath));
} finally {
    presentation.dispose();
}

// Está bien hacerlo aquí. El archivo fuente ya no está bloqueado por el objeto Presentation.
Files.delete(Paths.get(filePath));

Controlar recursos externos

Aspose.Slides proporciona la interfaz IResourceLoadingCallback que le permite gestionar recursos externos. El siguiente código Java muestra cómo usar la interfaz IResourceLoadingCallback:

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

Presentation presentation = new Presentation("Sample.pptx", loadOptions);
class ImageLoadingHandler implements IResourceLoadingCallback {
    public int resourceLoading(IResourceLoadingArgs args) {
        if (args.getOriginalUri().endsWith(".jpg")) {
            try {
                // Cargar una imagen de sustitución.
                byte[] imageData = Files.readAllBytes(new File("aspose-logo.jpg").toPath());
                args.setData(imageData);
                return ResourceLoadingAction.UserProvided;
            } catch (RuntimeException ex) {
                return ResourceLoadingAction.Skip;
            }  catch (IOException ex) {
                ex.printStackTrace();
            }
        } else if (args.getOriginalUri().endsWith(".png")) {
            // Establecer una URL de sustitución.
            args.setUri("http://www.google.com/images/logos/ps_logo2.png");
            return ResourceLoadingAction.Default;
        }
        // Omitir todas las demás imágenes.
        return ResourceLoadingAction.Skip;
    }
}

Cargar presentaciones sin objetos binarios incrustados

Una presentación de PowerPoint puede contener los siguientes tipos de objetos binarios incrustados:

Usando el método ILoadOptions.setDeleteEmbeddedBinaryObjects puede cargar una presentación sin ningún objeto binario incrustado.

Este método es útil para eliminar contenido binario potencialmente malicioso. El siguiente código Java demuestra cómo cargar una presentación sin contenido binario incrustado:

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

Presentation presentation = new Presentation("malware.ppt", loadOptions);
try {
    // Realizar operaciones en la presentación.
} finally {
    presentation.dispose();
}

Preguntas frecuentes

¿Cómo puedo saber que un archivo está corrupto y no se puede abrir?

Obtendrá una excepción de validación de análisis/formato durante la carga. Estos errores a menudo mencionan una estructura ZIP no válida o registros de PowerPoint dañados.

¿Qué ocurre si faltan fuentes requeridas al abrir?

El archivo se abrirá, pero posteriormente el rendering/export puede sustituir fuentes. Configure font substitutions o add the required fonts al entorno de ejecución.

¿Qué sucede con los medios incrustados (video/audio) al abrir?

Se convierten en recursos de la presentación. Si los medios se referencian mediante rutas externas, asegúrese de que esas rutas sean accesibles en su entorno; de lo contrario, el rendering/export puede omitir los medios.