我們很高興宣布 GroupDocs.Redaction for Java 26.10 已於 2026年10月 發佈。此版本將從 GroupDocs.Redaction for .NET 26.7 及更早版本挑選的改進移植過來，包括自訂遮蔽支援與改進的影像定位。它還新增了 Word 文件的 OOXML 相容性功能、擴充的試算表範本格式支援，以及 CSV/TAB/TSV 遮蔽行為的修正。

此版本的新功能

  • [Feature] 指定並保留儲存 Word 處理文件時的 OOXML 相容性 (REDACTIONNET-718)
  • [Feature] 新增試算表範本格式 XLT / XLTX / XLTM 以及 TAB；改進 Cells 的儲存格式對映 (REDACTIONNET-802)
  • [Fix] 跳過對僅文字的試算表 CSV / TAB / TSV 的 DrawBox（彩色矩形）遮蔽 (REDACTIONNET-805)
  • [Feature] PDF PageAreaRedaction 的自訂遮蔽處理程式 (ICustomRedactionHandler) (REDACTIONNET-594)
  • [Fix] 修正頁面區域影像遮蔽定位（具有頁面放置與實際尺寸的嵌入式影像）(REDACTIONNET-551)

公開 API 變更

  • 新增 WordProcessingComplianceLevel（Ecma、Transitional、Strict）。
  • 新增 WordprocessingSaveOptions，包含 getOoxmlCompliance / setOoxmlCompliance。
  • 新增 SaveOptions.getWordprocessingSaveOptions()。
  • 新增 ICustomRedactionHandler、CustomRedactionContext、CustomRedactionResult。
  • 新增 ReplacementOptions.getCustomRedaction / setCustomRedaction。
  • 新增 FileType.getXLT()、getXLTX()、getXLTM()、getTAB()。

新功能

此版本引入以下新功能：

  • OOXML 相容性控制：現在您可以在儲存 Word 文件時指定 OOXML 相容性等級。若未設定，將保留原始文件的相容性。Strict 不能直接降級為 Ecma（請使用 Transitional）。
  • 試算表範本格式：FileType 現在提供 Excel 範本類型（.xlt、.xltx、.xltm）以及 .tab，並在 Cells 路徑中正確對映儲存格式。
  • PDF 自訂遮蔽處理程式：ReplacementOptions 現在接受 ICustomRedactionHandler。每次匹配時，處理程式會收到 CustomRedactionContext 並回傳 CustomRedactionResult（套用旗標 + 替換文字）。目前僅支援 PDF PageAreaRedaction。
  • 影像區域定位：具備頁面放置與實際像素尺寸資訊的嵌入式影像會使用頁面座標進行遮蔽，使 PageAreaFilter / ImageAreaRedaction 在位圖尺寸與頁面形狀不一致時仍與可見影像區域對齊。

程式碼範例

以下範例示範如何在儲存已遮蔽的 Word 文件時指定 OOXML 相容性等級：

try (Redactor redactor = new Redactor("sample.docx")) {
    redactor.apply(new ExactPhraseRedaction("John Doe", new ReplacementOptions("[personal]")));

    SaveOptions options = new SaveOptions();
    options.setAddSuffix(true);
    options.setRasterizeToPDF(false);
    options.setRedactedFileSuffix("Strict");
    options.getWordprocessingSaveOptions().setOoxmlCompliance(WordProcessingComplianceLevel.Strict);

    redactor.save(options);
}

下一個範例展示如何為 PDF PageAreaRedaction 使用自訂遮蔽處理程式：

ReplacementOptions optionsText = new ReplacementOptions("[replaced]");
optionsText.setCustomRedaction(new ICustomRedactionHandler() {
    @Override
    public CustomRedactionResult redact(CustomRedactionContext context) {
        CustomRedactionResult result = new CustomRedactionResult();
        if (context.getText() != null && context.getText().contains("Lorem")) {
            result.setApply(true);
            result.setText(context.getText().replace("Lorem", "[redacted-custom]"));
        }
        return result;
    }
});

try (Redactor redactor = new Redactor("sample.pdf")) {
    redactor.apply(new PageAreaRedaction(java.util.regex.Pattern.compile(".*"), optionsText));
    redactor.save(new SaveOptions(false, "Custom_Redaction_Result"));
}

如何取得更新

Maven

透過 Maven 安裝 GroupDocs.Redaction for Java 26.10，只需在 pom.xml 中加入以下相依性：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-redaction</artifactId>
    <version>26.10</version>
</dependency>

您也可以直接從 GroupDocs.Redaction for Java 26.10 Maven repository 下載套件。

直接下載

從 GroupDocs.Redaction for Java 26.10 release page 下載最新的獨立 ZIP，內含 JAR、文件與範例。

資源