如何使用 GroupDocs.Editor Java 保護 Word 文件

有效管理舊版文件格式在當今數位環境中至關重要。在本指南中，您將學習 如何保護 Word 文件，透過修復無效的表單欄位、使用 Java 載入與編輯 Word 檔案，並以最佳化的記憶體使用方式儲存，以實現可靠的高吞吐量處理。

GroupDocs.Editor 是一個 Java 函式庫，提供統一的 API 用於編輯、轉換以及保護超過 30 種文件格式，且不需要 Microsoft Office。它直接在記憶體中串流文件，即使處理大型檔案也能保持 JVM 的健康狀態。

快速答案

  • 「修復欄位」是什麼意思？ 它會自動糾正 Word 檔案中無效或重複的表單欄位名稱。
  • 哪個函式庫負責此功能？ GroupDocs.Editor for Java 包含內建的工具以完成此任務。
  • 我需要授權嗎？ 免費試用可用於評估；正式環境需購買授權。
  • 我可以處理大型檔案嗎？ 可以——在儲存選項中啟用記憶體最佳化，以串流大型文件。
  • 支援「load word document java」嗎？ 當然支援；API 可直接載入 DOCX、DOC 以及較舊的 Word 格式。
  • 編輯後如何保護文件？ 在儲存時使用 WordProcessingProtectionType.AllowOnlyFormFields。

「保護 Word」是什麼以及為何重要？

保護 Word 文件可防止意外編輯，同時仍允許指定的表單欄位填寫。這可維護版面完整性，確保符合法律標準，並減少因隨意修改而導致的下游處理錯誤。此外，保護會鎖定主要內容，只允許預定的欄位被編輯，這對於受規範的工作流程和資料敏感的環境至關重要。

為何使用 GroupDocs.Editor for Java 編輯 Word 文件？

GroupDocs.Editor 會自動修正無效的表單欄位，支援超過 30 種輸入與輸出格式——包括 DOC、DOCX、ODT 與 RTF，且能在不將整個文件載入記憶體的情況下處理數百頁的檔案。此函式庫亦提供內建的保護選項，讓您鎖定文件，使僅表單欄位可編輯，提升自動化工作流程中的資料完整性。

前置條件

  • 必要的函式庫與相依性： GroupDocs.Editor for Java 版本 25.3。
  • 環境設定： 具備 JDK 11 或以上的 Java IDE，例如 IntelliJ IDEA 或 Eclipse。
  • 基本知識： 熟悉 Java 程式設計與 Maven 以管理相依性。

設定 GroupDocs.Editor for Java

要將 GroupDocs.Editor 整合至您的專案，可使用 Maven 或直接下載。

Maven 設定

將以下相依性加入您的 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 下載最新版本。

取得授權步驟

  • 免費試用： 先使用免費試用版以探索基本功能。
  • 臨時授權： 申請延長存取權限，無評估限制。
  • 購買： 取得完整授權以供長期正式使用。

加入相依性或下載函式庫後，讓我們在 Java 專案中初始化並設定 GroupDocs.Editor。

如何在修復欄位時保護 Word 文件

本節將說明三個核心操作：載入文件、修復無效的表單欄位，以及以保護方式儲存編輯後的檔案。遵循這些步驟，您將確保文件的欄位名稱無問題且受到保護，僅允許預定的表單區域可編輯，這對於合規驅動的自動化流程至關重要。

使用 GroupDocs.Editor 載入文件（load word document java）

Editor 是編輯 Word 文件的主要類別。
WordProcessingLoadOptions 用於設定載入參數，例如密碼。

直接答案： 透過為檔案建立 InputStream、設定 WordProcessingLoadOptions（如需密碼則包含），並將兩者傳入 Editor 建構子，即可載入您的 Word 檔案，從而在一步完成取得可完全編輯的 Editor 實例。

1. 定義文件路徑

設定存放文件的目錄路徑：

private static final String YOUR_DOCUMENT_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY";

2. 從檔案建立 InputStream

開啟檔案串流以讀取文件內容：

String inputFilePath = YOUR_DOCUMENT_DIRECTORY + "/SampleLegacyFormFields.docx";
InputStream fs = new FileInputStream(inputFilePath);

3. 設定載入選項

建立載入選項，指定受保護文件所需的密碼（如有）：

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("some_password_to_open_a_document");

4. 初始化編輯器

使用指定的選項載入文件至 Editor 實例：

Editor editor = new Editor(fs, loadOptions);

修復文件中的無效表單欄位（自動化文件編輯）

FormFieldManager 管理文件內的表單欄位。

直接答案： 從 Editor 取得 FormFieldManager，呼叫 fixInvalidFormFieldNames() 以自動修正明顯問題，然後檢查 getInvalidFormFieldNames()；對於剩餘的名稱，產生唯一識別碼並再次呼叫 fixInvalidFormFieldNames()，以確保每個欄位皆有效。

1. 取得 FormFieldManager

從已初始化的 Editor 實例取得 FormFieldManager：

FormFieldManager fieldManager = editor.getFormFieldManager();

2. 自動修復無效表單欄位

嘗試首次自動修正任何無效的表單欄位：

