Создание визуальных превью данных таблиц является частой задачей при построении отчетных панелей или сводок по электронной почте. Conholdate.Total for Java предоставляет мощный SDK, упрощающий процесс преобразования Excel в изображение в Java‑приложениях. В этом руководстве вы увидите, как загрузить книгу XLSX, настроить вывод в JPEG и отобразить страницы листов в файлы изображений. К концу вы получите готовый к запуску пример кода, который можно адаптировать к своим проектам.

Что требуется от вашего приложения для преобразования файлов Excel в изображения

Разработчикам часто требуется преобразовать содержимое таблиц в статические изображения для веб‑просмотров, PDF отчётов или мобильных миниатюр. Требования обычно включают сохранение форматирования ячейки, точное отображение содержимого листов и контроль разрешения изображения. Выполнение этих задач вручную — открытие Excel, создание скриншотов и их сохранение — не масштабируется и может привести к непоследовательным результатам.

Технические ограничения для надёжного решения включают: поддержку файлов XLSX, точное отображение макета листа, настраиваемое разрешение изображения и возможность обработки листов, охватывающих несколько печатных страниц. Конверсия должна выполняться на сервере или настольном окружении без необходимости установки Microsoft Office.

Выбор Conholdate.Total for Java для работы

Conholdate.Total for Java предлагает простой API, который охватывает все необходимые возможности. Классы Workbook и Worksheet предоставляют прямой доступ к содержимому таблицы, а ImageOrPrintOptions позволяют точно управлять разрешением и форматом изображения, а SheetRender отвечает за постраничный рендеринг. SDK работает в любой среде Java, требует только Maven‑зависимость и эффективно обрабатывает большие рабочие книги.

Для подробного использования API см. официальную документацию. Полная справка по классам, таким как Workbook, Worksheet, ImageOrPrintOptions и SheetRender, доступна в справочнике API. Вы можете загрузить последнюю библиотеку со страницы релизов.

Реализация преобразования Excel в изображение на Java

Процесс конвертации можно разбить на несколько чётких шагов. В следующих разделах мы пройдем каждый из них, используя короткие фрагменты кода, взятые непосредственно из полного примера.

Установить Conholdate.Total for Java через Maven

Добавьте репозиторий Maven Conholdate и зависимость SDK в ваш pom.xml:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Загрузить файл Excel и получить доступ к рабочему листу

Загрузите книгу с помощью класса Workbook, затем получите ссылку на лист, который вы хотите конвертировать:

// Load Excel file
com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

Настройка параметров вывода изображения для JPEG

Установите желаемое разрешение изображения и формат, используя ImageOrPrintOptions:

// Set image options
com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(com.aspose.cells.ImageType.JPEG);

Отображение листа в JPEG‑изображения

Создайте SheetRender для листа и пройдитесь по его страницам, сохраняя каждую в отдельный файл JPEG. Лист может занимать более одной печатной страницы, поэтому getPageCount() сообщает, сколько изображений следует ожидать:

// Convert sheet to JPG image
com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
for (int j = 0; j < sr.getPageCount(); j++)
{
    sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
}

Приведённые выше шаги демонстрируют, как преобразовать Excel в изображение с помощью Conholdate.Total for Java SDK, предоставляя вам контроль над разрешением, форматом и многостраничными листами.

Полный пример кода: Конвертация Excel в изображение с поддержкой полного листа

Следующий код демонстрирует полную, готовую к запуску реализацию, описанную в вышеуказанных шагах.

public class ExcelToImageConverter {
    public static void main(String[] args) throws Exception {
        // Load Excel file
        com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
        com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

// Set image options
        com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
        options.setHorizontalResolution(200);
        options.setVerticalResolution(200);
        options.setImageType(com.aspose.cells.ImageType.JPEG);

// Convert sheet to JPG image
        com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
        for (int j = 0; j < sr.getPageCount(); j++)
        {
            sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
        }

System.out.println("Excel to image conversion completed successfully.");
    }
}

Примечание: Этот пример кода демонстрирует основную функциональность. Прежде чем использовать его в вашем проекте, убедитесь, что обновили путь к файлу (input.xlsx), чтобы он соответствовал фактическому расположению файла, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если вы столкнётесь с проблемами, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Заключение

Преобразование Excel в изображение в Java становится простым, когда вы используете Conholdate.Total for Java. SDK обрабатывает рендеринг листов и вывод JPEG высокого качества с минимальным количеством кода. Следуя пошаговому руководству, вы можете интегрировать эту возможность в инструменты отчётности, генераторы электронных писем или любое приложение, которому нужны визуальные представления таблиц. Помните, что для продакшн‑развёртываний требуется коммерческая лицензия; вы можете изучить варианты ценообразования на странице Conholdate.Total pricing и получить временную лицензию со страницы временной лицензии во время оценки.

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

  • Как преобразовать Excel в изображение на Java?
    Загрузите файл с помощью Workbook, получите нужный лист из book.getWorksheets(), настройте ImageOrPrintOptions и отобразите его с помощью SheetRender.

  • Могу ли я преобразовать конкретный лист Excel в изображение?
    Да. Используйте book.getWorksheets().get(index), чтобы выбрать лист, затем передайте его в SheetRender для конвертации.

  • Почему я получаю более одного файла изображения из одного листа?
    Лист может охватывать несколько печатных страниц. SheetRender.getPageCount() возвращает количество страниц, а цикл сохраняет одно изображение на каждую страницу.

  • Какова лицензия, необходимая для использования в продакшене?
    Требуется коммерческая лицензия. Ознакомьтесь со стоимостью на странице Conholdate.Total pricing и получите временную лицензию со страницы temporary license page.

Читать далее