Одна страница на лист – Excel в PDF на Java, замена шрифтов

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

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

  • Что означает «одна страница на лист»? Каждый лист отображается на одной странице PDF.
  • Какая библиотека выполняет преобразование? GroupDocs.Conversion для Java.
  • Можно ли автоматически заменять отсутствующие шрифты? Да, используя функцию FontSubstitute.
  • Нужна ли лицензия? Требуется временная лицензия для полной функциональности.
  • Подходит ли этот подход для больших книг? Да, при правильной настройке памяти JVM.

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

Перед тем как писать код, убедитесь, что у вас есть следующее:

Требуемые библиотеки и зависимости

Убедитесь, что у вас есть библиотека GroupDocs.Conversion версии 25.2 или новее, которой можно управлять через Maven.

Требования к настройке среды

  • Установлен Java Development Kit (JDK) на вашем компьютере.
  • IDE, например IntelliJ IDEA или Eclipse, для написания и запуска Java‑кода.

Требования к знаниям

Базовое понимание программирования на Java, управления библиотеками через Maven и концепций конвертации файлов будет полезным, но не является обязательным.

Теперь, когда всё готово, давайте перейдём к реализации.

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

  • One page per sheet рендеринг гарантирует предсказуемую пагинацию.
  • Font substitution обеспечивает одинаковый вид PDF на любой системе, даже если оригинальные шрифты отсутствуют.
  • Поддерживает convert excel to pdf для широкого спектра возможностей Excel (диаграммы, формулы, стили).
  • Полностью программируемый через Java, что делает его идеальным для автоматических конвейеров excel to pdf java.

Настройка GroupDocs.Conversion для Java

Maven Configuration

Сначала добавьте необходимые репозитории и информацию о зависимостях в ваш файл 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>

License Acquisition

Получите временную лицензию от GroupDocs для полного доступа к функциям в течение пробного периода.

Basic Initialization and Setup

После настройки Maven инициализируйте GroupDocs.Conversion в вашем Java‑приложении:

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

public class ConvertExcelToPDF {
    public static void main(String[] args) {
        String inputDocument = "sample.xlsx";
        String convertedFile = "output.pdf";

        // Initialize the Converter object with your document path
        Converter converter = new Converter(inputDocument);

        PdfConvertOptions options = new PdfConvertOptions();
        
        // Perform the conversion
        converter.convert(convertedFile, options);
    }
}

Руководство по реализации – Замена шрифтов с одной страницей на лист

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

Шаг 1: Определите пути входного и выходного файлов

Укажите путь к вашему входному файлу Excel и желаемый путь к выходному PDF:

String inputDocument = "YOUR_DOCUMENT_DIRECTORY/sample.xlsx";
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertSpreadsheetBySpecifyingFontsubstitution.pdf";

Шаг 2: Настройте параметры загрузки с заменой шрифтов

Создайте объект SpreadsheetLoadOptions для конфигурации параметров конвертации, указывая замену шрифтов:

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

List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
loadOptions.setFontSubstitutes(fontSubstitutes);

Шаг 3: Настройте шрифт по умолчанию и One Page per Sheet

Установите шрифт по умолчанию как резервный и включите опцию one page per sheet, чтобы гарантировать, что каждый лист занимает одну страницу PDF:

loadOptions.setDefaultFont("resources/fonts/Helvetica.ttf");
loadOptions.setOnePagePerSheet(true);

Совет: Включение setOnePagePerSheet(true) необходимо, когда требуется предсказуемая пагинация для отчетов или счетов‑фактур.

Шаг 4: Инициализируйте Converter с параметрами загрузки

Передайте параметры загрузки вашему объекту Converter:

Converter converter = new Converter(inputDocument, () -> loadOptions);

Шаг 5: Определите параметры конвертации в PDF и выполните преобразование

Укажите формат конвертации и запустите процесс:

PdfConvertOptions options = new PdfConvertOptions();
converter.convert(convertedFile, options);

Советы по устранению неполадок

  • Missing Fonts: Убедитесь, что заменяющие шрифты установлены в системе или включены в приложение.
  • Incorrect Paths: Проверьте пути к входным и выходным документам; относительные пути должны разрешаться от корня проекта.

Практические применения

Замена шрифтов и конвертация с одной страницей на лист полезны в многих реальных сценариях:

  1. Бизнес‑отчётность: Согласованное представление финансовых отчётов на разных платформах.
  2. Юридическая документация: Сохранение внешнего вида PDF‑документов для контрактов.
  3. Академические публикации: Стандартизация шрифтов для статей и презентаций.
  4. Маркетинговые материалы: Единообразные брошюры или рассылки, генерируемые из таблиц.
  5. Инструменты совместной работы: Оптимизация систем управления документами, использующих предварительный просмотр PDF.

Соображения по производительности

Для оптимизации работы при конвертации больших книг:

  • Используйте потоковый ввод/вывод, чтобы уменьшить потребление памяти.
  • Настраивайте размер кучи JVM (-Xmx) в зависимости от размера документа.
  • По возможности переиспользуйте один экземпляр Converter для пакетных конвертаций.

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

Q: Что такое GroupDocs.Conversion Java?
A: Это библиотека для конвертации различных форматов документов — включая Excel в PDF — с настраиваемыми параметрами, такими как замена шрифтов и одна страница на лист.

Q: Можно ли использовать GroupDocs.Conversion без покупки лицензии?
A: Да, бесплатная пробная версия или временная лицензия позволяют изучить все функции перед приобретением платной лицензии.

Q: Как обрабатывать отсутствующие шрифты во время конвертации?
A: Определите заменяющие шрифты с помощью объектов FontSubstitute внутри SpreadsheetLoadOptions; библиотека автоматически заменит недоступные шрифты.

Q: Какие лучшие практики по оптимизации производительности Java с GroupDocs.Conversion?
A: Эффективное управление памятью, правильная конфигурация JVM и обработка файлов потоками помогают поддерживать высокую производительность.

Q: Влияет ли опция «одна страница на лист» на отображение диаграмм?
A: Нет, диаграммы масштабируются так, чтобы уместиться на одной странице, сохраняя визуальную точность.

Заключение

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

Следующие шаги

  • Поэкспериментируйте с дополнительными PdfConvertOptions (например, соответствие PDF/A).
  • Скомбинируйте это решение с GroupDocs.Annotation для пост‑конверсионного редактирования.
  • Исследуйте другие исходные форматы (Word, PowerPoint), используя тот же шаблон.

Последнее обновление: 2026-01-15
Тестировано с: GroupDocs.Conversion 25.2
Автор: GroupDocs