GroupDocs.Conversion for Java 26.9 – أبرز مميزات إصدار سبتمبر 2026

نحن سعداء بالإعلان عن إصدار GroupDocs.Conversion for Java v26.9. يقدم هذا الإصدار الصادر في سبتمبر 2026 إلغاءً تعاونيًا لتحويل المستندات، ويضيف تحويلات بين صيغ التدفقات المضغوطة، ويوفر اسم وحدة 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 الخاص بالإصدار عن إدخال البيان التالي في الـ manifest:

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>

يمكنك أيضًا تصفح GroupDocs.Conversion for Java Maven repository.

التحميل المباشر

حمّل حزمة Java من صفحة GroupDocs.Conversion for Java releases.

ما الجديد في هذا الإصدار#

تغييرات API العامة#

الإلغاء التعاوني#

تحويلات التدفقات المضغوطة#

توافق تحويل الأرشيف#

اسم وحدة Java ثابت#

كيفية الحصول على التحديث#

Maven#

التحميل المباشر#

الموارد#