如何在 Java 中編輯 Word 文件時移除表單欄位

如果您需要以程式方式 移除 Word 文件中的表單欄位,GroupDocs.Editor for Java 提供一套乾淨且記憶體效能高的 API,支援受保護與未受保護的檔案。無論您是建置文件產生服務、清理舊有範本,或是保護敏感內容,本教學將逐步說明如何載入、編輯與儲存 Word 檔案,並使用最佳實踐選項。

快速回答

  • GroupDocs.Editor 能開啟受密碼保護的檔案嗎? 可以,只要在 WordProcessingLoadOptions 中提供密碼即可。
  • 哪個選項可減少大型文件的記憶體使用量? 在 WordProcessingSaveOptions 中使用 setOptimizeMemoryUsage(true)。
  • 如何移除特定的表單欄位? 呼叫 FormFieldManager.removeFormField(fieldName)。
  • 生產環境需要授權嗎? 試用版可供評估,完整授權解鎖全部功能。
  • 需要哪個 Java 版本? JDK 8 或以上。

前置條件

  • Java Development Kit (JDK) 8 或更新版本。
  • IDE – IntelliJ IDEA、Eclipse 或 NetBeans。
  • Maven 用於相依管理。

必要函式庫

在 Maven 專案中加入 GroupDocs.Editor:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor</artifactId>
    <version>25.3</version>
</dependency>
<repositories>
   <repository>
      <id>groupdocs-repo</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 版本 下載二進位檔。

或者,直接從 GroupDocs.Editor for Java 版本 下載函式庫。

環境設定

確保已正確安裝並設定 Maven 與 JDK。若您對這兩個工具不熟,請參考官方安裝指南。

設定 GroupDocs.Editor for Java

GroupDocs.Editor 支援 30+ 輸入與輸出格式,且可在不將整個檔案載入記憶體的情況下處理最高 500 MB 的文件,透過串流架構可減少最高 70 % 的 RAM 使用量。它亦能在標準 8 核心伺服器上同時處理多達 1,000 個編輯工作階段。

  1. Maven 設定 – 在上方加入儲存庫與相依項目。
  2. 直接下載 – 若偏好手動加入 JAR,請使用相同的發行連結。

授權取得

  • 免費試用 – 下載後即可免費評估。
  • 完整授權 – 購買或申請臨時金鑰,以解鎖批次處理與高級支援等進階功能。

如何使用 GroupDocs.Editor 載入 Word 文件?

FileInputStream 是 Java I/O 類別,用於從檔案讀取位元組。WordProcessingLoadOptions 設定開啟選項(如密碼)。Editor 為核心 GroupDocs.Editor 類別,用於載入、編輯與儲存文件。要載入 Word 檔案,只需建立 FileInputStream,在載入選項中可選擇設定密碼,然後將兩者傳入 Editor 建構子,文件將以串流方式處理,無需完整載入記憶體。

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample_docx";
InputStream inputStream = new FileInputStream("path/to/document.docx");
InputStream fs = new FileInputStream(inputFilePath);
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("yourPassword"); // Omit if the document is not protected
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("some_password_to_open_a_document");
Editor editor = new Editor(inputStream, loadOptions);
Editor editor = new Editor(fs, loadOptions);

為什麼重要: 必須提供正確的密碼,否則函式庫會將檔案視為未受保護,可能拋出例外。

如何使用 GroupDocs.Editor 從 Word 文件中移除表單欄位?

FormFieldManager 管理已載入 Word 文件中的表單欄位,提供取得、加入與移除功能。從 Editor 例項取得後,呼叫 removeFormField 並傳入目標欄位名稱,即可在儲存前將該欄位從文件結構中刪除,確保最終輸出不會出現該欄位。

FormFieldManager fieldManager = editor.getFormFieldManager();
FormFieldManager fieldManager = editor.getFormFieldManager();
String textFieldName = "Text1";
fieldManager.removeFormField(fieldManager.getFormField(textFieldName,
    com.groupdocs.editor.words.fieldmanagement.TextFormField.class));
fieldManager.removeFormField("CustomerName");
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docx);
saveOptions.setOptimizeMemoryUsage(true); // Optimize for large documents
saveOptions.setProtection(com.groupdocs.editor.options.WordProcessingProtection.
    new com.groupdocs.editor.words.fieldmanagement.WordProcessingProtection(
        com.groupdocs.editor.words.fieldmanagement.WordProcessingProtectionType.AllowOnlyFormFields, "write_password"));

