如何在使用 GroupDocs.Conversion for Java 的 Word‑PDF 转换中使用选项隐藏修订更改

将 Word 文档转换为 PDF 并手动隐藏修订更改可能很繁琐，尤其是当您需要一次性 convert word to pdf 多个文件时。在本教程中，您将学习 how to use options，在使用 GroupDocs.Conversion for Java 的转换过程中自动隐藏修订更改。完成后，您将获得干净、可直接用于生产的 PDF，且没有任何残留的编辑标记。

快速回答

  • What does “hide tracked changes” do? 它会自动从最终的 PDF 中移除修订标记。
  • Which library supports this? GroupDocs.Conversion for Java 提供了专用的加载选项。
  • Can I batch convert docx pdf files? 是的 – 将该选项与循环结合，可处理大量文档。
  • What Java version is required? JDK 8 或更高。
  • Do I need a license? 免费试用可用于评估；生产环境需要永久许可证。

在此上下文中 “how to use options” 是什么？

使用选项意味着在实际转换运行之前配置转换引擎（加载选项、转换选项等）。这为您提供了细粒度的控制，例如隐藏修订更改、设置页面尺寸或定义图像质量。

为什么在转换过程中隐藏修订更改？

  • Professional output – 客户将收到没有可见编辑的干净 PDF。
  • Legal compliance – 移除可能敏感的修订数据。
  • Time saver – 消除在 Word 中手动关闭跟踪的步骤。

前提条件

  • Java Development Kit (JDK) 8 或更高。
  • Maven 用于依赖管理。
  • 基本的 Java 编码技能。

设置 GroupDocs.Conversion for Java

首先，将 GroupDocs 仓库和转换依赖添加到您的 Maven pom.xml 中。

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

获取许可证

如何使用选项隐藏修订更改

以下是逐步实现。每个代码块都保持原样。

步骤 1：设置加载选项

创建 WordProcessingLoadOptions 并启用 hide‑tracked‑changes 标志。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

// Create load options to hide tracked changes
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setHideWordTrackedChanges(true); // Hide tracked changes during conversion

步骤 2：使用加载选项初始化 Converter

将加载选项传递给 Converter 构造函数。

String inputFile = "YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX_WITH_TRACKED_CHANGES";
String outputFile = "YOUR_OUTPUT_DIRECTORY/ConvertWordProcessingByHiddingTrackedChanges.pdf";

// Create a Converter object using the input file and load options
Converter converter = new Converter(inputFile, () -> loadOptions);

步骤 3：配置 PDF 转换选项

您可以在此自定义 PDF 输出；示例使用默认设置。

PdfConvertOptions pdfOptions = new PdfConvertOptions(); // Customize options as needed
converter.convert(outputFile, pdfOptions); // Perform the conversion

使用自定义加载选项加载文档（替代方法）

如果您希望为多个文件重用相同的选项，请创建专用的 converter 实例。

步骤 1：定义加载选项

WordProcessingLoadOptions wordLoadOptions = new WordProcessingLoadOptions();
wordLoadOptions.setHideWordTrackedChanges(true); // Example of setting a specific option

步骤 2：使用自定义加载选项初始化 Converter

Converter converterWithOptions = new Converter(inputFile, () -> wordLoadOptions);
// Conversion can now be performed using the `converterWithOptions` object.

实际应用

  1. Legal Document Management – 自动为客户审阅生成干净的 PDF。
  2. Academic Publishing – 在期刊提交前移除编辑标记。
  3. Business Reporting – 确保最终报告不包含任何零散的修订。

性能考虑

  • Memory Management – 及时关闭流，并在可能时重用 Converter 实例。
  • Streaming API – 对非常大的 .docx 文件使用流式处理，以保持低内存使用。
  • Batch Processing – 在循环遍历文件列表时重用相同的 loadOptions，以高效 batch convert docx pdf。

常见问题与故障排除

  • Tracked changes still appear – 确认在创建 Converter 之前已调用 setHideWordTrackedChanges(true)。
  • Conversion fails on large files – 增加 JVM 堆大小或以流式模式处理文件。
  • License errors – 确保许可证文件放置正确且试用期未过期。

常见问答

Q: 我可以使用 GroupDocs.Conversion 转换除 DOCX 之外的文档吗？
A: 是的，库支持 PPTX、XLSX、PDF 以及许多其他格式。

Q: 哪些 Java 版本与 GroupDocs.Conversion 兼容？
A: 需要 JDK 8 或更高版本。

Q: 我该如何排查转换错误？
A: 检查异常堆栈跟踪，确认输入文件未损坏，并确保许可证有效。

Q: 是否可以在隐藏修订更改之外自定义 PDF 输出？
A: 当然。可查看 PdfConvertOptions，其中包含 DPI、页面范围和水印等设置。

Q: GroupDocs.Conversion 能高效处理批量转换吗？
A: 可以，您可以在循环遍历文件时重用相同的加载选项，以快速 batch convert docx pdf。

结论

您现在了解了 how to use options，即在使用 GroupDocs.Conversion for Java 将 Word 文档转换为 PDF 时隐藏修订更改。此方法消除了手动步骤，提高了文档的专业性，并且在批量操作中具有良好的可扩展性。

后续步骤

  • 将代码集成到您现有的文档处理流水线中。
  • 尝试使用额外的 PdfConvertOptions 来微调 PDF 输出。
  • 探索 GroupDocs 的其他转换功能，例如图像提取或格式转换。

资源

最后更新： 2025-12-19
测试环境： GroupDocs.Conversion 25.2 for Java
作者： GroupDocs