将 TXT 转换为 HTML、JPG、PNG、PDF 使用 GroupDocs Viewer

在现代 Java 应用程序中，convert txt to html 只是实现灵活文档预览流水线的第一步。借助 GroupDocs Viewer Maven，您可以瞬间将纯文本文件转换为可在网页上直接使用的 HTML、清晰的 JPG/PNG 图像，或通用的 PDF。无论您是在构建文档门户、归档服务，还是为 SaaS 产品实现预览功能，本指南将带您完成完整的设置，并展示如何 convert txt files java 为所有常见的输出格式。

使用 GroupDocs.Viewer for Java 将 TXT 文件转换为 HTML、JPG、PNG 和 PDF

快速答案

  • 需要哪个 Maven 构件？ com.groupdocs:groupdocs-viewer (see the Maven snippet below).
  • 我可以渲染多页 HTML 吗？ 是的 – 使用 HtmlViewOptions.forEmbeddedResources 并且不使用单页标志。
  • 生产环境需要许可证吗？ 试用版可用于评估；商业使用需要永久许可证。
  • 支持哪个 Java 版本？ Java 8 或更高（推荐使用 Java 11+）。
  • 图像输出需要额外的库吗？ 不需要，Viewer 库已内置 JPG 和 PNG 支持。

什么是 groupdocs viewer maven？

GroupDocs Viewer Maven 是 GroupDocs.Viewer for Java 库的基于 Maven 的发行版。它提供了一个单一、易于使用的 API，能够将超过 100 种文档格式（包括纯文本）渲染为 HTML、图像或 PDF，且无需 Microsoft Office 或任何第三方转换器。它抽象了文档渲染的复杂性，使开发者能够专注于业务逻辑，而不是文件格式处理。

为什么要 convert txt files java？

将 TXT 文件转换为更丰富的格式可实现与网页界面的无缝集成，确保样式一致，并符合归档标准，使内容更易访问且更专业。它还简化了下游处理，例如搜索索引和内容分析，因为提供了结构化的输出。

  • 跨平台预览 – HTML 和图像可在浏览器或移动应用中即时显示。
  • 标准化归档 – PDF 保留格式并且通用可读。
  • 自动化友好 – 在 CI 流水线、云函数或计划任务中批量转换 txt 文件。

前置条件

  • GroupDocs.Viewer for Java 版本 25.2 或更高（通过 Maven 提供）。
  • JDK 8 +（推荐使用 Java 11 +）。
  • IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE。
  • 基础的 Java 与 Maven 知识。

设置 GroupDocs.Viewer for Java

将仓库和依赖添加到您的 pom.xml 中：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

许可证获取步骤

  • 开始使用 免费试用 或获取 临时许可证 以探索全部功能。
  • 对于生产环境，请通过官方的 购买页面 购买许可证。

基本初始化和设置

  1. 添加上面显示的 Maven 依赖。
  2. 确保您的 JDK 和 IDE 已正确配置。

Definition anchor: Viewer 是 GroupDocs.Viewer 的核心类，用于加载源文档并将其渲染为所选的输出格式。

实现指南

功能 1：将 TXT 渲染为多页 HTML (multi page html java)

Direct answer: Use HtmlViewOptions.forEmbeddedResources and call viewer.view(documentPath, options) – this generates a series of HTML pages, each representing a portion of the original text, while automatically embedding CSS and images.

Definition anchor: HtmlViewOptions configures how the Viewer renders a document to HTML, including pagination, resource embedding, and CSS handling.

导入所需库

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

设置路径和 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

Explanation: HtmlViewOptions.forEmbeddedResources bundles CSS, fonts, and images directly into the HTML output, making it portable.

功能 2：将 TXT 渲染为单页 HTML (convert txt to html java)

Direct answer: Call HtmlViewOptions.forEmbeddedResources().setRenderToSinglePage(true) before invoking viewer.view; the entire TXT content will be collapsed into one HTML file, ideal for quick previews.

