אנחנו שמחים להודיע על השחרור של 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.