groupdocs viewer maven:使用 GroupDocs.Viewer for Java 將 TXT 檔案轉換為 HTML、JPG、PNG 與 PDF

在現代的 Java 應用程式中,groupdocs viewer maven 能輕鬆將純文字 (TXT) 文件轉換為可於網頁使用的 HTML、高解析度影像或可攜式 PDF 檔案。無論您是建立文件入口網站、歸檔服務或預覽功能,使用 GroupDocs.Viewer 轉換 TXT 檔案都能節省時間,且不需自行開發解析器。本指南將逐步說明完整設定,並示範如何 convert txt files java 轉換為 HTML(單頁與多頁)、JPG、PNG 與 PDF。

使用 GroupDocs.Viewer for Java 將 TXT 檔案轉換為 HTML、JPG、PNG 與 PDF

快速解答

  • 需要哪個 Maven 套件? com.groupdocs:groupdocs-viewer(請參考下方 Maven 片段)。
  • 可以渲染多頁 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?

  • 跨平台預覽 – HTML 與影像可在瀏覽器或行動應用程式中顯示。
  • 標準化歸檔 – PDF 能保留格式,且可在任何平台閱讀。
  • 自動化友好 – 可將轉換整合至批次工作、雲端服務或 CI 流程。

前置條件

  • GroupDocs.Viewer for Java 版本 25.2 或更新(透過 Maven 提供)。
  • JDK 8 以上(建議使用 Java 11 以上)。
  • 支援的 IDE,例如 IntelliJ IDEA、Eclipse 或 NetBeans。
  • 具備基本的 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>

取得授權步驟

  • 先使用 免費試用 或取得 臨時授權 以探索完整功能。
  • 正式環境請透過官方 purchase page 購買授權。

基本初始化與設定

  1. 加入上述的 Maven 依賴。
  2. 確認 JDK 與 IDE 已正確設定。

現在讓我們深入具體的轉換情境。

實作指南

功能 1:將 TXT 渲染為多頁 HTML (multi page html java)

概述

此範例將 TXT 文件轉換為 多頁 HTML 檔案,並在不同網頁間保留換行。

Import Required Libraries

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);
}

說明: HtmlViewOptions.forEmbeddedResources 會將 CSS、字型與影像直接打包至 HTML 輸出,使其具備可攜性。

功能 2:將 TXT 渲染為單頁 HTML (convert txt to html java)

概述

將整個文字檔濃縮為單一 HTML 頁面——適合快速預覽。

Import Required Libraries

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);
}

說明: setRenderToSinglePage(true) 會將所有頁面合併為單一 HTML 檔案。

功能 3:將 TXT 渲染為 JPG

概述

將 TXT 檔案轉換為高品質 JPEG 影像,適用於僅接受影像的平台分享。

Import Required Libraries

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);
}

說明: JpgViewOptions 讓您可控制影像品質、DPI 與輸出路徑。

功能 4:將 TXT 渲染為 PNG

概述

從文字檔產生無損 PNG 影像——在需要清晰、可縮放圖形時非常理想。

Import Required Libraries

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);
}

說明: PNG 提供無損壓縮,保留原始文字的完整外觀。

功能 5:將 TXT 渲染為 PDF (txt to pdf java / convert txt to pdf java)

概述

從 TXT 文件建立 PDF 檔案——適合歸檔、列印或傳送給客戶。

Import Required Libraries

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);
}

說明: PdfViewOptions 會自動處理頁面布局、字型與資源嵌入。

實務應用

  1. 文件管理系統: 自動將舊有 TXT 文件轉換為 HTML,以供內部入口網站使用。
  2. 出版平台: 將作者提交的 TXT 手稿轉換為 HTML,實現無縫的 CMS 整合。
  3. 歸檔解決方案: 將舊文字檔保存為 PDF 或 PNG,以供長期存儲。
  4. 雲端儲存整合: 即時轉換並將渲染後的檔案存放於 AWS S3、Azure Blob 或 Google Cloud。

常見問題與解決方案

IssueCauseFix
輸出為空白檔案路徑不正確或缺少讀取權限。確認 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-02-21
測試環境: GroupDocs.Viewer 25.2 for Java
作者: GroupDocs