為什麼重要: 在自動化工作流程中,遺留或未使用的欄位會導致驗證錯誤,移除它們可確保文件乾淨。

如何在 Java 中以最佳化記憶體使用方式儲存 Word 文件?

WordProcessingSaveOptions 控制文件的儲存方式,包括格式、寫入密碼與記憶體最佳化。建立實例後,啟用 setOptimizeMemoryUsage(true),可選擇設定寫入密碼,然後將其傳給 editor.save。函式庫會以分塊方式寫入檔案,顯著降低 RAM 消耗,避免大型文件產生 OutOfMemoryError。

ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
editor.save(outputStream, saveOptions);
WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions();
saveOptions.setOptimizeMemoryUsage(true);
saveOptions.setWritePassword("newPassword");
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
editor.save(outputStream, saveOptions);

為什麼重要: 為大型文件(數百頁)啟用 optimizeMemoryUsage 可防止在一般伺服器配置下發生記憶體不足的情況。

實務應用

  • 批次文件自動化 – 每晚處理數千個 Word 檔案而不會耗盡伺服器 RAM。
  • 動態範本個人化 – 根據使用者輸入即時加入或移除欄位。
  • 安全文件分發 – 套用寫入密碼保護,同時允許表單欄位編輯。

效能考量

  • 記憶體最佳化 – setOptimizeMemoryUsage(true) 可將 200 頁文件的堆積使用量降低至 70 %。
  • 串流管理 – 請務必關閉串流(建議使用 try‑with‑resources),以避免資源泄漏。
  • 版本更新 – 保持 GroupDocs.Editor 為最新版本;每次發行皆會加入新格式支援與效能修補。

結論

現在您已了解 如何在 Java 中使用 GroupDocs.Editor 移除表單欄位並編輯 Word 文件:載入(即使受保護)、操作表單欄位,並以記憶體節省與保護選項儲存。將這些程式碼片段整合到您的服務中,可提升生產力與可靠性。

後續步驟:

  • 嘗試其他 WordProcessingFormats(如 PDF 或 HTML)。
  • 結合編輯與轉換功能,打造端對端文件管線。
  • 查閱官方 API 參考文件,以了解協同編輯等進階情境。

常見問題

  1. 可以在沒有授權的情況下使用 GroupDocs.Editor 嗎?
    可以,免費試用版可供評估,但生產環境必須取得授權。
  2. GroupDocs.Editor 相容所有 Word 版本嗎?
    完全支援由 Word 2007 到 Word 2021 產生的 DOCX、DOC 與 DOCM 檔案。
  3. 函式庫如何處理大型檔案?
    透過串流與 optimizeMemoryUsage,可在不將整個檔案載入記憶體的情況下處理最高 500 MB 的文件。
  4. 可以將 GroupDocs.Editor 與 Spring Boot 整合嗎?
    當然可以,只需在 Maven 中宣告相依,並在需要的地方注入 Editor。
  5. 遇到問題該向哪裡尋求協助?
    前往 GroupDocs 支援論壇 獲取協助。

Frequently asked questions

Q: 如何編輯受密碼保護的 Word 檔案?
A: 在建立 Editor 實例前,於 WordProcessingLoadOptions.setPassword() 設定密碼。

Q: 能否將文件儲存為除 DOCX 之外的格式?
A: 可以——WordProcessingSaveOptions 支援 PDF、RTF、HTML 等格式,透過 WordProcessingFormats 列舉設定。

Q: optimize memory usage java 實際上做了什麼?
A: 它將文件分塊串流處理,避免整個檔案佔用堆積記憶體,特別適合大型文件。

Q: 能一次移除所有表單欄位嗎?
A: 迭代 fieldManager.getFormFields(),對每個條目呼叫 removeFormField 即可。

Q: 必須手動關閉串流嗎?
A: 必須——使用 try‑with‑resources 或自行關閉 InputStream、OutputStream 以釋放資源。


最後更新: 2026-10-27
測試環境: GroupDocs.Editor 25.3 for Java
作者: GroupDocs

相關教學