如何使用 GroupDocs.Editor 載入受密碼保護的 Word Java 文件

在現代企業應用程式中，how to load password protected word java 檔案是保護機密合約、 人力資源記錄或財務報告的常見需求。本教學將指導您如何載入、編輯及儲存受密碼保護的 Word 文件，使用功能強大的 GroupDocs.Editor Java 函式庫。完成後，您將能自信地將安全文件處理整合至任何基於 Java 的解決方案。

快速解答

  • GroupDocs.Editor 能開啟受密碼保護的 DOCX 檔案嗎？ 是的，只需透過 WordProcessingLoadOptions 提供密碼即可。
  • 開發時需要授權嗎？ 免費試用授權可用於測試；正式環境需購買商業授權。
  • 需要哪個 Java 版本？ JDK 8 或以上。
  • 大型檔案的記憶體使用是否已最佳化？ 是——GroupDocs.Editor 以串流方式處理資料，避免將整個檔案載入 RAM。
  • 我也可以對儲存的文件設定寫入保護嗎？ 當然可以，使用 WordProcessingSaveOptions 並設定寫入保護密碼。

GroupDocs.Editor for Java 是什麼？

GroupDocs.Editor for Java 是一套伺服器端函式庫，允許以程式方式載入、編輯與儲存 Word、Excel、PowerPoint 以及 PDF 檔案，無需 Microsoft Office。它支援超過 50 種輸入與輸出格式，且能處理數百頁的文件，同時保持低記憶體消耗。

為何在受密碼保護的 Word 文件中使用 GroupDocs.Editor？

GroupDocs.Editor 支援 50+ 種文件格式，且可在一般伺服器硬體上於 0.2 秒以下 開啟加密檔案。其串流架構意味著 300 頁的 DOCX 檔案所佔用的 RAM 永不超過 30 MB，這使其非常適合必須遵守嚴格安全政策的高吞吐量 Web 服務。

前置條件

  • Java Development Kit (JDK)： 版本 8 或以上。
  • Maven： 用於相依性管理（或可直接下載 JAR）。
  • IDE： IntelliJ IDEA、Eclipse 或任何相容 Java 的編輯器。
  • 基本 Java 知識： 熟悉串流與例外處理將有助於開發。

必要的函式庫、版本與相依性

要開始使用 GroupDocs.Editor for Java，請確保您已擁有：

  • GroupDocs.Editor for Java（最新穩定版）。
  • Maven 用於加入相依性，或從官方網站下載 JAR。

環境設定需求

在 IDE 中設定 Maven 支援，或將 JAR 加入專案的 classpath。確認 JAVA_HOME 環境變數指向您的 JDK 安裝位置。

知識前置條件

了解 Java I/O 串流與基本的物件導向概念，將使實作更加順暢。

設定 GroupDocs.Editor for Java

您可以透過 Maven 或直接下載函式庫的方式，將 GroupDocs.Editor 加入專案。

Maven 設定

Add the following dependency to your pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/editor/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-editor</artifactId>
      <version>25.3</version>
   </dependency>
</dependencies>

直接下載

或者，從 GroupDocs.Editor for Java releases 下載最新版本。

取得授權

取得免費試用授權以探索 GroupDocs.Editor 的功能，或在需要時申請臨時授權。長期使用時，建議購買正式授權。

實作指南

以下我們將分解 how to load password protected word java 檔案的關鍵步驟、表單欄位管理，以及以寫入保護方式儲存文件。

如何在 Java 中載入受密碼保護的 Word 文件？

WordProcessingLoadOptions 定義載入 Word 文件的選項，包括加密檔案的密碼。
若要載入受保護的 DOCX，請以所需密碼實例化 WordProcessingLoadOptions，然後建立 Editor 物件，傳入檔案路徑與載入選項。編輯器會在記憶體中解密文件，讓您能讀取或修改內容，同時將密碼限制在此範圍內。

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("YourPassword");
Editor editor = new Editor(new FileInputStream("protected.docx"), loadOptions);

在 Word 文件中管理表單欄位

FormFieldManager 讓您列舉、讀取與修改表單欄位，例如文字方塊、核取方塊或下拉清單。

Editor editor = new Editor(new FileInputStream("sample.docx"));
FormFieldManager fieldManager = editor.getFormFieldManager();
FormFieldCollection fields = fieldManager.getFormFieldCollection();
TextFormField textField = fields.getFormField("Text1");
textField.setValue("Updated value");

以寫入保護方式儲存文件

WordProcessingSaveOptions 設定文件的儲存方式，包括輸出格式與寫入保護密碼。
完成編輯後，您可以使用新密碼儲存檔案，以防止進一步的修改。

WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions();
saveOptions.setWriteProtectionPassword("NewWritePassword");
editor.save("output.docx", saveOptions);

大檔案的記憶體最佳化儲存

OptimizationMode.Memory 啟用串流模式，讓大型檔案以分塊方式處理，而非完整載入記憶體。
對於超過 100 MB 的文件，請啟用串流以降低 RAM 使用量：

saveOptions.setOptimizationMode(OptimizationMode.Memory);

常見問題與解決方案

  • 密碼錯誤： 確認密碼字串完全相符，包含大小寫。
  • 找不到檔案： 使用絕對路徑或確認工作目錄正確。
  • 大型檔案記憶體不足： 如上所示啟用 OptimizationMode.Memory。
  • 表單欄位未更新： 修改欄位後呼叫 editor.save；變更會保留在記憶體中直至儲存。

常見問答

Q: 我可以使用相同程式碼載入 .docx 與 .doc 檔案嗎？
A: 是的，WordProcessingLoadOptions 同時支援現代 (.docx) 與舊版 (.doc) 格式。

Q: 是否可以移除文件的密碼保護？
A: 使用現有密碼載入文件，然後在 WordProcessingSaveOptions 中不設定新密碼即可儲存。

Q: GroupDocs.Editor 是否支援同時編輯同一檔案？
A: 此函式庫對讀取操作為執行緒安全；寫入時需序列化存取以避免衝突。

Q: 支援的最大檔案大小是多少？
A: GroupDocs.Editor 可處理最高 2 GB 的檔案，僅受限於底層 JVM 堆積與作業系統檔案系統的限制。

Q: 伺服器上需要安裝 Microsoft Office 嗎？
A: 不需要，GroupDocs.Editor 是純 Java 解決方案，無需任何 Office 元件。

結論

您現在已掌握完整且可投入生產的 how to load password protected word java 文件處理方法，使用 GroupDocs.Editor 編輯表單欄位並以寫入保護方式儲存。將這些程式碼片段整合至服務層，加入適當的例外處理，即可在保持高效能的同時符合嚴格的安全合規要求。

最後更新： 2026-06-01
測試環境： GroupDocs.Editor for Java 23.10
作者： GroupDocs

import com.groupdocs.editor.Editor;
import com.groupdocs.editor.options.WordProcessingLoadOptions;

public class LoadWordDocument {
    public static void main(String[] args) throws Exception {
        String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample_legacy_form_fields.docx";
        
        InputStream fs = new FileInputStream(inputFilePath);
        
        WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
        loadOptions.setPassword("some_password_to_open_a_document");
        
        Editor editor = new Editor(fs, loadOptions);
    }
}

相關教學