Полный рабочий пример конвертации PDF в PNG на Java с использованием Conholdate.Total

В этом примере демонстрируется, как преобразовать PDF в PNG на Java с использованием API конвертации Conholdate.Total.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PngConvertOptions;

import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.*;

public class PdfToPngDemo {
    private static final String INPUT_PDF = "input.pdf";
    private static final String OUTPUT_PATTERN = "output_page_%d.png";

public static void main(String[] args) throws Exception {
        long start = System.nanoTime();

// Determine page count without loading whole document into memory
        int totalPages;
        try (InputStream is = new FileInputStream(INPUT_PDF)) {
            Converter tempConverter = new Converter(is);
            totalPages = tempConverter.getPageCount();
        }

// Thread pool sized to available processors
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        List<Future<?>> tasks = new ArrayList<>();

for (int page = 1; page <= totalPages; page++) {
            final int pageNumber = page;
            tasks.add(executor.submit(() -> {
                // Each thread creates its own Converter instance – ensures thread safety
                try (InputStream pdfStream = new FileInputStream(INPUT_PDF)) {
                    Converter converter = new Converter(pdfStream);

PngConvertOptions options = new PngConvertOptions();
                    options.setPageNumber(pageNumber);          // convert single page
                    options.setResolution(150);                 // memory‑friendly DPI
                    options.setQuality(90);                     // PNG compression quality (0‑100)

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
                    converter.convert(outputPath, options);
                } catch (Exception e) {
                    throw new RuntimeException("Failed to convert page " + pageNumber, e);
                }
            }));
        }

// Wait for all conversions to finish
        for (Future<?> f : tasks) {
            f.get(); // re‑throws any exception from the task
        }

executor.shutdown();

long end = System.nanoTime();
        System.out.printf("PDF to PNG conversion completed in %.2f seconds.%n",
                (end - start) / 1_000_000_000.0);
    }
}

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

Понимание преобразования PDF в PNG в Java‑коде

Следующие пункты разбирают рабочий процесс образцовой программы:

1. Загрузить PDF и определить количество страниц - Класс Converter создаётся с InputStream, указывающим на исходный PDF. Вызов getPageCount() возвращает общее количество страниц без загрузки всего документа в память.

   try (InputStream is = new FileInputStream(INPUT_PDF)) {
       Converter tempConverter = new Converter(is);
       totalPages = tempConverter.getPageCount();
   }
   

2. Создать пул потоков для параллельной обработки – ExecutorService, размер которого соответствует количеству доступных процессоров, выполняет задачи конвертации одновременно, повышая общую пропускную способность.

ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());

3. Настройка параметров конвертации для конкретной страницы - Внутри каждой задачи создаётся новый экземпляр Converter (обеспечивая потокобезопасность). PngConvertOptions позволяет задать целевую страницу, разрешение и качество PNG.

   PngConvertOptions options = new PngConvertOptions();
   options.setPageNumber(pageNumber);
   options.setResolution(150);
   options.setQuality(90);
   

4. Выполнить преобразование и записать PNG‑файл - Метод convert записывает выходной PNG, используя отформатированное имя файла, которое включает номер страницы.

   String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
   converter.convert(outputPath, options);
   

5. Синхронизация завершения и очистка - Основной поток ждёт завершения всех future, затем останавливает executor и выводит прошедшее время. Этот шаблон гарантирует, что каждая страница будет обработана до выхода программы.

Для более подробных сведений об API обратитесь к Conholdate.Total Java API Reference.

Подготовка среды

Добавьте репозиторий Maven Conholdate.Total и зависимость в ваш 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>

Скачайте последнюю версию SDK с официальной страницы загрузки. Библиотека требует Java 8 или выше и работает на любой стандартной JVM.

Настройка параметров конвертации

Пример кода демонстрирует три ключевых параметра, которые вы можете настроить:

• Номер страницы - options.setPageNumber(pageNumber); выбирает конкретную страницу для рендеринга.
• Разрешение - options.setResolution(150); контролирует DPI. Более высокие значения улучшают детализацию, но увеличивают использование памяти.
• Качество - options.setQuality(90); задает степень сжатия PNG (0‑100). Отрегулируйте это значение, чтобы сбалансировать размер файла и визуальное качество.

Если вам нужен дополнительный контроль, справочник API перечисляет другие свойства, такие как setColorMode и setBackgroundColor.

Лучшие практики эффективного преобразования PDF в PNG

• Обрабатывать страницы по отдельности – Обрабатывайте каждую страницу из InputStream, чтобы избежать загрузки всего PDF в память.
• Использовать пул потоков фиксированного размера – Соответствие размера пула значению Runtime.getRuntime().availableProcessors() предотвращает перегрузку потоков и максимально использует процессор.
• Установить умеренное DPI – Для большинства сценариев предварительного просмотра 150 DPI обеспечивает хороший компромисс между качеством и производительностью.
• Повторно использовать экземпляры Converter экономно – Создание нового Converter для каждого потока гарантирует потокобезопасность; совместное использование одного экземпляра может вызвать состояния гонки.
• Измерять время выполнения – Пример выводит прошедшие секунды; используйте эти данные для точной настройки разрешения или количества потоков под вашу конкретную нагрузку.

Заключение

Конвертация PDF в PNG на Java — это рутинная, но чувствительная к производительности операция. С помощью Conholdate.Total for Java вы получаете полнофункциональный SDK, который поддерживает потоковую обработку страниц, многопоточное выполнение и детальные настройки изображений. Приведённый выше пример показывает, как построить масштабируемую утилиту конвертации PDF в PNG, настроить разрешение и качество и снизить потребление памяти. Не забудьте получить действующую лицензию для использования в продакшене; временную лицензию можно запросить по адресу https://purchase.conholdate.com/temporary-license/, а варианты ценообразования — по адресу https://purchase.conholdate.com/pricing/total/family/. Интегрируйте код, настройте параметры под свои нужды и обеспечьте быстрые, надёжные превью изображений из любого PDF‑документа.

Общие вопросы

• Как конвертировать PDF в PNG на Java без внешних инструментов?
  SDK выполняет преобразование полностью в коде, поэтому вам не нужны сторонние утилиты командной строки. Просто добавьте зависимость Maven и используйте класс Converter, как показано.

• Какую производительность я могу ожидать от утилиты конвертации PDF в PNG на Java?
  Обрабатывая страницы параллельно и используя умеренное DPI (например, 150), пример обычно конвертирует 50‑страничный PDF менее чем за несколько секунд на современном процессоре. Вы можете провести бенчмарк своих файлов, измерив прошедшее время, выводимое программой.

• Могу ли я конвертировать PDF‑файлы, содержащие множество изображений высокого разрешения, не исчерпывая память?
  Да. Код потоково обрабатывает каждую страницу отдельно и освобождает InputStream после конвертации, что сохраняет небольшой объём памяти в куче. При возникновении нехватки памяти уменьшите разрешение или запустите меньше потоков.

• Можно ли дополнительно настроить вывод PNG, например изменить цвет фона?
  Дополнительные параметры доступны в PngConvertOptions. Обратитесь к справочнику API для свойств, таких как setBackgroundColor и setColorMode.

Связанные статьи

• Конвертировать JPG в PNG на Java
• Конвертировать CDR в PNG на Java
• Конвертировать PDF в градации серого на Java