Полный рабочий пример генерации HTML‑файлов в Java

Этот пример демонстрирует, как преобразовать DOCX, PDF, PPTX, или любой поддерживаемый документ в один HTML‑файл с внешними ресурсами.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.HtmlConvertOptions;
import java.io.File;

public class HtmlConversionDemo {
    public static void main(String[] args) {
        // Input document (any supported format: .docx, .pdf, .pptx, etc.)
        String inputPath = "input.docx";

// Output HTML file
        String outputPath = "output.html";

// Folder where images and other resources will be stored
        String resourcesFolder = "output_resources";

// Ensure the resources folder exists
        File resFolder = new File(resourcesFolder);
        if (!resFolder.exists()) {
            resFolder.mkdirs();
        }

Converter converter = null;
        try {
            // Initialize the converter with the source document
            converter = new Converter(inputPath);

// Configure HTML conversion options
            HtmlConvertOptions htmlOptions = new HtmlConvertOptions();

// Store images and CSS in a separate folder
            htmlOptions.setResourcesFolder(resourcesFolder);
            htmlOptions.setResourcesFolderName("resources");

// Do not embed images directly into HTML (keeps file size lower)
            htmlOptions.setEmbedImages(false);

// Convert the whole document (0 means all pages)
            htmlOptions.setPageNumber(0);

// Produce a single HTML file (all pages merged)
            htmlOptions.setRenderToSinglePage(true);

// Image quality for extracted pictures (0‑100)
            htmlOptions.setQuality(90);

// Performance tweaks for large documents
            htmlOptions.setMaxPages(0); // 0 = no limit
            htmlOptions.setUsePdfRender(true); // use PDF renderer when possible

// Perform the conversion
            converter.convert(outputPath, htmlOptions);

System.out.println("HTML file created successfully at: " + outputPath);
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        } finally {
            // Release native resources
            if (converter != null) {
                try {
                    converter.close();
                } catch (Exception ignored) {
                }
            }
        }
    }
}

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

Как работает создание HTML файлов в Java

Процесс конвертации управляется тремя основными компонентами: Converter, HtmlConvertOptions и логикой обработки ресурсов. Ниже представлен пошаговый разбор кода, показанного выше.

1. Инициализация конвертера – Класс Converter загружает исходный документ.

converter = new Converter(inputPath);

Этот класс задокументирован в справка API.

2. Настройка параметров HTML - HtmlConvertOptions позволяет контролировать, где хранятся изображения и CSS, встраиваются ли изображения и должен ли вывод быть в виде одной страницы.

HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);

3. Настройка оптимизации производительности - Для больших документов вы можете регулировать ограничения страниц и выбирать PDF‑рендерер для повышения скорости.

   htmlOptions.setMaxPages(0);
   htmlOptions.setUsePdfRender(true);
   

4. Выполнить конвертацию - Метод convert записывает HTML‑файл и создает папку ресурсов.

converter.convert(outputPath, htmlOptions);

5. Очистка - Всегда закрывайте Converter, чтобы освободить нативные ресурсы.

if (converter != null) {
    converter.close();
}

Объединение HTML файлов в Java

Установка htmlOptions.setRenderToSinglePage(true) объединяет все страницы исходного документа в один HTML‑файл, что полезно, когда необходимо объединить несколько разделов в единый связный вывод.

Генерация HTML‑файлов в Java

Если вы предпочитаете отдельные страницы, установите htmlOptions.setRenderToSinglePage(false). SDK тогда сгенерирует один HTML‑файл на каждую исходную страницу, при этом будет обрабатывать изображения и CSS в указанной папке ресурсов.

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

Прежде чем запустить код, добавьте репозиторий 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>

Вы также можете загрузить последние файлы JAR напрямую со страницы загрузки. SDK требует Java 8 или выше и работает на любой стандартной JVM.

Заключение

Создание HTML‑файлов в Java становится простым с помощью Conholdate.Total for Java. Библиотека обрабатывает определение формата, извлечение ресурсов и объединение страниц, поэтому вы можете сосредоточиться на бизнес‑логике, а не на низкоуровневой работе со строками. Не забудьте получить действующую лицензию для использования в продакшене; для оценки доступна страница временной лицензии, а подробную информацию о ценах можно найти на странице ценообразования. Следуя описанным выше шагам, вы готовы генерировать HTML‑отчёты, электронные письма или любой веб‑контент непосредственно из ваших Java‑приложений.

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

• Как создать HTML‑файлы в Java с использованием Conholdate.Total?
  Используйте класс Converter вместе с HtmlConvertOptions, как показано в полном примере кода. SDK заботится об извлечении изображений, CSS и объединении страниц.

• Могу ли я объединять HTML‑файлы в Java с помощью этого SDK?
  Да. Включите htmlOptions.setRenderToSinglePage(true), чтобы объединить все страницы в один HTML‑вывод.

• Какие исходные форматы поддерживаются для конвертации в HTML?
  SDK поддерживает DOCX, PDF, PPTX, XLSX, а также многие другие форматы. См. официальную документацию для полного списка.

• Где я могу получить информацию о лицензировании и ценах?
  Посетите страницу временной лицензии для пробной лицензии и страницу ценообразования для коммерческих вариантов.

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

• Создание диаграмм в документах Word с помощью Java
• Конвертация HTML в XPS на Java
• Конвертация HTML в BMP на Java