Cara Menyimpan Presentasi di Java

Aspose.Slides FOSS for Java saves presentations exclusively to .pptx format menggunakan prs.save(path, SaveFormat.PPTX). Panduan ini mencakup pola penyimpanan yang benar, menyimpan ke jalur yang berbeda, dan kesalahan umum terkait penyimpanan.

Panduan Langkah-demi-Langkah

Langkah 1: Tambahkan Dependensi Maven

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

Langkah 2: Buka atau Buat Presentasi

Selalu gunakan try-with-resources. Pemanggilan save harus terjadi di dalam blok try.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

// Create new
try (Presentation prs = new Presentation()) {
    prs.save("new.pptx", SaveFormat.PPTX);
}

// Open existing
try (Presentation prs = new Presentation("input.pptx")) {
    prs.save("output.pptx", SaveFormat.PPTX);
}

Langkah 3: Simpan Setelah Semua Modifikasi

Letakkan save() panggilan sebagai pernyataan terakhir di dalam blok try, setelah semua modifikasi selesai.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 300, 100
    );
    shape.addTextFrame("Hello, World!");
    prs.save("output.pptx", SaveFormat.PPTX);
}

Langkah 4: Simpan ke Jalur yang Berbeda

Berikan jalur output yang berbeda untuk membuat file baru tanpa mengubah yang asli:

try (Presentation prs = new Presentation("template.pptx")) {
    // modify ...
    prs.save("customized.pptx", SaveFormat.PPTX);
}

The template.pptx file tidak dimodifikasi; customized.pptx dibuat (atau ditimpa jika sudah ada).

Langkah 5: Verifikasi Output

Setelah blok try selesai, file sudah lengkap dan ditutup. Periksa apakah file tersebut ada:

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

Path output = Paths.get("output.pptx");
System.out.println("Saved: " + Files.exists(output)
    + ", size: " + Files.size(output) + " bytes");

Format Penyimpanan yang Didukung

Format	Nilai Enum	Didukung
PPTX (Office Open XML)	`SaveFormat.PPTX`	Ya
PDF	N/A	Tidak
HTML	N/A	Tidak
SVG	N/A	Tidak
PNG / JPEG	N/A	Tidak
ODP (OpenDocument)	N/A	Tidak

Hanya PPTX yang didukung sepenuhnya. Mengirimkan yang lain SaveFormat nilai ke prs.save(path, format) diam-diam menyimpan sebagai PPTX — tidak ada pengecualian yang dilemparkan dan argumen format diabaikan. UnsupportedOperationException hanya dilemparkan oleh prs.save(ISaveOptions options), bukan oleh overload berbasis format.

Masalah Umum dan Solusinya

java.io.IOException: Permission denied

File output terbuka di aplikasi lain (misalnya, PowerPoint memiliki file terbuka). Tutup file di aplikasi lain sebelum menyimpan.

File dibuat tetapi tampak kosong atau rusak

Pastikan prs.save() dipanggil di dalam blok try, bukan setelahnya. Setelah blok try-with-resources selesai, Presentation objek dibuang dan panggilan selanjutnya akan gagal.

UnsupportedOperationException saat menyimpan

Ini terjadi saat menggunakan prs.save(ISaveOptions options) — itu ISaveOptions-based overload tidak diimplementasikan. Catatan: mengirimkan non-PPTX SaveFormat ke prs.save(path, format) melakukan tidak lempar pengecualian ini; secara diam-diam menyimpan sebagai PPTX.

Pertanyaan yang Sering Diajukan

Apakah saya dapat menyimpan ke file yang sama yang saya buka?

Ya. Menyimpan ke jalur yang sama akan menimpa file asli:

try (Presentation prs = new Presentation("deck.pptx")) {
    // modify ...
    prs.save("deck.pptx", SaveFormat.PPTX);  // overwrites original
}

Apakah saya dapat menyimpan ke OutputStream?

Ya. The save() metode menerima sebuah OutputStream:

import java.io.FileOutputStream;

try (Presentation prs = new Presentation();
     FileOutputStream fos = new FileOutputStream("output.pptx")) {
    prs.save(fos, SaveFormat.PPTX);
}

Apakah penyimpanan mempertahankan konten yang belum saya ubah?

Ya. Bagian XML yang tidak dikenal dari file asli dipertahankan apa adanya. Perpustakaan hanya men-serialisasi bagian-bagian model dokumen yang dipahaminya, dan meneruskan semua XML yang tidak dikenalnya.