Word 轉 PDF (Java):使用 GroupDocs 轉換受保護的 Word 檔案

在本完整教學中,您將學習如何使用 GroupDocs.Conversion 執行 word to pdf java 轉換。我們將示範如何開啟受密碼保護的 Word 文件、選取特定頁面範圍、調整 DPI、旋轉頁面,以及自訂尺寸,以確保產生的 PDF 完全符合您的需求。

快速解答

  • 什麼函式庫負責轉換? GroupDocs.Conversion for Java。
  • 我可以轉換受密碼保護的 Word 檔案嗎? 可以 – 透過 WordProcessingLoadOptions 提供密碼。
  • 如何限制轉換的頁面範圍? 在 PdfConvertOptions 上使用 setPageNumber() 與 setPagesCount()。
  • DPI 可以設定嗎? 當然可以;呼叫 options.setDpi(yourValue)。
  • 需要使用 Maven 來加入 GroupDocs 嗎? 需要 – 包含 Maven 倉庫與相依性(請參閱 Maven groupdocs dependency 章節)。

什麼是 word to pdf java 轉換?

Word to pdf java 轉換是指使用 Java 程式碼將 Microsoft Word 文件轉換為 PDF 檔案的過程。GroupDocs.Conversion 抽象化了複雜的渲染邏輯,讓您專注於安全處理與輸出品質等業務規則。

為什麼在 Java 中使用 GroupDocs 進行 Word 轉 PDF 任務?

GroupDocs.Conversion 支援 超過 50 種輸入與輸出格式,可在不將整個檔案載入記憶體的情況下處理數百頁的文件,且以純 Java 執行——不需要本機二進位檔。這使其非常適合對穩定性與速度有高要求的高吞吐量伺服器環境,同時也能輕鬆整合至現有的 Java 應用程式。

先決條件

  • 已安裝並設定 JDK 8 或更新版本。
  • 具備基本的 Java 開發經驗。
  • 取得 GroupDocs.Conversion 授權(提供免費試用)。

所需函式庫與相依性

若要使用 GroupDocs.Conversion,請在 pom.xml 中加入 Maven 倉庫與相依性:

<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>

授權取得

GroupDocs.Conversion 提供免費試用版以測試功能。若需長期使用,請考慮從 GroupDocs Purchase 取得臨時或正式授權。

設定 GroupDocs.Conversion(Java)

Maven 設定

上述 Maven 片段可確保自動下載所有必要的 JAR。

基本初始化

Converter 類別是負責協調文件載入與轉換的入口點。

建立 Converter 實例並載入受保護的文件:

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
// Set password for protected documents if necessary:
loadOptions.setPassword("your_password_here");

Converter converter = new Converter("path_to_your_document.docx", () -> loadOptions);

loadOptions 物件即是處理 convert password protected word 情境的地方。

實作指南

以下我們將深入探討在健全的 java convert word pdf 工作流程中可能需要的各項功能。

將受密碼保護的文件轉換為 PDF

定義: WordProcessingLoadOptions 指定載入 Word 文件的選項,包含加密檔案的密碼。
定義: PdfConvertOptions 定義 PDF 輸出設定,如頁面範圍、DPI、旋轉與尺寸。

直接回答: 使用 new Converter("input.docx", new WordProcessingLoadOptions("password")) 載入 Word 檔,然後呼叫 converter.convert(new PdfConvertOptions(), "output.pdf") —— 函式庫會解鎖文件並在一步完成 PDF 產生。

步驟實作

  1. 以密碼初始化載入選項 – 提供正確的密碼。
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("12345"); // Replace with your actual password.
  1. 設定 Converter 並執行轉換 – 定義 PDF 選項並執行。
import com.groupdocs.conversion.options.convert.PdfConvertOptions;

String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedDocument.pdf";
PdfConvertOptions options = new PdfConvertOptions();

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleProtectedDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

說明: loadOptions 物件負責解鎖文件,而 PdfConvertOptions 允許您之後微調輸出設定(如有需要)。

指定要轉換的 PDF 頁面

直接回答: 使用 PdfConvertOptions.setPageNumber(startPage) 與 setPagesCount(pageCount) 告訴 GroupDocs 要渲染哪些頁面,然後照常執行轉換。

步驟實作

  1. 設定頁面範圍 – 告訴 Converter 要渲染哪些頁面。
PdfConvertOptions options = new PdfConvertOptions();
options.setPageNumber(2); // Start from page 2.
options.setPagesCount(1); // Convert only one page.
  1. 轉換過程 – 重複使用相同的 Converter 實例。
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SelectedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

