تحويل zip إلى html وتعيين عدد العناصر لكل صفحة باستخدام GroupDocs.Viewer Java

في العديد من تطبيقات الويب تحتاج إلى عرض محتويات أرشيف ZIP أو RAR مباشرةً في المتصفح. مع GroupDocs.Viewer for Java يمكنك تحويل zip إلى html في خطوة واحدة، التحكم في عدد مدخلات الأرشيف التي تظهر في كل صفحة، تضمين جميع الصور وCSS الداعمة، وحتى معالجة مجموعة من الأرشيفات دفعةً. يشرح هذا البرنامج التعليمي سير العمل الكامل، من إعداد Maven إلى العرض متعدد الصفحات، ويوضح لماذا كل إعداد مهم للأداء وسهولة الاستخدام.

تحويل الأرشيفات إلى HTML باستخدام GroupDocs.Viewer for Java

إجابات سريعة

  • ما الذي يتحكم فيه “set items per page”? يحدد عدد الملفات أو المجلدات من الأرشيف التي تظهر في كل صفحة HTML تم إنشاؤها.
  • هل يمكنني تضمين الصور وCSS مباشرةً في HTML؟ نعم – استخدم خيار forEmbeddedResources لتضمين الموارد في HTML.
  • هل التحويل الجماعي ممكن؟ بالطبع؛ يمكنك التكرار عبر مجموعة من الأرشيفات وعرض كل واحدة باستخدام نفس الإعدادات.
  • هل أحتاج إلى Maven لاستخدام GroupDocs.Viewer؟ نعم، أضف تبعية Maven groupdocs-viewer كما هو موضح أدناه.
  • ما صيغ الإخراج المدعومة؟ HTML بصفحة واحدة وHTML متعدد الصفحات كلاهما متاح، وتدعم المكتبة أكثر من 50 نوعًا من أنواع الأرشيفات المدخلة.

ما هو “set items per page” في GroupDocs.Viewer؟

إعداد set items per page يندرج تحت خيارات عرض الأرشيف. يخبر المشاهد بعدد مدخلات الأرشيف (ملفات أو مجلدات) التي يجب عرضها في كل صفحة HTML عند إنشاء مستند HTML متعدد الصفحات. تعديل هذه القيمة يساعدك على موازنة حجم الصفحة وسرعة التنقل، خاصةً للأرشيفات الكبيرة.

لماذا يتم تضمين الموارد في HTML؟

تضمين الموارد (الصور، CSS، الخطوط) مباشرةً داخل ملف HTML يخلق مستندًا واحدًا محمولًا يمكن فتحه دون ملفات خارجية. هذا مثالي لمرفقات البريد الإلكتروني، العرض دون اتصال، أو تضمين النتيجة في صفحات ويب أخرى. كما يبسط هذا النهج عملية النشر لأنه لا حاجة لإدارة مسارات أصول خارجية.

المتطلبات المسبقة

  • المكتبات المطلوبة: تضمين GroupDocs.Viewer الإصدار 25.2 أو أحدث.
  • البيئة: مجموعة تطوير جافا (JDK) مثبتة ومُكوَّنة.
  • المعرفة: جافا أساسية وإدارة تبعيات Maven.

إعداد Maven لـ GroupDocs Viewer

أضف مستودع GroupDocs وتبعية المشاهد إلى ملف pom.xml الخاص بك:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

الحصول على الترخيص

يقدم GroupDocs.Viewer رابط تجربة مجانية، ترخيصًا مؤقتًا، أو خيار شراء كامل. اختر ما يناسب جدول مشروعك الزمني.

التهيئة الأساسية

بعد إعداد Maven، أدخل المشاهد في الكود الخاص بك:

import com.groupdocs.viewer.Viewer;
// Your initialization code here

كيفية عرض الأرشيفات إلى HTML بصفحة واحدة

Viewer هو الفئة الأساسية التي تقوم بتحميل مستند أو أرشيف للعرض.

لإنشاء ملف HTML واحد يحتوي على الأرشيف بالكامل، أنشئ مثيل Viewer لملف ZIP واستخدم HtmlViewOptions.forEmbeddedResources() لتضمين جميع الصور وCSS والخطوط. عرض الأرشيف بهذه الخيارات ينتج صفحة واحدة متكاملة مناسبة للبريد الإلكتروني أو الاستخدام دون اتصال.

الخطوة 1: تحديد دليل الإخراج

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

الخطوة 2: تعيين اسم الملف لإخراج صفحة واحدة

Path pageFilePathFormat = outputDirectory.resolve("RAR_result.html");