fieldManager.fixInvalidFormFieldNames(new ArrayList<>());

3. 驗證剩餘的無效欄位

檢查是否仍有未解決的無效欄位，並收集其名稱：

boolean hasInvalidFormFields = fieldManager.hasInvalidFormFields();
Collection<com.groupdocs.editor.words.fieldmanagement.InvalidFormField> invalidFormFields = fieldManager.getInvalidFormFieldNames();

4. 為無效欄位產生唯一名稱

為每個剩餘的無效欄位建立唯一識別碼，以避免衝突：

for (com.groupdocs.editor.words.fieldmanagement.InvalidFormField invalidItem : invalidFormFields) {
    invalidItem.setFixedName(String.format("%s_%s", invalidItem.getName(), java.util.UUID.randomUUID()));
}

5. 使用唯一名稱套用修正

使用新產生的唯一名稱解決無效的表單欄位：

fieldManager.fixInvalidFormFieldNames(new ArrayList<>(invalidFormFields));

使用 GroupDocs.Editor 儲存文件（保護 Word 文件）

WordProcessingSaveOptions 定義文件的儲存方式，包括格式與保護設定。
WordProcessingProtectionType.AllowOnlyFormFields 會鎖定文件，使僅表單欄位可編輯。

直接答案： 設定 WordProcessingSaveOptions 為所需的輸出格式，啟用 setOptimizeMemoryUsage(true) 以進行串流，並設定 setProtectionType(WordProcessingProtectionType.AllowOnlyFormFields) 以鎖定文件——最後將結果寫入輸出串流。

1. 設定儲存選項

定義文件的儲存格式與設定：

WordProcessingFormats docFormat = WordProcessingFormats.Docx;
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(docFormat);
saveOptions.setOptimizeMemoryUsage(true);

// Set protection to allow only form fields with a password
saveOptions.setProtection(new com.groupdocs.editor.options.WordProcessingProtection(
    com.groupdocs.editor.options.WordProcessingProtectionType.AllowOnlyFormFields,
    "write_password"));

2. 儲存文件

將編輯後的文件寫入輸出串流：

ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
editor.save(outputStream, saveOptions);

常見使用情境

  • 大量文件準備： 在匯入 CRM 或 ERP 系統前，清理數千份舊版表單。
  • 法律合約工作流程： 保護合約，使僅簽名與日期欄位可編輯，保留法律文本。
  • 企業報告： 透過修正欄位名稱並對最終版本套用唯讀保護，標準化匯出的 Word 報告。

效能考量

處理大型文件時，請留意以下建議：

  • 最佳化記憶體使用： setOptimizeMemoryUsage(true) 會串流文件並減少堆積記憶體壓力，使在 2 GB 堆積上處理 200 頁檔案成為可能。
  • JVM 調校： 根據批次大小調整 -Xmx 參數；例如，-Xmx4g 可安全同時處理多個 100 MB 檔案。
  • 重複使用編輯器實例： 在多個檔案間重用相同的 Editor 物件，可將初始化開銷降低最多 30 %。

常見問題與解決方案

問題原因解決方案
未偵測到無效欄位，但變更未儲存儲存選項缺少 setOptimizeMemoryUsage啟用記憶體最佳化並重新儲存
受密碼保護的檔案無法開啟WordProcessingLoadOptions 中的密碼不正確確認密碼，或若檔案未受保護則省略此選項
重複的欄位名稱仍然存在在產生唯一名稱之前呼叫 fixInvalidFormFieldNames先執行唯一名稱迴圈，然後再次呼叫 fixInvalidFormFieldNames

常見問答

問：GroupDocs.Editor 是否相容所有版本的 Word 文件？
答： 它支援 DOC、DOCX、DOCM、ODT、RTF 以及許多舊版格式——總計超過 30 種。

問：API 如何處理非常大的檔案（100 MB 以上）？
答： 啟用 setOptimizeMemoryUsage(true) 可串流檔案，即使是 500 頁的文件，峰值記憶體使用仍低於 150 MB。

問：開發階段需要授權嗎？
答： 免費試用足以進行評估；正式部署則需購買授權。

問：我可以保護儲存的文件，使僅表單欄位可編輯嗎？
答： 可以——在儲存選項中設定 WordProcessingProtectionType.AllowOnlyFormFields，如範例所示。

問：如果自動修正步驟後仍有欄位無效，該怎麼辦？
答： 透過 getInvalidFormFieldNames() 取得清單，分配唯一名稱，然後再次呼叫 fixInvalidFormFieldNames() 以解決問題。

結論

在本教學中，您學會了 如何保護 Word 文件並使用 GroupDocs.Editor for Java 修復無效的表單欄位。透過載入檔案、自動校正欄位名稱，並以保護與記憶體最佳化的方式儲存，您可以建立穩健且高吞吐量的文件管線，維持資料完整性並符合安全政策。

下一步：

  • 嘗試其他編輯功能，例如文字取代、圖像插入或自訂欄位映射。
  • 探索 GroupDocs.Editor API 參考文件，以了解批次處理與雲端儲存整合等進階情境。

最後更新： 2026-08-26
測試版本： GroupDocs.Editor Java 25.3
作者： GroupDocs

相關教學