如何在 Java 中使用 GroupDocs.Conversion 從 txt 建立 PDF

將純文字檔轉換為精美的 PDF 是在想要在各種裝置上呈現相同外觀資訊時的常見需求。在本教學中，您將學習如何在 Java 中使用功能強大的 GroupDocs.Conversion 函式庫 create pdf from txt，處理自訂字元編碼，並套用效能最佳化設定。完成後，您即可將任何 .txt（無論是 UTF‑8、Shift_JIS 或 ISO‑8859‑1）輸入可靠的轉換流程，產出可直接分享的 PDF。

快速回答

  • 什麼函式庫負責在 Java 中將文字轉換為 PDF？ GroupDocs.Conversion for Java.
  • 哪個方法可使用特定字元集載入文字檔？ TxtLoadOptions.setEncoding.
  • GroupDocs.Conversion 支援多少種格式？ 超過 50 種輸入與輸出格式，包括 PDF、DOCX、XLSX 與影像。
  • 開發時需要授權嗎？ 免費試用可用於測試；正式環境需購買永久授權。
  • 需要哪個版本的 Java？ JDK 8 或以上。

什麼是 create pdf from txt？

從 txt 檔建立 PDF 意味著以程式方式讀取純文字內容、套用所需版面配置，並將結果寫入 PDF 容器，以在各平台上保留視覺外觀。GroupDocs.Conversion 只需幾行 Java 程式碼即可自動化此流程，省去手動排版與第三方工具的依賴。

為何使用 GroupDocs.Conversion for Java？

GroupDocs.Conversion 能在不將整個檔案載入記憶體的情況下處理數百頁文件，支援 50+ 種輸入與輸出格式，且內建字元集偵測，可將轉換錯誤降低至最高 95 %。這些具體的效能使其成為企業級文件流程的首選解決方案，滿足速度、可靠性與低記憶體佔用的需求。

前置條件

  • GroupDocs.Conversion for Java 版本 25.2 或更新版本。
  • 為專案設定 Maven（或其他相依管理工具）。
  • JDK 8 或以上。
  • 具備基本的 Java I/O 知識，並熟悉 UTF‑8、Shift_JIS 等字元編碼。

設定 GroupDocs.Conversion for Java

使用 Maven 安裝

在您的 pom.xml 中加入以下相依片段，即可從 Maven Central 取得最新的穩定版。

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>conversion</artifactId>
    <version>25.2</version>
</dependency>

取得授權步驟

  1. 免費試用 – 從官方頁面下載試用版: GroupDocs Free Trial。
  2. 臨時授權 – 在此產生臨時金鑰: GroupDocs Temporary License Page。
  3. 購買 – 生產環境使用時，請於 GroupDocs Purchase Page 購買完整授權。

基本初始化與設定

Converter 類別是所有轉換操作的入口點。加入 Maven 相依並套用授權後，您即可如以下示範建立 Converter 實例。

// Definition anchor: Converter is the core class that orchestrates file format transformations.
Converter converter = new Converter();

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

實作指南

以下說明如何以自訂編碼載入文字檔並轉換為 PDF。每一步皆附上首次提及之類別或方法的簡短說明。

Txt 文件編碼

使用正確的字元集載入文字檔可避免字元亂碼，特別是使用非 UTF‑8 編碼的語言。

概觀

正確的編碼可確保每個字元——從拉丁字母到日文假名——在最終 PDF 中都能精確呈現。

步驟

  1. 匯入必要的類別
    TxtLoadOptions 讓您指定來源檔案的字元集。
// Definition anchor: TxtLoadOptions configures how a text file is read before conversion.
TxtLoadOptions loadOptions = new TxtLoadOptions();

import com.groupdocs.conversion.License;

License license = new License();
license.setLicense("path/to/your/license.lic");
  1. 指定輸入檔案的路徑
    替換 YOUR_DOCUMENT_DIRECTORY 為您的 .txt 檔案的絕對路徑。
String inputPath = "YOUR_DOCUMENT_DIRECTORY/sample.txt";

import com.groupdocs.conversion.options.load.TxtLoadOptions;
import java.nio.charset.Charset;
  1. 建立並設定 TxtLoadOptions
    設定所需的編碼，例如針對日文舊檔使用 Shift_JIS。