الخطوة 3: تهيئة المشاهد

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Further configuration steps follow
}

الخطوة 4: تكوين خيارات العرض (تضمين الموارد في HTML)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

الخطوة 5: العرض كصفحة واحدة

options.setRenderToSinglePage(true);
viewer.view(options);

كيفية عرض الأرشيفات إلى HTML متعدد الصفحات وتعيين عدد العناصر لكل صفحة

HtmlViewOptions يكوّن كيفية عرض المشاهد لمخرجات HTML، بما في ذلك التقسيم إلى صفحات وتضمين الموارد.

لتقسيم أرشيف إلى صفحات متعددة، أنشئ HtmlViewOptions.forEmbeddedResources() وحدد حجم الصفحة المطلوب باستخدام options.setItemsPerPage(20). سيولد المشاهد ملفات HTML منفصلة، كل منها يعرض حتى عدد المدخلات المحدد، مما يحسن التنقل للأرشيفات الكبيرة ويضمن تحميلًا أسرع.

الخطوة 1: إعادة استخدام دليل الإخراج

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

الخطوة 2: تحديد تنسيق اسم الملف للصفحات المتعددة

Path pageFilePathFormat = outputDirectory.resolve("RAR_result_page_{0}.html");

الخطوة 3: تهيئة المشاهد مرة أخرى

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Continue with multi‑page configuration
}

الخطوة 4: تكوين خيارات متعددة الصفحات (تضمين الموارد في HTML)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

الخطوة 5: تعيين عدد العناصر لكل صفحة (الكلمة المفتاحية الأساسية في الإجراء)

options.getArchiveOptions().setItemsPerPage(10); // Default is 16
viewer.view(options);

تطبيقات عملية

  • أنظمة إدارة المستندات: أضف وظيفة معاينة الأرشيف دون تثبيت مشاهدات إضافية.
  • بوابات الويب: وفر للمستخدمين طريقة سريعة، بدون تحميل، لاستكشاف المستندات المجمعة.
  • أدوات التعاون: السماح للفرق بفحص الأرشيفات المشتركة مباشرةً في المتصفح.

اعتبارات الأداء

  • إدارة الموارد: حافظ على انخفاض استهلاك الذاكرة بمعالجة الأرشيفات عبر التدفقات؛ يمكن للمشاهد التعامل مع أرشيفات تصل إلى 500 ميغابايت دون تحميل الملف بالكامل في الذاكرة.
  • تحويل الأرشيفات دفعةً: تكرار عبر قائمة ملفات الأرشيف واستدعاء نفس منطق العرض لتعظيم الإنتاجية.
  • استراتيجية التخزين المؤقت: احفظ HTML المُعرض في ذاكرة مؤقتة إذا تم الوصول إلى نفس الأرشيف بشكل متكرر، مما يقلل وقت المعالجة المتكرر حتى 70 %.

الأسئلة المتكررة

س: ما هو GroupDocs.Viewer Java؟
ج: GroupDocs.Viewer Java هي مكتبة على الخادم تقوم بتحويل أكثر من 50 تنسيق مستند وأرشيف — بما في ذلك ZIP و RAR — إلى HTML أو PDF أو ملفات صور دون الحاجة إلى تطبيقات خارجية.

س: كيف يمكنني الحصول على نسخة تجريبية مجانية من GroupDocs.Viewer؟
ج: قم بزيارة رابط التجربة المجانية للتنزيل والاختبار.

س: هل يمكنني تحويل أنواع مستندات أخرى غير الأرشيفات؟
ج: نعم، يدعم المشاهد ملفات PDF، Word، Excel، PowerPoint، وأكثر من 35 تنسيقًا إضافيًا.

س: ماذا أفعل إذا كان العرض بطيئًا؟
ج: قلل عدد العناصر لكل صفحة، فعّل التدفق، أو عالج الأرشيفات على دفعات أصغر لتحسين السرعة.

س: أين يمكنني الحصول على المساعدة أو الدعم؟
ج: تواصل عبر منتدى الدعم.

س: هل من الممكن تضمين CSS والصور مباشرةً في HTML؟
ج: بالطبع—استخدم HtmlViewOptions.forEmbeddedResources كما هو موضح في الأمثلة.

س: كيف يمكنني تحويل مجلد من الأرشيفات دفعةً؟
ج: قم بالتكرار على كل ملف باستخدام حلقة for، مع تطبيق نفس تكوين Viewer و HtmlViewOptions لكل تكرار.

الموارد

آخر تحديث: 2026-08-03
تم الاختبار مع: GroupDocs.Viewer 25.2
المؤلف: GroupDocs

دروس ذات صلة