Преобразование zip в html и установка количества элементов на страницу с GroupDocs.Viewer Java

Во многих веб‑приложениях необходимо отображать содержимое ZIP или RAR‑архива непосредственно в браузере. С GroupDocs.Viewer for Java вы можете convert zip to html за один шаг, контролировать, сколько записей архива появляется на каждой странице, встраивать все поддерживаемые изображения и CSS, а также пакетно обрабатывать десятки архивов. Этот учебник проведёт вас через весь процесс, от настройки Maven до многостраничного рендеринга, и объяснит, почему каждая настройка важна для производительности и удобства использования.

Преобразование архивов в HTML с помощью GroupDocs.Viewer for Java

Быстрые ответы

  • Что контролирует «set items per page»? Он определяет, сколько файлов или папок из архива будет отображаться на каждой сгенерированной HTML‑странице.
  • Могу ли я встраивать изображения и CSS напрямую в HTML? Да — используйте параметр forEmbeddedResources для встраивания ресурсов в HTML.
  • Возможна ли пакетная конверсия? Абсолютно; вы можете перебрать коллекцию архивов и отрендерить каждый с одинаковыми настройками.
  • Нужен ли Maven для использования GroupDocs.Viewer? Да, добавьте зависимость groupdocs-viewer Maven, как показано ниже.
  • Какие форматы вывода поддерживаются? Доступны одностраничный HTML и многостраничный HTML, библиотека поддерживает более 50 типов входных архивов.

Что означает «set items per page» в GroupDocs.Viewer?

Настройка set items per page относится к параметрам рендеринга архива. Она указывает Viewer, сколько записей архива (файлов или папок) должно отображаться на каждой HTML‑странице при генерации многостраничного HTML‑документа. Регулирование этого значения помогает сбалансировать размер страницы и скорость навигации, особенно для больших архивов.

Почему встраивать ресурсы html?

Встраивание ресурсов (изображений, CSS, шрифтов) непосредственно в HTML‑файл создаёт единый переносимый документ, который можно открыть без внешних файлов. Это удобно для вложений в электронную почту, офлайн‑просмотра или встраивания результата в другие веб‑страницы. Такой подход также упрощает развертывание, поскольку не требуется управлять внешними путями к ресурсам.

Предпосылки

  • Required libraries: Включите GroupDocs.Viewer версии 25.2 или новее.
  • Environment: Установлен и настроен Java Development Kit (JDK).
  • Knowledge: Базовые знания Java и управления зависимостями Maven.

Настройка Maven для GroupDocs Viewer

Add the GroupDocs repository and the viewer dependency to your 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 предлагает free trial link, временную лицензию или полную покупку. Выберите вариант, который соответствует срокам вашего проекта.

Базовая инициализация

After the Maven setup, bring the viewer into your code:

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: Инициализировать Viewer

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 настраивает, как Viewer генерирует HTML‑вывод, включая пагинацию и встраивание ресурсов.

Чтобы разбить архив на несколько страниц, создайте HtmlViewOptions.forEmbeddedResources() и задайте желаемый размер страницы с помощью options.setItemsPerPage(20). Viewer сгенерирует отдельные HTML‑файлы, каждый из которых будет показывать до указанного количества записей, что улучшает навигацию по большим архивам и обеспечивает более быструю загрузку.

Шаг 1: Повторно использовать каталог вывода

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

Шаг 2: Определить формат имени файла для нескольких страниц

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

Шаг 3: Снова инициализировать Viewer

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

Практические применения

  • Document management systems: Добавьте возможность предварительного просмотра архивов без установки дополнительных просмотрщиков.
  • Web portals: Предоставьте пользователям быстрый способ изучения упакованных документов без загрузки.
  • Collaboration tools: Позвольте командам просматривать общие архивы напрямую в браузере.

Соображения производительности

  • Resource management: Снижайте потребление памяти, обрабатывая архивы потоками; Viewer может работать с архивами до 500 МБ, не загружая весь файл в память.
  • Batch convert archives: Перебирайте список архивных файлов и вызывайте один и тот же процесс рендеринга для максимальной пропускной способности.
  • Caching strategy: Сохраняйте отрендеренный HTML в кэше, если один и тот же архив часто запрашивается, уменьшая время повторной обработки до 70 %.

Часто задаваемые вопросы

Q: Что такое GroupDocs.Viewer Java?
A: GroupDocs.Viewer Java — это серверная библиотека, которая рендерит более 50 форматов документов и архивов, включая ZIP и RAR, в HTML, PDF или изображения без необходимости внешних приложений.

Q: Как получить бесплатную пробную версию GroupDocs.Viewer?
A: Перейдите по free trial link для загрузки и тестирования.

Q: Могу ли я конвертировать другие типы документов, кроме архивов?
A: Да, Viewer поддерживает PDF, Word, Excel, PowerPoint и более 35 дополнительных форматов.

Q: Что делать, если рендеринг работает медленно?
A: Уменьшите количество элементов на страницу, включите потоковую обработку или разбейте архивы на более мелкие партии для повышения скорости.

Q: Где можно получить помощь или поддержку?
A: Обратитесь через support forum.

Q: Можно ли встраивать CSS и изображения напрямую в HTML?
A: Абсолютно — используйте HtmlViewOptions.forEmbeddedResources, как показано в примерах.

Q: Как пакетно конвертировать папку с архивами?
A: Пройдитесь по каждому файлу в цикле for, применяя одинаковую конфигурацию Viewer и HtmlViewOptions для каждой итерации.

Ресурсы

  • Documentation: Узнайте больше о возможностях в GroupDocs documentation.
  • API reference: Исследуйте полный API на GroupDocs API.
  • Download: Получите последние бинарные файлы со download page.
  • Purchase and licensing: Ознакомьтесь с вариантами на purchase page.
  • Support and community: Присоединяйтесь к обсуждениям на GroupDocs forum.

Последнее обновление: 2026-08-03
Тестировано с: GroupDocs.Viewer 25.2
Автор: GroupDocs

Связанные руководства