Как конвертировать Excel в HTML, JPG, PNG и PDF с помощью GroupDocs.Viewer Java

Преобразование Excel в HTML — распространённая задача, когда нужно отображать данные таблицы в вебе, сохраняя заголовки строк и столбцов. В этом руководстве вы узнаете, как GroupDocs.Viewer для Java упрощает convert excel to html, а также как отобразить ту же книгу в форматах JPG, PNG и PDF. Мы пройдём через предварительные требования, настройку библиотеки и каждый сценарий рендеринга с понятными, готовыми к продакшн фрагментами кода.

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

  • Может ли GroupDocs.Viewer рендерить Excel в несколько форматов? Да – HTML, JPG, PNG и PDF поддерживаются из коробки.
  • Нужна ли лицензия для разработки? Бесплатная пробная версия подходит для тестирования; постоянная лицензия требуется для продакшн.
  • Будут ли сохранены заголовки строк и столбцов? Установите setRenderHeadings(true) в параметрах просмотра, чтобы включить их.
  • Какая версия Java требуется? Java 8 или выше; библиотека совместима с Java 11, 17 и более новыми версиями.
  • Быстро ли происходит конвертация больших книг? GroupDocs.Viewer может обработать таблицы в 200 страниц за менее чем секунду на типичном серверном оборудовании.

Что такое “convert excel to html”?

Convert excel to html означает преобразование книги Excel в готовый к вебу HTML‑документ, сохраняя оригинальное расположение, формулы и заголовки. Это позволяет без проблем встраивать таблицы в веб‑страницы или порталы без необходимости у конечного пользователя иметь установленный Excel.

Почему стоит использовать GroupDocs.Viewer Java для рендеринга Excel?

GroupDocs.Viewer Java поддерживает более 50 форматов ввода и вывода, включая DOCX, XLSX, PPTX, HTML, JPG, PNG и PDF. Он обрабатывает книги в несколько сотен страниц без загрузки всего файла в память, обеспечивая скорость конвертации до 10 × быстрее, чем многие открытые альтернативы. Библиотека также предоставляет детальный контроль над параметрами рендеринга, такими как видимость заголовков, размер страницы и качество изображения.

Предварительные требования

  • Java Development Kit (JDK) 8+ установлен и настроен в вашей IDE (IntelliJ IDEA, Eclipse и т.д.).
  • Maven для управления зависимостями.
  • Базовое знакомство с синтаксисом Java и pom.xml Maven.
  • Активная лицензия GroupDocs.Viewer Java (пробная или постоянная).

Требуемые библиотеки и зависимости

Добавьте зависимость GroupDocs.Viewer Java в ваш 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>

Настройка окружения

  • Убедитесь, что java -version возвращает 1.8 или новее.
  • Откройте вашу любимую IDE и создайте Maven‑проект.

Начнём с предварительных требований, необходимых перед тем как перейти к реализации.

convert Excel files into HTML, JPG, PNG, and PDF with GroupDocs.Viewer for Java

Настройка GroupDocs.Viewer Java

Информация об установке

Включите Maven‑зависимость, показанную выше, в ваш pom.xml. После выполнения mvn clean install библиотека будет доступна в вашем classpath.

Шаги получения лицензии

  1. Free Trial: Скачайте пробную версию с GroupDocs Free Trial.
  2. Temporary License: Получите временную лицензию для расширенного тестирования с GroupDocs Temporary License.
  3. Purchase: Приобретите полную лицензию для продакшн‑использования на GroupDocs Purchase.

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

Класс Viewer является точкой входа для всех операций рендеринга. Его инициализация проста:

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("Sample.xlsx")) {
            // Your code here to use the viewer
        }
    }
}

Это создаёт экземпляр Viewer, привязанный к локальному файлу лицензии, готовый обрабатывать файлы Excel.

Руководство по реализации

Ниже мы рассматриваем каждую цель рендеринга. Для каждого формата мы сначала импортируем необходимые классы, затем указываем каталог вывода, и, наконец, настраиваем параметры просмотра с setRenderHeadings(true), чтобы сохранить заголовки строк/столбцов.

Рендеринг таблицы в HTML

Как конвертировать книгу Excel в HTML с помощью GroupDocs.Viewer Java?
Чтобы конвертировать книгу Excel в HTML, загрузите файл с помощью Viewer, создайте экземпляр HtmlViewOptions, включите рендеринг заголовков и вызовите метод view. Процесс записывает каждый лист в отдельные HTML‑файлы, сохраняя форматирование ячеек, формулы и оригинальное расположение для точного отображения в вебе.

Пошаговая реализация

1. Импорт необходимых библиотек
HtmlViewOptions настраивает, как книга будет рендериться в HTML, позволяя кастомизировать заголовки, стили и макет страницы.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

2. Укажите каталог вывода
Укажите папку, куда будут записаны сгенерированные HTML‑страницы.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

3. Инициализировать Viewer и настроить параметры
Создайте экземпляр Viewer, установите setRenderHeadings(true) и вызовите view.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

Объяснение: HtmlViewOptions управляет выводом HTML. Включение setRenderHeadings(true) гарантирует, что первая строка и столбец (обычно заголовки) появятся в полученном HTML, делая данные сразу понятными.

Рендеринг таблицы в JPG

Как отрендерить лист Excel в изображение JPG с включёнными заголовками?
Рендеринг листа Excel в JPG включает инициализацию Viewer с книгой, создание объекта JpgViewOptions, установку renderHeadings в true и вызов view. Библиотека растеризует каждую страницу с указанным DPI, создавая высоко‑разрешённые JPG‑файлы, сохраняющие визуальную структуру таблицы и заголовки.