說明: setPageNumber() 定義起始頁,setPagesCount() 限制處理的頁數。

在 PDF 轉換中旋轉頁面

直接回答: 在轉換前呼叫 PdfConvertOptions.setRotate(Rotation.On90)(或其他列舉值),即可將每個輸出頁面依選定角度旋轉。

步驟實作

  1. 設定旋轉選項 – 選擇旋轉列舉值。
import com.groupdocs.conversion.options.convert.Rotation;

PdfConvertOptions options = new PdfConvertOptions();
options.setRotate(Rotation.On180); // Rotate pages 180 degrees.
  1. 執行轉換 – 與之前相同的流程。
String convertedFile = "YOUR_OUTPUT_DIRECTORY/RotatedPagesPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

說明: 旋轉可修正橫向掃描或符合特定版面需求。

設定 PDF 轉換的 DPI

直接回答: 在呼叫 convert 前使用 PdfConvertOptions.setDpi(300)(或任意整數)調整影像解析度;較高 DPI 會產生更清晰的圖形,但檔案大小也會增大。

步驟實作

  1. 設定 DPI
PdfConvertOptions options = new PdfConvertOptions();
options.setDpi(300); // Set DPI to 300 for high resolution.
  1. 使用自訂 DPI 執行轉換
String convertedFile = "YOUR_OUTPUT_DIRECTORY/HighResolutionPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

說明: 較高 DPI 提升視覺清晰度,但會增加檔案大小——請依目標媒介選擇。

設定 PDF 轉換的寬度與高度

直接回答: 透過 PdfConvertOptions.setWidth(1240) 與 setHeight(1754) 明確設定像素尺寸,以強制輸出 PDF 符合特定頁面大小。

步驟實作

  1. 定義尺寸
PdfConvertOptions options = new PdfConvertOptions();
options.setWidth(1024); // Set width to 1024 pixels.
options.setHeight(768); // Set height to 768 pixels.
  1. 使用自訂尺寸進行轉換
String convertedFile = "YOUR_OUTPUT_DIRECTORY/SizedPdf.pdf";
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx", () -> loadOptions);
converter.convert(convertedFile, options);

說明: 自訂尺寸有助於產生符合特定螢幕尺寸或列印格式的 PDF。

如何使用 GroupDocs 進行 Word 轉 PDF(Java)?

使用 new Converter("doc.docx", new WordProcessingLoadOptions("pwd")) 載入受保護的 Word 檔,設定所需的 PdfConvertOptions(頁面、DPI、旋轉、尺寸),然後呼叫 converter.convert(options, "output.pdf")。此單行模式處理解密、渲染與檔案寫入,提供可直接投入生產環境的 PDF,且不需外部工具。它可在任何支援 Java 8 以上的平台上執行。

常見問題與解決方案

問題可能原因解決方式
IncorrectPasswordException提供的密碼錯誤再次確認密碼字串,並去除前後空白。
FileNotFoundException檔案路徑無效使用絕對路徑或確認工作目錄。
Output PDF is blurryDPI 設定過低透過 options.setDpi() 提高 DPI。
Pages appear upside‑down未設定旋轉或設定錯誤使用 options.setRotate(Rotation.On180)(或其他列舉值)。
Converted file is larger than expected高 DPI 加上大尺寸降低 DPI 或調整寬度/高度,以在檔案大小與品質之間取得平衡。

常見問答

Q: 我可以轉換同時具備密碼與唯讀保護的 Word 文件嗎?
A: 可以。透過 WordProcessingLoadOptions.setPassword() 提供開啟密碼。轉換過程會忽略唯讀旗標。

Q: GroupDocs.Conversion 是否同時支援 .doc(舊版)與 .docx 檔案?
A: 當然。函式庫會透明地處理兩種格式。

Q: java convert word pdf 的效能在處理大型檔案時如何擴展?
A: GroupDocs 會串流資料並在每次轉換後釋放資源。對於極大檔案,請增大 JVM 堆積大小,並在完成後呼叫 Converter.dispose()。

Q: 是否可以批次轉換多個文件?
A: 可以。遍歷檔案路徑,為每個檔案建立新的 Converter,並在適當情況下重複使用相同的 PdfConvertOptions。

Q: 開發版是否需要商業授權?
A: 免費試用可用於評估,但正式上線的部署需要有效的 GroupDocs.Conversion 授權。


最後更新: 2026-10-10
測試環境: GroupDocs.Conversion 25.2 for Java
作者: GroupDocs

相關教學