אנחנו שמחים להודיע על השחרור של GroupDocs.Conversion for Java v26.9. גרסה זו של ספטמבר 2026 מציגה ביטול שיתופי להמרת מסמכים, מוסיפה המרות בין פורמטים של זרמי דחיסה, ומספקת שם מודול Java יציב. היא גם מעדכנת את זוגות המרת הארכיונים המפורסמים, ולכן יישומים שבוחרים המרות באופן דינמי צריכים לבדוק את הזוגות הזמינים לפני השדרוג.

מה חדש במוצר זה

מפתחות .NET שלהלן מזהים תכונות שהועברו ל‑Java; הסיכומים מתארים את הפורמטים הנתמכים בגרסה זו של Java.

מפתח קטגוריה שינוי
CONVERSIONNET-6880 תכונה תמיכה בביטול שיתופי באמצעות אסימוני ביטול
CONVERSIONNET-7032 תכונה המרת Bzip2, Gzip, XZ, ו‑Unix Z ל‑LZMA
CONVERSIONNET-7019 תכונה המרת LZMA ל‑Bzip2 ו‑Gzip
CONVERSIONNET-7020 תכונה המרת Unix Z ל‑Bzip2 ו‑Gzip
CONVERSIONNET-7030 תכונה המרת Bzip2, Gzip, LZMA, ו‑Unix Z ל‑XZ
CONVERSIONNET-7029 תכונה המרת XZ ל‑Bzip2 ו‑Gzip
CONVERSIONNET-7028 תכונה המרת Gzip ל‑Bzip2
CONVERSIONNET-7021 תכונה המרת Bzip2 ל‑Gzip
CONVERSIONJAVA-3238 משימה פתרון ממצאי אימות חבילה ב‑groupdocs-conversion-26.7.jar

קובץ ה‑JAR של השחרור גם מצהיר על Automatic-Module-Name: com.groupdocs.conversion עבור יישומים המשתמשים במערכת המודולים של Java.

שינויים בממשק API ציבורי

ביטול שיתופי

שתי מחלקות חדשות, com.groupdocs.conversion.CancellationToken ו‑com.groupdocs.conversion.CancellationTokenSource, מאפשרות ליישום לבקש שהמרה תיפסק. כל השיטות הציבוריות Converter.convert(...) ו‑Converter.convertPageByPage(...) כוללות כעת עומסים עם פרמטר סופי CancellationToken. המבצע הפלאואנט של ההמרה מוסיף גם ConversionExecutor.convert(CancellationToken).

העומסים הקיימים נשארים זמינים ומשתמשים ב‑CancellationToken.NONE, כך שקוראות המרה קיימות אינן דורשות שינוי.

צור מקור אסימון והעבר את האסימון שלו להמרה:

import com.groupdocs.conversion.CancellationTokenSource;
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import java.util.concurrent.CancellationException;

CancellationTokenSource cancellationSource = new CancellationTokenSource();

try (Converter converter = new Converter("input.docx")) {
    // An application cancellation handler can call cancellationSource.cancel()
    // from another thread while this conversion runs.
    converter.convert(
        "converted.pdf",
        new PdfConvertOptions(),
        cancellationSource.getToken()
    );
} catch (CancellationException ex) {
    System.out.println("Conversion was cancelled.");
}

קרא cancellationSource.cancel() כאשר המשתמש מבטל משימה או שהיישום מחליט לעצור אותה. הביטול נבדק בין פעולות המרה: פעולה שכבר רצה תסתיים לפני שהביטול נצפה. לאחר מכן ההמרה זורקת java.util.concurrent.CancellationException.

פלט שכבר נכתב אינו מתבטל, ולכן יישומים צריכים להתמודד עם פלט חלקי בעת ביטול משימה. מקור שבוטל אינו ניתן לאיפוס; יש ליצור מקור חדש למשימה חדשה. העברת אסימון null תגרום ל‑NullPointerException.

המרות של זרמי דחיסה

גרסה 26.9 תומכת במקורות וביעדים של זרמי דחיסה הבאים, כולל המרה באותו פורמט:

כיוון פורמטים נתמכים
מקור Bzip2 (Bz2), Gzip (Gz ו‑Gzip), LZMA (Lzma), XZ (Xz), Unix Z (Z)
יעד Bzip2, Gzip, LZMA, XZ

Unix Z נתמך כמקור, אך אינו יעד בגרסה זו.

השתמש ב‑CompressionConvertOptions.setFormat(...) כדי לבחור את פורמט הפלט. לדוגמה, המרת זרם Gzip ל‑LZMA:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;

CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Lzma);

try (Converter converter = new Converter("input.gz")) {
    converter.convert("converted.lzma", options);
}

תאימות המרת ארכיונים

זוגות המרת הארכיונים המפורסמים מוגבלים כעת להמרות בתוך ZIP, 7z, TAR, ו‑CPIO. יישומים שהסתמכו על זוגות ארכיון‑ל‑זרם‑דחיסה שהיו מפורסמים קודם לכן צריכים לבדוק את ההמרות הזמינות לפני השדרוג. פורמטי המקור והיעד של זרמי הדחיסה המתוארים למעלה מתארים קבוצה נפרדת של המרות נתמכות.

שם מודול Java יציב

קובץ ה‑JAR של השחרור מצהיר על ערך המניפסט הבא:

Automatic-Module-Name: com.groupdocs.conversion

זה מספק ליישומים המשתמשים במערכת המודולים של Java שם מודול יציב. יישום מודולרי יכול להתייחס אליו ב‑module-info.java:

module example.conversion {
    requires com.groupdocs.conversion;
}

איך לקבל את העדכון

Maven

הוסף את מאגר GroupDocs ואת התלות 26.9 ל‑pom.xml שלך, או עדכן את הגרסה בתלות הקיימת:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <url>https://repository.groupdocs.com/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-conversion</artifactId>
        <version>26.9</version>
    </dependency>
</dependencies>

אתה יכול גם לעיין במאגר Maven של GroupDocs.Conversion for Java.

הורדה ישירה

הורד את חבילת Java מהדף GroupDocs.Conversion for Java releases.

משאבים