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

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

Конвертировать архивы в HTML с помощью GroupDocs.Viewer для 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?

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

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

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

Требования

  • Требуемые библиотеки: Включают GroupDocs.Viewer версии 25.2 или новее.
  • Среда: Установлен и настроен Java Development Kit (JDK).
  • Знания: Базовые навыки Java и управления зависимостями Maven.

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

Добавьте репозиторий GroupDocs и зависимость viewer в ваш 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 предлагает ссылка на бесплатную пробную версию, временную лицензию или полную покупку. Выберите тот, который подходит вашему графику проекта.

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

Класс Viewer является точкой входа для рендеринга документов и архивов. После настройки Maven подключите viewer в ваш код:

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

Как отрисовать архивы в одностраничный html

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

Прямой ответ: Создайте экземпляр Viewer для ZIP‑файла, вызовите HtmlViewOptions.forEmbeddedResources(), и выполните viewer.view(documentPath, options). Это создаёт один HTML‑файл, содержащий все файлы, изображения, 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 также поддерживает пагинацию. Вызвав options.setItemsPerPage(N), вы указываете viewer разбить архив на несколько HTML‑файлов, каждый из которых отображает до N записей. Такой подход ускоряет навигацию по большим архивам, сохраняя каждую страницу лёгкой.

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

Шаг 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.setItemsPerPage(20); // как конвертировать zip-архивы с 20 записями на страницу

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

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

  • Системы управления документами: Добавьте возможность предварительного просмотра архивов без установки дополнительных просмотрщиков.
  • Веб‑порталы: Предоставьте пользователям быстрый способ изучения объединённых документов без загрузки.
  • Инструменты совместной работы: Позвольте командам просматривать общие архивы непосредственно в браузере.

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

  • Управление ресурсами: Снижайте использование памяти, обрабатывая архивы потоками; viewer может работать с архивами до 500 МБ без загрузки всего файла в память.
  • Пакетная конверсия архивов: Пройдитесь по списку архивных файлов и примените одинаковую логику рендеринга для максимальной пропускной способности.
  • Стратегия кэширования: Сохраняйте отрендеренный HTML в кэше, если один и тот же архив часто запрашивается, сокращая время повторной обработки до 70 %.

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

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

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

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

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

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

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

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

Q: Где я могу обсудить проблемы с другими пользователями?
A: Перейдите на форум GroupDocs для обсуждения в сообществе.

Ресурсы

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

Связанные учебники