在 Java 中移除 PDF 的图像水印

Mon, 07 Sep 2026 13:44:25 +0000

不需要的图像水印会使 PDF 文档显得不专业，并阻碍后续处理。 GroupDocs.Watermark Cloud SDK for Java 提供了强大的 API，允许 Java 开发者以编程方式从 PDF 文件中剥离这些水印。本指南展示了如何使用 SDK 的移除端点 在 Java 中删除 PDF 的图像水印。完成后，您将能够将自动水印移除集成到任何 Java 应用程序中。

Java 开发环境 - 前置条件和设置

在开始之前，请确保您具备以下条件：

已安装 Java 17 或更高版本。
用于依赖管理的 Maven 或 Gradle。
拥有 client ID 和 client secret 的 GroupDocs Cloud 账户。

使用下面的 Maven 依赖将 SDK 添加到您的项目中（您也可以使用等效的 Gradle 方式）。最新的二进制文件可在下载页面获取。


    com.groupdocs
    groupdocs-watermark-cloud
    23.8

使用您的凭据初始化 API 客户端。此代码片段直接取自示例代码。

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

当客户端准备好后，您可以继续实际的删除工作流。

Java 中删除 PDF 图像水印的分步指南

步骤 1：加载源文档

首先，指定要清理的 PDF。FileInfo 对象告诉 API 文件所在的位置，并可选地提供密码。

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.pdf");
// inputFile.setPassword("pdfPassword"); // Uncomment if needed

第2步：定义图像水印标准

创建一个指向您希望删除的水印图像的 ImageSearchCriteria。这是 在 Java 中删除 PDF 的图像水印 操作的核心。

ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
imageCriteria.setImagePath("watermark.png");

步骤 3：设置删除选项

将文件信息和搜索条件组合成一个 RemoveOptions 对象。您还可以定义清理后的 PDF 将保存的位置。

RemoveOptions removeOptions = new RemoveOptions();
removeOptions.setFileInfo(inputFile);
removeOptions.setOutputPath("output.pdf");
removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

步骤 4：执行删除调用

在 WatermarkApi 上调用 remove 方法。调用返回一个包含已处理文件路径的 RemoveResult。

RemoveResult result = watermarkApi.remove(removeOptions);
System.out.println("Watermark removal completed. Output file: " + result.getPath());

步骤 5：处理结果

处理可能出现的任何异常。SDK 会抛出 ApiException 表示服务端错误，并抛出通用的 Exception 表示意外问题。

try {
    // removal code above
} catch (ApiException e) {
    System.err.println("API exception occurred: " + e.getMessage());
} catch (Exception e) {
    System.err.println("Unexpected error: " + e.getMessage());
}

完整代码示例：使用 GroupDocs 删除图像水印

以下示例演示了从客户端初始化到结果处理的完整工作流。

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiClient;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.ImageSearchCriteria;
import com.groupdocs.watermark.cloud.model.RemoveOptions;
import com.groupdocs.watermark.cloud.model.RemoveResult;
import java.util.Collections;

public class RemoveImageWatermarkFromPdf {
    public static void main(String[] args) {
        // Initialize API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.pdf");
        // If the PDF is password protected, uncomment the following line and set the password
        // inputFile.setPassword("pdfPassword");

// Define the image watermark to be removed
        ImageSearchCriteria imageCriteria = new ImageSearchCriteria();
        imageCriteria.setImagePath("watermark.png");

// Set up removal options
        RemoveOptions removeOptions = new RemoveOptions();
        removeOptions.setFileInfo(inputFile);
        removeOptions.setOutputPath("output.pdf");
        removeOptions.setSearchCriteria(Collections.singletonList(imageCriteria));

try {
            // Execute removal
            RemoveResult result = watermarkApi.remove(removeOptions);
            System.out.println("Watermark removal completed. Output file: " + result.getPath());
        } catch (ApiException e) {
            System.err.println("API exception occurred: " + e.getMessage());
        } catch (Exception e) {
            System.err.println("Unexpected error: " + e.getMessage());
        }
    }
}

注意： 此代码示例演示了核心功能。在项目中使用之前，请确保更新任何文件路径和配置值以匹配实际环境，验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如遇到任何问题，请参阅官方文档或联系支持团队获取帮助。

使用 cURL 的 REST API 水印移除操作

如果您更喜欢纯 REST 方法，可以使用 cURL 命令执行相同的操作。

进行身份验证并获取访问令牌

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

上传源 PDF

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input.pdf"

执行水印删除

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/remove" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {"filePath":"input.pdf"},
           "outputPath":"output.pdf",
           "searchCriteria":[{"type":"Image","imagePath":"watermark.png"}]
         }'

下载已清理的 PDF

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

如需完整参考，请参阅 API 文档。

微调删除选项

SDK 提供了多个属性，您可以根据不同场景进行调整。

密码保护 - 如果源 PDF 已加密，请在 FileInfo 上设置密码。

  inputFile.setPassword("mySecret");

多个搜索条件 - 通过向列表中添加更多 ImageSearchCriteria 对象，在一次调用中删除多个水印。

ImageSearchCriteria logoCriteria = new ImageSearchCriteria();
logoCriteria.setImagePath("logo.png");
removeOptions.setSearchCriteria(Arrays.asList(imageCriteria, logoCriteria));

输出格式 - 虽然默认是 PDF，但您可以通过设置 outputPath 为不同的扩展名（例如 output.docx）来更改输出格式。

  removeOptions.setOutputPath("output.docx");

这些选项让您能够根据自己的确切需求定制 remove image watermark from PDF in Java 过程。

结论

使用 GroupDocs.Watermark Cloud SDK for Java 可以轻松以编程方式从 PDF 文件中移除图像水印。按照上述步骤，您可以将水印删除功能集成到任何 Java 后端，处理加密的 PDF，并通过灵活的选项对操作进行微调。请记得获取适用于生产环境的正式许可证；产品页面上提供了定价详情，您也可以通过临时许可证页面申请临时许可证。立即开始清理您的 PDF，为用户提供精美的文档。

常见问题

如何在 Java 中删除 PDF 的图像水印？
使用 remove 方法的 WatermarkApi，并提供指向水印图像的 ImageSearchCriteria。本文中的完整代码示例展示了具体步骤。
如果我的 PDF 受密码保护怎么办？
在调用删除 API 之前，在 FileInfo 对象上设置密码 (inputFile.setPassword("yourPassword"))。SDK 将自动解密、处理并重新加密文件。
我可以从其他格式（例如 DOCX）中移除水印吗？
是的。相同的 API 可用于 GroupDocs.Watermark 支持的任何格式。只需相应地更改 filePath 和 outputPath 的扩展名即可。
我可以处理的 PDF 大小是否有限制？
云服务每次请求可处理的文件大小上限为 500 MB。对于更大的文档，请考虑在处理前将 PDF 拆分为更小的部分。

watermark removal on Document Processing REST APIs | GroupDocs Cloud