如何在 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 個編輯工作階段。
- Maven 設定 – 在上方加入儲存庫與相依項目。
- 直接下載 – 若偏好手動加入 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 參考文件,以了解協同編輯等進階情境。
常見問題
- 可以在沒有授權的情況下使用 GroupDocs.Editor 嗎?
可以,免費試用版可供評估,但生產環境必須取得授權。 - GroupDocs.Editor 相容所有 Word 版本嗎?
完全支援由 Word 2007 到 Word 2021 產生的 DOCX、DOC 與 DOCM 檔案。 - 函式庫如何處理大型檔案?
透過串流與optimizeMemoryUsage,可在不將整個檔案載入記憶體的情況下處理最高 500 MB 的文件。 - 可以將 GroupDocs.Editor 與 Spring Boot 整合嗎?
當然可以,只需在 Maven 中宣告相依,並在需要的地方注入Editor。 - 遇到問題該向哪裡尋求協助?
前往 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