Конвертировать Excel в PDF с помощью GroupDocs.Conversion Java

Введение

Нужно быстро конвертировать Excel в PDF, при этом сохранить результат аккуратным и без пустых строк или столбцов? Многие разработчики сталкиваются с громоздкими PDF, содержащими лишние пробелы, из‑за чего документ выглядит непрофессионально. В этом руководстве мы покажем, как использовать GroupDocs.Conversion Java для создания чистого PDF из рабочей книги Excel всего в несколько строк кода. К концу этого руководства вы сможете:

Настроить GroupDocs.Conversion в Maven‑проекте
Настроить параметры загрузки для пропуска пустых строк и столбцов
Эффективно конвертировать лист Excel в PDF
Применить решение к реальным сценариям, таким как автоматизированная отчетность или архивирование документов

Давайте начнём!

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

Какая библиотека обрабатывает конвертацию? GroupDocs.Conversion Java
Основная используемая функция? SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true)
Минимальная версия Java? JDK 8 или выше
Можно ли обрабатывать множество файлов? Да — комбинируйте этот код с пакетной логикой для массовой конвертации
Нужна ли лицензия? Для использования в продакшене требуется временная или пробная лицензия

Что такое «конвертация Excel в PDF»?

Конвертация Excel в PDF означает преобразование электронной таблицы (.xlsx, .xls) в документ PDF фиксированного макета. Это гарантирует одинаковый вид содержимого на любом устройстве и идеально подходит для обмена, печати или архивирования.

Почему использовать GroupDocs.Conversion Java для этой задачи?

GroupDocs.Conversion предоставляет high‑level API, который абстрагирует сложности работы с форматами файлов. Он предлагает:

Умные параметры загрузки (например, пропуск пустых строк/столбцов)
Конвертация один лист — одна страница для компактных PDF
Кроссплатформенная совместимость — работает на Windows, Linux и macOS
Поддержка пакетной обработки для масштабной автоматизации

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

Перед тем как погрузиться в код, убедитесь, что у вас есть:

Java Development Kit (JDK) 8+ – скачайте с Oracle’s website
Maven – получите его с maven.apache.org
GroupDocs.Conversion Java – мы добавим его как зависимость Maven

Необходимые библиотеки и зависимости

Добавьте следующий репозиторий и зависимость в ваш pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Получение лицензии

Получите временную лицензию со GroupDocs’ Temporary License page.
Для бесплатного пробного периода скачайте библиотеку со GroupDocs Releases Page.

Как конвертировать Excel в PDF с помощью GroupDocs.Conversion Java

Ниже представлена пошаговая инструкция, включающая generate pdf from excel с использованием расширенных параметров библиотеки.

Шаг 1: Настройка параметров загрузки

Сначала укажите конвертеру игнорировать пустые строки и столбцы и разместить каждый лист на одной странице PDF.

import com.groupdocs.conversion.options.load.SpreadsheetLoadOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx"; // Input file path

// Configure load options to skip empty rows and columns and set one page per sheet.
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setSkipEmptyRowsAndColumns(true);
loadOptions.setOnePagePerSheet(true);

Explanation: SpreadsheetLoadOptions контролирует, как читается электронная таблица. Включение setSkipEmptyRowsAndColumns(true) удаляет пустое пространство, создавая более плотный PDF.

Шаг 2: Инициализация конвертера

Создайте экземпляр Converter, который будет выполнять преобразование.

import com.groupdocs.conversion.Converter;

// Initialize the converter with the input file path and load options.
Converter converter = new Converter(inputFilePath, () -> loadOptions);

Explanation: Лямбда‑выражение предоставляет ранее определённые loadOptions каждый раз, когда конвертеру нужно загрузить документ.

Шаг 3: Подготовка параметров конвертации PDF

Хотя настройки по умолчанию подходят для большинства случаев, при необходимости вы можете настроить вывод PDF.

import com.groupdocs.conversion.options.convert.PdfConvertOptions;

// Create PdfConvertOptions (optional, as default options are used here).
PdfConvertOptions pdfConvertOptions = new PdfConvertOptions();

Explanation: PdfConvertOptions позволяет настроить поля, размер страницы и другие параметры, специфичные для PDF.

Шаг 4: Выполнение конвертации

Наконец, запустите процесс конвертации и запишите PDF на диск.

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/converted.pdf"; // Output file path

// Perform the conversion from spreadsheet to PDF.
converter.convert(outputFilePath, pdfConvertOptions);

Explanation: Метод convert создаёт PDF, содержащий только заполненные ячейки, благодаря опции пропуска пустых строк/столбцов.

Распространённые проблемы и устранение неполадок

Неправильный путь к файлу — дважды проверьте пути ввода и вывода.
Ошибки доступа — убедитесь, что процесс Java имеет права чтения/записи в директориях.
Большие рабочие книги — выделите больше памяти кучи (-Xmx2g), чтобы избежать OutOfMemoryError.

Практические примеры использования

Автоматизированное создание отчетов — преобразуйте ежедневные Excel‑отчёты в стильные PDF для заинтересованных сторон.
Архивирование документов — храните финансовые отчёты в PDF без лишних пустых ячеек.
Пакетная конвертация Excel в PDF — перебирайте папку с таблицами и применяйте ту же логику для обработки большого объёма.

Советы по производительности

Управление памятью — освобождайте объект Converter после каждой конвертации (converter.close()).
Пакетная обработка — обрабатывайте файлы небольшими группами, чтобы предсказуемо использовать память.
Мониторинг — фиксируйте время конвертации и потребление памяти для выявления узких мест.

Заключение

Теперь у вас есть полноценный, готовый к продакшену метод конвертировать Excel в PDF с помощью GroupDocs.Conversion Java, автоматически удаляя пустые строки и столбцы. Внедрите эту схему в свои конвейеры отчётности, системы управления документами или любые сценарии, где важен чистый вывод PDF.

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

Q1: Можно ли конвертировать другие типы документов с помощью GroupDocs.Conversion Java?
A1: Да! Библиотека поддерживает множество форматов, включая Word, PowerPoint и изображения.

Q2: PDF всё ещё показывает пустые строки — что проверить?
A2: Убедитесь, что loadOptions.setSkipEmptyRowsAndColumns(true) вызывается до создания Converter.

Q3: Как обрабатывать исключения во время конвертации?
A3: Оберните код конвертации в блок try‑catch и запишите детали исключения в журнал для отладки.

Q4: Можно ли настроить макет PDF (поля, ориентацию)?
A4: Конечно. Используйте PdfConvertOptions для установки полей, размера страницы и ориентации.

Q5: Можно ли использовать GroupDocs.Conversion в проекте без Maven?
A5: Да, вы можете скачать JAR‑файлы напрямую со GroupDocs website.

Last Updated: 2026-01-18
Tested With: GroupDocs.Conversion 25.2
Author: GroupDocs