Преобразование Excel в PDF с помощью GroupDocs Conversion Java

Нужен ли вам convert Excel to PDF быстро, при этом сохранять вывод аккуратным и без пустых строк или столбцов? С GroupDocs Conversion Java вы можете превратить любую таблицу в компактный PDF всего в несколько строк кода. Этот учебник проведёт вас через настройку библиотеки, конфигурацию параметров загрузки для skip empty rows and columns, а также обработку пакетных конвертаций для масштабных конвейеров отчётности. К концу вы сможете:

  • Добавить зависимость GroupDocs Conversion Java в Maven‑проект
  • Использовать SpreadsheetLoadOptions.setSkipEmptyRowsAndColumns(true) для удаления пробелов
  • Конвертировать рабочую книгу в PDF с оптимальной производительностью
  • Масштабировать решение для автоматизированных, пакетных Excel‑в‑PDF процессов

Давайте погрузимся и посмотрим, как groupdocs conversion java делает это без усилий.

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

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

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

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

Что такое GroupDocs Conversion Java?

GroupDocs Conversion Java — это SDK на Java, поддерживающий 50+ входных и выходных форматов, включая Excel, Word, PowerPoint и изображения, и способный обрабатывать документы в сотни страниц без загрузки всего файла в память. Он предоставляет высокоуровневые API, абстрагирующие специфические для формата сложности, позволяя разработчикам сосредоточиться на бизнес‑логике, а не на работе с файлами.

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

GroupDocs Conversion Java предоставляет количественные преимущества: поддерживает более 50 форматов, обрабатывает файлы размером до 1 ГБ с использованием менее 200 МБ кучи и конвертирует типичную таблицу из 200 строк в PDF менее чем за 0,8 секунды на стандартном сервере. Библиотека также предлагает:

  • Умные параметры загрузки (например, skip empty rows/columns), уменьшающие размер PDF до 30 %
  • Конвертация один‑лист‑на‑страницу для лаконичных PDF‑файлов
  • Кроссплатформенная совместимость — работает на Windows, Linux и macOS
  • Поддержка пакетной обработки для масштабной автоматизации

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

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

  1. Java Development Kit (JDK) 8+ – скачайте с Oracle’s website
  2. Maven – получите с maven.apache.org
  3. 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>

Приобретение лицензии

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

Чтобы конвертировать рабочую книгу Excel в PDF с помощью GroupDocs Conversion Java, сначала загрузите книгу, используя соответствующие параметры загрузки, включите флаг setSkipEmptyRowsAndColumns(true) для удаления пустых ячеек, затем создайте экземпляр Converter и укажите PdfConvertOptions. Наконец, вызовите метод convert для записи PDF‑файла. Весь процесс покрыт четырьмя простыми шагами.

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

SpreadsheetLoadOptions определяет, как интерпретировать таблицу. Установка setSkipEmptyRowsAndColumns(true) сообщает движку игнорировать любые строки или столбцы без данных, что приводит к более плотному макету 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

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

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

PdfConvertOptions позволяет точно настроить вывод 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: Выполнение конвертации

Вызов convert записывает 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, содержащий только заполненные ячейки, благодаря опции skip‑empty‑rows/columns.

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

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

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

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

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

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

Заключение

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

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

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

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

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

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

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

Last Updated: 2026-05-16
Tested With: GroupDocs Conversion 25.2
Author: GroupDocs

Связанные учебники