loadOptions.setEncoding("Shift_JIS"); // Change to "UTF-8" or other charset as needed

String txtFilePath = "YOUR_DOCUMENT_DIRECTORY/yourfile.txt"; // Input file path

Txt 文件轉換

在正確載入文字檔後，轉換為 PDF 只需一次方法呼叫。

概觀

轉換為 PDF 可產生與裝置無關的檔案，適合用於歸檔、電子郵件或列印。

步驟

  1. 匯入轉換類別
    PdfConvertOptions 讓您微調 PDF 輸出（例如頁面大小、邊距）。
// Definition anchor: PdfConvertOptions holds optional settings for PDF generation.
PdfConvertOptions pdfOptions = new PdfConvertOptions();

TxtLoadOptions loadOptions = new TxtLoadOptions();
loadOptions.setEncoding(Charset.forName("shift_jis"));
  1. 指定輸出檔案路徑
    調整 YOUR_OUTPUT_DIRECTORY 為您希望儲存 PDF 的位置。
String outputPath = "YOUR_OUTPUT_DIRECTORY/sample.pdf";

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
  1. 初始化轉換器並執行轉換
    傳入 TxtLoadOptions 以確保在轉換過程中套用正確的編碼。
// Direct answer: Call converter.convert(inputPath, loadOptions, outputPath, pdfOptions) to produce the PDF.
converter.convert(inputPath, loadOptions, outputPath, pdfOptions);

String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedFile.pdf"; // Output file path

疑難排解技巧

  • 編碼不匹配 – 確認字元集字串與檔案實際編碼相符，否則字元會顯示為 � 或亂碼。
  • 路徑問題 – 使用絕對路徑或確保工作目錄具備讀寫權限。
  • 大型檔案 – 若檔案大於 100 MB，建議分段處理或增加 JVM 堆積大小 (-Xmx2g)。

實務應用

處理文字編碼與轉換在許多實務情境中至關重要：

  1. 國際化專案 – 無縫將多語言日誌或報告轉換為 PDF，以符合合規需求。
  2. 資料遷移 – 將舊有 .txt 檔案存檔為可搜尋的 PDF，免除手動重新輸入。
  3. 文件管理系統 (DMS) – 自動為上傳的文字檔產生 PDF，提升可搜尋性。
  4. 協作平台 – 提供「下載為 PDF」按鈕，保留原始檔案的字元集。

效能考量

在大量檔案轉換時，保持 Java 服務的回應性：

  • 分段處理 – 將極大的文字檔分割成較小段落，逐段轉換。
  • 快取 – 將常用的轉換結果存於記憶體或分散式快取（如 Redis）。
  • 版本升級 – 更新至最新的 GroupDocs.Conversion 版本；近期版本在記憶體管理上提升最高 30 %，且在一般工作負載下可將轉換時間縮短約 20 %。

常見問題

Q: 我可以使用 GroupDocs.Conversion 轉換除文字文件之外的其他檔案嗎？
A: 可以，函式庫支援 PDF、DOCX、XLSX、PPTX、HTML 以及超過 50 種其他格式，提供單一 API 解決方案以滿足多樣的轉換需求。

Q: 若文字檔包含混合編碼該怎麼辦？
A: 在轉換前先將檔案統一為單一字元集；您可使用如 iconv（用於轉換檔案編碼的指令列工具）或 Java 的 InputStreamReader 搭配明確的字元集偵測來完成。

Q: 如何提升數千檔案的轉換速度？
A: 使用 Java 的 ExecutorService 進行平行轉換（ExecutorService 為管理執行緒池以非同步執行任務的 Java 並行工具），並重複使用同一個 Converter 實例，以避免重複的初始化開銷。

Q: 是否可以自訂 PDF 的外觀（字型、邊距、標頭）？
A: 可以，透過設定 PdfConvertOptions，您可以指定字型族、頁面尺寸、邊距，甚至嵌入自訂浮水印。

Q: 我可以在哪裡找到更詳細的範例與 API 文件？
A: 請參閱官方文件 GroupDocs Documentation，以及專屬的轉換指南 GroupDocs Conversion Java Docs。完整的 API 參考可在 GroupDocs API Reference 找到。

相關教學