Definition anchor: setRenderToSinglePage(true) forces the Viewer to merge all generated pages into a single HTML document.

导入所需库

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

设置路径和 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

Explanation: setRenderToSinglePage(true) merges all pages into one HTML file.

功能 3：将 TXT 渲染为 JPG

Direct answer: Create a JpgViewOptions instance, optionally set DPI for higher quality, and pass it to viewer.view; the Viewer will output a JPEG image for each page of the source TXT file.

Definition anchor: JpgViewOptions defines image‑specific rendering settings such as resolution, quality, and output folder for JPEG conversion.

导入所需库

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

设置路径和 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

Explanation: JpgViewOptions lets you control image quality, DPI, and output path.

功能 4：将 TXT 渲染为 PNG

Direct answer: Use PngViewOptions with a desired DPI (e.g., 300) and invoke viewer.view; the result is a lossless PNG image per page, preserving the exact visual layout of the text.

Definition anchor: PngViewOptions provides configuration for rendering documents as PNG images, supporting lossless compression and custom resolution.

导入所需库

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

设置路径和 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

Explanation: PNG provides lossless compression, preserving the exact appearance of the original text.

功能 5：将 TXT 渲染为 PDF (txt to pdf java / convert txt to pdf java)

Direct answer: Instantiate PdfViewOptions, optionally set page size (e.g., A4), then call viewer.view; the library automatically handles pagination, fonts, and resource embedding to produce a high‑fidelity PDF.

Definition anchor: PdfViewOptions controls PDF‑specific rendering aspects such as page size, margins, and font embedding.

导入所需库

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

设置路径和 Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

Explanation: PdfViewOptions handles page layout, fonts, and resource embedding automatically.

实际应用

  1. 文档管理系统： 自动将旧版 TXT 文档转换为 HTML，用于内网门户。
  2. 出版平台： 将作者提交的 TXT 手稿转换为 HTML，实现无缝的 CMS 集成。
  3. 归档解决方案： 将旧文本文件保存为 PDF 或 PNG，以实现长期存储和合规。
  4. 云存储集成： 实时转换并将渲染后的文件存储在 AWS S3、Azure Blob 或 Google Cloud 中。

常见问题及解决方案

问题原因解决方案
输出为空文件路径不正确或缺少读取权限。确认 YOUR_DOCUMENT_DIRECTORY 指向实际的 TXT 文件，并且进程具有读取权限。
图像质量低默认 DPI 较低。使用 JpgViewOptions.setResolution(int dpi) 或 PngViewOptions.setResolution(int dpi) 提高 DPI（例如 300）。
HTML 包含损坏的链接资源未嵌入。使用 HtmlViewOptions.forEmbeddedResources 或提供自定义资源文件夹。
许可证异常未设置有效许可证。在创建 Viewer 之前，使用 License license = new License(); license.setLicense("path/to/license.file"); 加载许可证文件。

常见问题

Q: 我可以使用 GroupDocs.Viewer 转换大型 TXT 文件（数百 MB）吗？
A: 可以。库会对源文件进行流式处理，但对于非常大的文档，您可能需要增大 JVM 堆大小。

Q: 生成 JPG 或 PNG 需要额外的依赖吗？
A: 不需要。Viewer 包已内置所有必需的图像处理库。

Q: 可以自定义 PDF 页面尺寸吗？
A: 完全可以。渲染前使用 PdfViewOptions.setPageSize(PageSize.A4) 或其他 PageSize 即可。

Q: 如何处理受密码保护的 TXT 文件？
A: TXT 文件本身不支持密码。如果文件被加密，需要先解密后再交给 Viewer。

Q: 我能在 Docker 容器中运行此转换吗？
A: 能。只需在容器中包含 JDK，复制包含 GroupDocs 依赖的 pom.xml，然后运行 Java 应用即可。

最后更新： 2026-07-24
测试环境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs

相关教程