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

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

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

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

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

Conholdate.Total for Java предлагает единый API, охватывающий все необходимые возможности. Его ExcelLoadOptions позволяют загружать диаграммы и формулы, а ImageConvertOptions предоставляют тонкий контроль над форматом, качеством и размерами. SDK работает на любой Java‑runtime, требует только зависимость Maven и эффективно обрабатывает большие рабочие книги.

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

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

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

Установить Conholdate.Total для 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 с поддержкой диаграмм и формул

Создайте экземпляр ExcelLoadOptions, включите загрузку диаграмм и формул и инициализируйте объект Conversion с помощью файлового потока:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

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

Установите желаемый формат изображения, качество и размеры. Ширина фиксирована, а высота сохраняет соотношение сторон:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Преобразовать каждый лист или диапазон в PNG‑изображения

Итерируйте страницы рабочей книги (листы) и конвертируйте каждую из них. Вы также можете выбрать определённый диапазон, изменив pageNumber или используя дополнительные параметры загрузки:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Проверьте вывод и обработайте исключения

Обёрните логику конвертации в блок try‑catch и убедитесь, что каталог вывода существует перед началом:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

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

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

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

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

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

Заключение

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

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

  • Как я могу конвертировать Excel в изображение на Java?
    Используйте класс Conversion из Conholdate.Total for Java, настройте ExcelLoadOptions и ImageConvertOptions, затем вызовите convert для каждого листа.

  • Могу ли я преобразовать диаграмму Excel в изображение?
    Да. Включите загрузку диаграмм с помощью loadOptions.setLoadCharts(true) и укажите номер страницы диаграммы при установке imgOptions.setPageNumber.

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

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

Читать дальше