生成动态网页内容是 Java 开发人员在构建报告、电子邮件正文或嵌入式文档时的常见需求。Conholdate.Total for Java 提供了强大的 SDK，简化了在 Java 中创建 HTML 文件的过程，无需手动处理字符串。在本指南中，您将学习如何 在 Java 中创建 HTML 文件，设置库，配置转换选项，并运行一个完整示例，该示例生成一个带有外部资源的单一 HTML 文件。完成后，您将能够为任何受支持的源文档在 Java 中生成 HTML 文件。

Java 中生成 HTML 文件的完整工作示例

此示例演示如何将 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) {
                }
            }
        }
    }
}

注意： 此代码示例演示了核心功能。在将其用于项目之前，请确保更新所有文件路径和配置值以匹配实际环境，验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如果遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

Java 中创建 HTML 文件的工作原理

转换过程由三个主要组件驱动：Converter、HtmlConvertOptions 和资源处理逻辑。以下是上述代码的逐步分解。

  1. Initialize the Converter - Converter 类加载源文档。
converter = new Converter(inputPath);

此类在 API reference 中有文档说明。

  1. 配置 HTML 选项 - HtmlConvertOptions 允许您控制图像和 CSS 的存储位置，是否嵌入图像，以及输出是否应为单页。
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);
  1. 设置性能调优 - 对于大型文档，您可以调整页面限制并选择 PDF 渲染器以获得更快的速度。
htmlOptions.setMaxPages(0);
htmlOptions.setUsePdfRender(true);
  1. 执行转换 - convert 方法写入 HTML 文件并创建资源文件夹。
converter.convert(outputPath, htmlOptions);
  1. 清理 - 始终关闭 Converter 以释放本机资源。
if (converter != null) {
    converter.close();
}

合并 Java 中的 HTML 文件

设置 htmlOptions.setRenderToSinglePage(true) 会将源文档的所有页面合并为一个单独的 HTML 文件，这在需要将多个章节合并为一个整体输出时非常有用。

在 Java 中生成 HTML 文件

如果您更喜欢单独的页面，请设置 htmlOptions.setRenderToSinglePage(false)。SDK 将为每个源页面生成一个 HTML 文件，同时在指定的资源文件夹中处理图像和 CSS。

准备环境

在运行代码之前，先将 Conholdate.Total Maven 仓库和依赖项添加到项目的 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 上运行。

结论

使用 Conholdate.Total for Java 可以轻松在 Java 中创建 HTML 文件。该库负责格式检测、资源提取和页面合并，使您能够专注于业务逻辑，而无需处理低层次的字符串操作。请确保为生产环境获取有效许可证；临时许可证页面 可用于评估，详细的定价信息请参阅定价页面。按照上述步骤，您即可直接从 Java 应用程序生成 HTML 报告、电子邮件或任何网页内容。

常见问题

  • 如何在 Java 中使用 Conholdate.Total 创建 HTML 文件？
    使用 Converter 类和 HtmlConvertOptions，如完整代码示例所示。SDK 会处理提取图像、CSS 和合并页面。

  • 我可以在 Java 中使用此 SDK 合并 HTML 文件吗？
    是的。启用 htmlOptions.setRenderToSinglePage(true) 将所有页面合并为单个 HTML 输出。

  • 支持哪些源格式进行 HTML 转换？
    SDK 支持 DOCX、PDF、PPTX、XLSX，以及许多其他格式。请参阅官方文档获取完整列表。

  • 我在哪里可以获取授权和定价详情？
    访问临时授权页面获取试用授权，访问定价页面了解商业选项。

阅读更多