Cara Menyimpan Presentasi di Java

Aspose.Slides FOSS for Java menyimpan presentasi secara eksklusif ke format .pptx menggunakan prs.save(path, SaveFormat.PPTX). Panduan ini mencakup pola penyimpanan yang benar, penyimpanan 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. Panggilan 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 pemanggilan save() 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);
}

Step 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);
}

File template.pptx 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 nilai SaveFormat lain ke prs.save(path, format) secara 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 Solusi

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, objek Presentation dibuang dan panggilan selanjutnya akan gagal.

UnsupportedOperationException saat menyimpan

Ini terjadi saat menggunakan prs.save(ISaveOptions options) — overload berbasis ISaveOptions belum diimplementasikan. Catatan: mengirim SaveFormat non-PPTX ke prs.save(path, format) tidak melempar pengecualian ini; secara diam-diam menyimpan sebagai PPTX.

Pertanyaan yang Sering Diajukan

Bisakah saya 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
}

Bisakah saya menyimpan ke OutputStream?

Ya. Metode save() 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 secara verbatim. Perpustakaan hanya men‑serialisasi bagian‑bagian model dokumen yang dipahaminya, dan meneruskan setiap XML yang tidak dikenalnya.