使用 Java API 将 HTML 转换为 PDF

Aspose.HTML for Java 使用 Converter.convertHTML() 将 HTML 文件、字符串和网页转换为 PDF。将源内容加载到 HTMLDocument,创建 PdfSaveOptions,并指定目标路径。渲染器会在写入 PDF 前处理 CSS、字体、图像和页面布局。


从 HTML 文件生成 PDF

此示例加载 document.html,创建默认 PDF 保存选项,并将渲染后的文档写入 output.pdf。

使用 Java 将 HTML 转换为 PDF

import com.aspose.html.HTMLDocument;
import com.aspose.html.converters.Converter;
import com.aspose.html.saving.PdfSaveOptions;

// Load the HTML document
try (HTMLDocument document = new HTMLDocument("document.html")) {
    // Create the PDF save options
    PdfSaveOptions options = new PdfSaveOptions();

    // Convert HTML to PDF
    Converter.convertHTML(document, options, "output.pdf");
}

在线测试 HTML 转 PDF

上传 HTML 文件或输入网页 URL,检查 PDF 输出,然后再在 Java 应用程序中实现转换。

使用 Java API 将 HTML 转换为 PDF 的步骤

  1. 将 Aspose.HTML for Java 添加到项目中。
  2. 使用 HTMLDocument 加载 HTML 源内容。
  3. 创建 PdfSaveOptions 实例。
  4. 将文档、选项和输出路径传递给 Converter.convertHTML() 。

配置 PDF 页面和文档保护

PdfSaveOptions 用于控制页面大小和边距、背景颜色、内部图像分辨率、JPEG 质量、CSS 处理、带标签 PDF 输出、表单字段行为以及加密。页面尺寸、打印样式和可用字体都可能改变分页,因此应使用生产环境中的实际资源测试输出结果。

请参阅 使用 Java 将 HTML 转换为 PDF 和 PdfSaveOptions API 参考 。


安装 Aspose.HTML for Java

从 Aspose 官方存储库添加 Aspose.HTML for Java。将 ASPOSE_HTML_VERSION 替换为 Aspose.HTML for Java 版本页面 中的确切版本号,然后重新加载或重新构建项目,使依赖项得到正确解析。

将存储库和依赖项添加到 Maven 项目:

Maven – pom.xml

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <url>https://releases.aspose.com/java/repo/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-html</artifactId>
        <version>ASPOSE_HTML_VERSION</version>
    </dependency>
</dependencies>

将存储库和依赖项添加到 Gradle 项目:

Gradle – build.gradle

repositories {
    maven {
        url = uri('https://releases.aspose.com/java/repo/')
    }
}
dependencies {
    implementation 'com.aspose:aspose-html:ASPOSE_HTML_VERSION'
}

请使用与所选版本兼容的 JDK。有关手动安装 JAR、Kotlin DSL、更新和依赖项故障排除的信息,请参阅 安装 Aspose.HTML for Java 。


HTML 转 PDF 常见问题

1. Java 可以将 HTML 字符串或网页 URL 转换为 PDF 吗?

可以。Converter.convertHTML() 为支持的 HTML 源提供多个重载,其中包括带基准 URI 的内容;也可以先使用 HTMLDocument 加载文件或 URL,再执行转换。

2. 转换时如何解析相对路径的 CSS、图像和字体?

相对资源根据文档 URL 或 HTML 内容所提供的基准 URI 进行解析。请使用正确的基准位置,并确保应用程序能够访问所引用的资源。

3. 可以设置 PDF 页面大小、边距和加密吗?

可以。在调用 Converter.convertHTML() 之前,通过 PdfSaveOptions 配置页面设置和加密选项。

4. 可以免费在线将 HTML 转换为 PDF 吗?

可以。使用 免费在线 HTML 转 PDF 转换器 执行手动转换。自动化或服务器端转换请使用 Aspose.HTML for Java。