Пошаговая реализация

1. Импорт необходимых библиотек
JpgViewOptions определяет настройки для рендеринга листов в изображения JPG, включая DPI, качество и видимость заголовков.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

2. Укажите каталог вывода
Укажите, где будут храниться JPG‑файлы.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.jpg");

3. Инициализировать Viewer и настроить параметры
Создайте viewer, включите рендеринг заголовков и выполните конвертацию.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

Объяснение: JpgViewOptions позволяет управлять DPI и качеством. С setRenderHeadings(true) полученные изображения сохраняют строки и столбцы‑заголовки таблицы, что важно для отчётов и презентаций.

Рендеринг таблицы в PNG

Каков процесс конвертации Excel в PNG с сохранением заголовков столбцов?
Чтобы получить PNG‑изображения из файла Excel, используйте Viewer для открытия книги, создайте экземпляр PngViewOptions, включите рендеринг заголовков и выполните view. Вывод в PNG обеспечивает без потерь качество, сохраняет все стили ячеек и строки‑заголовки, что делает его идеальным для архивирования или дальнейшей обработки изображений.

Пошаговая реализация

1. Импорт необходимых библиотек
PngViewOptions управляет рендерингом листов в PNG‑изображения, предлагая сжатие без потерь и параметры заголовков.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

2. Укажите каталог вывода
Выберите папку для вывода PNG.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.png");

3. Инициализировать Viewer и настроить параметры
Создайте viewer, включите рендеринг заголовков и вызовите view.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PngViewOptions options = new PngViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

Объяснение: При вызове setRenderHeadings(true) PNG‑файлы включают оригинальные строки и столбцы‑заголовки таблицы, сохраняя контекст для последующих потребителей.

Рендеринг таблицы в PDF

Как конвертировать файл Excel в PDF с видимыми заголовками строк и столбцов?
Конвертация Excel в PDF проста: создайте Viewer с исходным файлом, настройте объект PdfViewOptions для рендеринга заголовков и вызовите view. Полученный PDF отражает макет книги, включая заголовки строк и столбцов, и поддерживает векторную графику для чёткой печати и распространения.

Пошаговая реализация

1. Импорт необходимых библиотек
PdfViewOptions задаёт параметры генерации PDF, такие как размер страницы, отступы и рендеринг заголовков.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

2. Укажите каталог вывода
Укажите папку назначения для PDF‑документа.

Path outputDirectory = Paths.get("YOUR_DOCUMENT_DIRECTORY", "RenderRowAndColumnHeadings");
Path pageFilePathFormat = outputDirectory.resolve("output.pdf");

3. Инициализировать Viewer и настроить параметры
Создайте Viewer, включите рендеринг заголовков и выполните конвертацию.

try (Viewer viewer = new Viewer(Paths.get("Sample.xlsx"))) {
    PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);
    
    // Enable rendering of row and column headings in the spreadsheet.
    options.getSpreadsheetOptions().setRenderHeadings(true);

    viewer.view(options, 1, 2, 3); // Render pages 1 to 3.
}

Объяснение: Установка setRenderHeadings(true) в PdfViewOptions гарантирует, что первая строка/столбец появятся в финальном PDF, делая документ готовым к печати или архивированию.

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

Реальные сценарии, где convert excel to html, excel to pdf java или convert spreadsheet to image незаменимы:

  1. Business Reporting: Генерировать HTML‑дашборды или PDF‑отчёты из финансовых моделей без ручного копирования.
  2. Data Visualization: Встраивать JPG/PNG‑снимки таблиц в презентации, гарантируя, что заголовки дают зрителям мгновенный контекст.
  3. Document Archiving: Хранить книги Excel в виде PDF для соответствия требованиям, сохраняя оригинальный макет и заголовки.
  4. Web Portals: Предоставлять HTML‑версии таблиц напрямую в браузерах, позволяя интерактивную фильтрацию с помощью JavaScript.

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

Q: Могу ли я конвертировать защищённые паролем файлы Excel?
A: Да. Передайте пароль в конструктор Viewer, и библиотека расшифрует книгу перед рендерингом.

Q: Поддерживает ли GroupDocs.Viewer книги с макросами (.xlsm)?
A: Абсолютно. Viewer рассматривает макросы как данные; они игнорируются при рендеринге, обеспечивая безопасную конвертацию.

Q: Каков максимальный поддерживаемый размер файла?
A: Библиотека может обрабатывать файлы размером до 2 GB без загрузки всего документа в память благодаря потоковой архитектуре.

Q: Можно ли отрендерить только конкретный лист?
A: Да. Используйте ViewOptions.setPageNumber(pageIndex), чтобы выбрать отдельный лист при генерации HTML, JPG, PNG или PDF.

Q: Как контролировать качество изображения для вывода JPG?
A: Установите JpgViewOptions.setQuality(90) (значение 0‑100), чтобы сбалансировать размер файла и визуальное качество.

Заключение

Теперь у вас есть полный, готовый к продакшн руководство по convert excel to html, excel to pdf java и convert spreadsheet to image с использованием GroupDocs.Viewer Java. Следуя приведённым шагам, вы сможете интегрировать рендеринг таблиц в любой Java‑бэкенд, предоставляя HTML‑отчёты, изображения высокого разрешения или архивные PDF с автоматически сохранёнными заголовками.

Last Updated: 2026-06-05
Tested With: GroupDocs.Viewer Java 23.12
Author: GroupDocs

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