Aspose.Slides FOSS
Java
איך לשמור מצגות בJava

איך לשמור מצגות בJava

Aspose.Slides FOSS for Java saves presentations exclusively to .pptx פורמט באמצעות prs.save(path, SaveFormat.PPTX). מדריך זה מכסה את תבנית השמירה הנכונה, שמירה לנתיב שונה, ושגיאות נפוצות הקשורות לשמירה.

מדריך שלב אחר שלב

שלב 1: הוסף את תלות Maven 

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

שלב 2: פתיחה או יצירת מצגת

תמיד השתמש ב‑try-with-resources. קריאת השמירה חייבת להתבצע בתוך בלוק ה‑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);
}

שלב 3: שמור לאחר כל השינויים

הציב את save() הקריאה כהצהרה האחרונה בתוך בלוק ה‑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;

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

שלב 4: שמור לנתיב שונה

העבר נתיב פלט שונה כדי ליצור קובץ חדש מבלי לשנות את המקורי:

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

ה template.pptx הקובץ אינו משתנה; customized.pptx נוצר (או נכתב מחדש אם הוא כבר קיים).

שלב 5: אמת את הפלט

לאחר יציאת בלוק ה‑try, הקובץ מושלם וסגור. בדוק שהוא קיים:

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");

פורמט שמירה נתמך

פורמטערך Enumנתמך
PPTX (Office Open XML)SaveFormat.PPTXכן
PDFN/Aלא
HTMLN/Aלא
SVGN/Aלא
PNG / JPEGN/Aלא
ODP (OpenDocument)N/Aלא

רק PPTX נתמך במלואו. העברת כל אחר SaveFormat ערך ל prs.save(path, format) שומר בשקט כ‑PPTX — לא נזרקת שום חריגה והפרמטר format מתעלם. UnsupportedOperationException נזרקת רק על‑ידי prs.save(ISaveOptions options), ולא על‑ידי העומסים המבוססים על פורמט.

בעיות נפוצות ותיקונים

java.io.IOException: Permission denied

קובץ הפלט פתוח ביישום אחר (למשל, PowerPoint מחזיק את הקובץ פתוח). סגור את הקובץ ביישומים אחרים לפני השמירה.

הקובץ נוצר אך נראה ריק או פגום

ודא prs.save() נקרא בתוך בלוק ה‑try, ולא אחרי זה. לאחר שבלוק ה‑try‑with‑resources מסתיים, ה‑ Presentation אובייקט מתבזבז והקריאות הבאות יכשלו.

UnsupportedOperationException בעת שמירה

זה קורה כאשר משתמשים ב‑ prs.save(ISaveOptions options) — ה‑ ISaveOptionsהעומס המבוסס על‑- אינו ממומש. שים לב: העברת קובץ שאינו PPTX SaveFormat ל‑ prs.save(path, format) עושה לא לזרוק את החריגה הזו; הוא שומר בשקט כ‑PPTX.

שאלות נפוצות

האם אני יכול לשמור לאותו קובץ שפתחת?

כן. שמירה לאותו הנתיב מחליפה את הקובץ המקורי:

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

האם ניתן לשמור ל‑OutputStream?

כן. ה‑ save() מתודה מקבלת OutputStream:

import java.io.FileOutputStream;

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

האם השמירה משמרת תוכן שלא שיניתי?

כן. חלקי XML לא ידועים מהקובץ המקורי נשמרים במדויק. הספרייה רק מסדרת את החלקים של מודל המסמך שהיא מבינה, ומעבירה הלאה כל XML שהיא אינה מזהה.

ראה גם

 עברית