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。

快速解答
- 需要哪個 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 購買授權。
基本初始化與設定
- 加入上述的 Maven 依賴。
- 確認 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 會自動處理頁面布局、字型與資源嵌入。
實務應用
- 文件管理系統: 自動將舊有 TXT 文件轉換為 HTML,以供內部入口網站使用。
- 出版平台: 將作者提交的 TXT 手稿轉換為 HTML,實現無縫的 CMS 整合。
- 歸檔解決方案: 將舊文字檔保存為 PDF 或 PNG,以供長期存儲。
- 雲端儲存整合: 即時轉換並將渲染後的檔案存放於 AWS S3、Azure Blob 或 Google Cloud。
常見問題與解決方案
| Issue | Cause | Fix |
|---|---|---|
| 輸出為空白 | 檔案路徑不正確或缺少讀取權限。 | 確認 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