pdf manipulation on Document Processing REST APIs | GroupDocs Cloud https://blog-qa.groupdocs.cloud/zh/tag/pdf-manipulation/ Recent content in pdf manipulation on Document Processing REST APIs | GroupDocs Cloud Hugo -- gohugo.io zh Wed, 21 Oct 2026 13:18:44 +0000 使用 REST 在 Node.JS 中删除 PDF 的注释对象 https://blog-qa.groupdocs.cloud/zh/annotation/remove-annotation-objects-from-pdf-with-rest-in-nodejs/ Wed, 21 Oct 2026 13:18:44 +0000 https://blog-qa.groupdocs.cloud/zh/annotation/remove-annotation-objects-from-pdf-with-rest-in-nodejs/ 了解如何使用 GroupDocs.Annotation Cloud SDK 在 Node.JS 中通过 REST 删除 PDF 中的 Annotation 对象。提供代码、cURL 和实践的分步指南。 在准备干净的文档进行分发时，删除 PDF 中不需要的注释、突出显示或墨迹是常见需求。GroupDocs.Annotation Cloud SDK for Node.js 提供了一个强大的基于 REST 的库，能够以编程方式管理 PDF 注释。本指南将逐步演示如何在 Node.JS 中使用 REST 删除 PDF 的 Annotation 对象。您将看到完整的代码示例、等效的 cURL 命令、配置技巧以及将注释删除集成到服务中的最佳实践建议。

完整工作示例：使用 REST 在 Node.JS 中删除 PDF 的注释对象

此示例演示如何上传 PDF，删除其所有注释，并使用 GroupDocs.Annotation SDK 下载已清理的文件。

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

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

使用 cURL 通过 REST API 删除 PDF 注释

以下是通过 GroupDocs.Annotation Cloud REST 端点执行相同注释删除工作流的 cURL 命令。

# 1. Obtain an access token
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\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

要获取完整的端点和参数列表，请参阅官方 API 文档。

使用 REST 在 Node.JS 中删除 PDF 注释对象的工作原理

  1. 身份验证设置 - Configuration 类使用您的 clientId 和 clientSecret 实例化，为后续所有 API 调用创建已认证的上下文。

    const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

  2. 文件上传 - UploadFileRequest 将本地 PDF 字节发送到 GroupDocs Cloud 存储。storageApi.uploadFile 方法负责传输。

    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

  3. 检索批注 - GetAnnotationsRequest 使用 FileInfo 引用构建请求对象。annotationsApi.getAnnotations 调用返回批注对象集合，可从中提取 ID。

    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

  4. 删除批注 - 如果存在任何 ID，则填充 DeleteAnnotationsRequest 并传递给 annotationsApi.deleteAnnotations，该方法会永久删除存储在 PDF 中的批注。

    const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

  5. 下载清理后的 PDF - 最后，DownloadFileRequest 获取更新后的文件，fs.writeFileSync 将其写入本地文件系统。

    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

有关详细的类和方法定义，请参阅 API 参考。

安装和配置 GroupDocs.Annotation Cloud SDK for Node.js

SDK 以 npm 包的形式分发。使用以下命令进行安装，然后在项目中 require 它。

npm install groupdocs-annotation-cloud

您也可以直接从GitHub 发布页面或官方下载 URL下载最新的包。

安装后，导入库并创建配置对象，如代码示例所示：

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

确保您的运行时环境满足 Node.js 版本要求，并且拥有有效的 GroupDocs 帐户以获取客户端凭据。

注释删除选项和设置

SDK 公开了多个可调参数：

  • clientId / clientSecret - OAuth 身份验证的凭据。在 Configuration 构造函数中设置它们。
  • fileInfo.filePath - PDF 在 GroupDocs Cloud 存储中的路径。如果文件存储在其他文件夹，请相应调整。
  • annotationIds - 由 GetAnnotations 返回的 ID 数组。提供子集可实现选择性删除。

SDK 文档中提供了请求超时和代理配置等其他设置；完整列表请参阅 官方文档。

通过 REST 删除 PDF 注释的最佳实践

  • 验证注释 ID - 始终检查您要删除的 ID 是否存在；尝试删除不存在的 ID 可能会导致 404 错误。
  • 使用 HTTPS - 所有 API 调用必须通过 HTTPS 进行，以保护您的凭据和文档数据。
  • 使用分块上传处理大文件 - 对于大于 100 MB 的 PDF，建议使用多部分上传端点，以避免超时。
  • 记录 API 响应 - 存储请求 ID 和响应，以便审计追踪和更轻松的故障排除。
  • 重用访问令牌 - 缓存 OAuth 令牌直至过期，以减少身份验证开销。

常见问题

  • 如何使用 GroupDocs.Annotation Cloud API 进行身份验证？
    从您的 GroupDocs 帐户获取客户端 ID 和密钥，然后通过 OAuth 端点请求访问令牌。请参阅官方文档了解详细信息。

  • 我可以删除特定的批注而不是全部吗？
    是的，在 DeleteAnnotationsRequest 中提供您想要删除的批注 ID。SDK 在调用 GetAnnotations 后返回批注 ID 列表。

  • 如何使用 REST 在 Node.JS 中删除 PDF 的 Annotation 对象？
    使用 GroupDocs.Annotation Cloud SDK for Node.js 调用 DeleteAnnotations 端点，在获取注释 ID 后进行删除。完整的工作流程在本指南的代码示例和 cURL 部分中演示。

  • 生产使用需要什么许可证？ 生产环境需要付费许可证。您可以在评估期间从临时许可证页面获取临时许可证。

进一步阅读

]]> 在 Node.JS 中合并 PDF https://blog-qa.groupdocs.cloud/zh/merger/merge-pdf-in-nodejs/ Mon, 19 Oct 2026 15:04:19 +0000 https://blog-qa.groupdocs.cloud/zh/merger/merge-pdf-in-nodejs/ 了解如何在 Node.JS 中使用 GroupDocs.Merger Cloud SDK 合并 PDF 文件。提供逐步指南、代码示例、cURL 命令以及面向开发者的性能技巧。 将多个 PDF 文档合并为单个文件是构建文档工作流或生成报告时的常见需求。GroupDocs.Merger Cloud SDK for Node.js 使在 Node.JS 中合并 PDF 变得轻松，无需处理底层 PDF 结构。本指南将带您完成设置、逐步实现、完整代码示例、等效的 cURL 调用以及针对大型或加密 PDF 的性能技巧。

开始之前：先决条件和安装

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

  • 在您的开发机器上安装了 Node.js 14 或更高版本。
  • 拥有有效的 GroupDocs Cloud 账户，并具备 client ID 和 client secret。
  • 访问存储在 GroupDocs Cloud 存储中的、您想要合并的 PDF 文件。

通过 npm 安装 SDK 并下载最新的包：

npm install groupdocs-merger-cloud

您也可以从官方发布页面获取 SDK: 下载 SDK。安装完成后，您即可开始编码。

Node.JS 中合并 PDF 的分步指南

步骤 1：安装 SDK 并导入所需类

首先，导入合并 PDF 所需的类。

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

此导入为您提供对核心 API、配置对象和文件描述符的访问。

步骤 2：配置您的 GroupDocs 凭据

使用您的客户端凭据创建配置对象。

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

提供正确的凭据可让库对您的请求进行身份验证。

步骤 3：定义要合并的 PDF 文件

列出您想要合并的 PDF 文档。此步骤可帮助您在 Node.JS 中高效合并 PDF。

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

每个 FileInfo 指向存储在您的 GroupDocs Cloud 存储中的文件。

第4步：设置合并选项

配置输出位置并将文件列表附加到合并请求。

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

这些设置控制您在 Node.JS 中合并 PDF 的方式以及结果将保存的位置。

步骤 5：执行合并操作

创建 API 实例，调用 merge 方法，并处理响应。

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

如果操作成功，异步调用将返回合并文档的路径。

在 Node.JS 中合并 PDF 的完整实现示例

以下代码演示了从配置到结果处理的完整工作流。

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

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

使用 cURL 通过 REST API 合并 PDF

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

首先，获取访问令牌：

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

将源 PDF 上传到您的存储（将 YOUR_ACCESS_TOKEN 替换为上一步中的令牌）：

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

再次上传 input2.pdf。然后请求合并操作：

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

最后，下载合并后的文件：

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

要获取完整的端点和参数列表，请参阅 API 参考。

配置合并选项

SDK 提供了多种选项，允许您微调合并过程：

  • outputPath - 合并后 PDF 的目标路径。调整此路径以控制结果的存储位置。
  • fileInfos - 定义源 PDF 及其顺序的 FileInfo 对象数组。

您还可以设置其他属性，例如 pages 用于合并特定页面范围，或 password 用于加密的 PDF。请参阅官方文档以获取可配置字段的完整列表。

合并 PDF 的性能考虑

合并大量或许多 PDF 文件时，请牢记以下提示：

  • 使用 async/await 来避免阻塞事件循环，尤其是处理大型文档时。
  • 批量上传：在调用合并之前并行上传源 PDF，以降低整体延迟。
  • 流式处理：对于极大的 PDF，考虑将中间结果存储在云存储中，并分块合并。
  • 加密 PDF：在 FileInfo 对象中提供密码；处理加密文件会增加开销，尽可能在解密后再进行合并。

应用这些实践可帮助您在 Node.JS 中高效合并 PDF，同时将内存消耗降至最低。

您可能有的问题

  • 如何在 Node.JS 中使用 GroupDocs 合并 PDF 文件？
    使用 GroupDocs.Merger Cloud SDK for Node.js 创建一个 MergeApi 实例，使用您的源 PDF 配置 MergeOptions，并调用 mergeDocuments。本指南中的完整代码示例演示了该过程。

  • 我可以在 Node.JS 中合并加密的 PDF 文件吗？
    是的，SDK 支持合并加密的 PDF。请在调用 mergeDocuments 之前，在 FileInfo 对象中提供正确的密码。详情请参阅官方文档。

  • GroupDocs.Merger 的授权选项有哪些？
    GroupDocs 提供灵活的定价方案。为了测试，您可以请求临时许可证，在购买完整订阅之前评估该库。

  • 我在哪里可以找到更多示例和支持？
    其他示例可在 GitHub 仓库 获取。 如需帮助，请访问 支持论坛。

进一步阅读

]]> 在 Java 中向 PDF 文档添加图像水印 https://blog-qa.groupdocs.cloud/zh/watermark/add-image-watermark-to-pdf-documents-in-java/ Fri, 28 Aug 2026 19:41:04 +0000 https://blog-qa.groupdocs.cloud/zh/watermark/add-image-watermark-to-pdf-documents-in-java/ 了解如何在 Java 中使用 GroupDocs.Watermark Cloud SDK 为 PDF 文档添加图像水印。提供代码、cURL 和配置技巧的分步指南。 向 PDF 文件添加可视标识对于保护知识产权和为文档进行品牌化至关重要。 GroupDocs.Watermark Cloud SDK for Java 提供了一个直接在 Java 应用程序中将图像水印嵌入 PDF 的简便 API。在本教程中，您将学习如何在 Java 中向 PDF 文档添加图像水印，查看完整的工作示例，并探索用于云集成的等效 cURL REST 调用。

在 Java 中的 5 步为 PDF 文档添加图像水印

  1. 初始化 API 客户端: 使用您的 client ID 和 secret 创建 ApiClient 实例。
ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

此步骤将您的 Java 代码连接到 GroupDocs.Watermark Cloud 服务。请参阅 API reference 获取更多详情。

  1. 指定源 PDF 文件: 构建一个指向您想要添加水印的 PDF 的 FileInfo 对象。

    FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

    在发出请求之前，必须先将文件上传到您的 GroupDocs 存储。

  2. 配置图像水印：定义图像路径、不透明度、缩放因子、旋转和对齐方式。

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

调整这些值以实现所需的外观；不透明度控制透明度，而缩放因子决定相对于页面的大小。

  1. 设置水印选项和输出路径: 将文件信息和水印组合成一个 WatermarkOptions 对象。
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
options.setImageWatermark(imageWatermark);
options.setOutputPath("output.pdf");

outputPath 告诉服务将生成的 PDF 存储在哪里。

  1. 执行请求：构建 AddWatermarkRequest 并调用 API。处理成功或错误响应。 
    AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}
    执行后，带水印的 PDF 将位于您指定的位置。

完整代码示例：在 Java 中向 PDF 文档添加图像水印

以下示例演示了从客户端初始化到保存带水印的 PDF 的完整实现。

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

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

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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

通过 cURL 和 REST API 为 PDF 文档添加图像水印

以下是您可以使用 cURL 的 REST 调用，以在不编写 Java 代码的情况下实现相同的结果。

  1. 获取访问令牌
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"}'

响应中包含一个 access_token，在后续调用中使用。

  1. 上传源 PDF

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

  2. 上传水印图像

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/watermark.png"
  1. 添加图像水印
curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

此请求镜像了 Java 代码逻辑，应用相同的不透明度、缩放和对齐设置。

  1. 下载带水印的 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 文档。

安装和配置 GroupDocs.Watermark Cloud SDK for Java

将 Maven 依赖添加到您的 pom.xml（或等效的 Gradle 代码片段）。该库托管在 Maven Central 上。

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

您还需要一个有效的 GroupDocs Cloud 帐户。请从 GroupDocs 门户 获取您的 Client ID 和 Client Secret。由于 SDK 与云服务通信，无需额外的运行时安装。

微调 PDF 文档的图像水印选项

SDK 提供了多个属性，可让您控制水印的视觉外观。

调整不透明度

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

不透明度值范围为 0.0（完全透明）到 1.0（完全不透明）。

更改比例因子

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

比例因子决定水印相对于页面尺寸的大小。

设置对齐和边距

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

这些设置将水印放置在右下角，边距为 20 点。

有关可配置属性的完整列表，请参阅 API 参考。

结论

在 Java 中向 PDF 文档添加图像水印是一项直接的任务，只要使用 GroupDocs.Watermark Cloud SDK for Java。SDK 处理所有低层次的 PDF 操作，让您专注于不透明度、缩放和定位等视觉方面。无论您更喜欢本地 Java 实现还是基于云的 cURL 工作流，都可以在不牺牲性能的前提下实现同样高质量的结果。请记得为生产使用获取合适的许可证；产品页面上提供了定价详情，您也可以使用 临时许可证页面 进行评估。

FAQs

  • 如何在 Java 中为 PDF 添加图像水印而不失去质量？
    使用 scaleFactor 属性相对于页面大小调整水印，并保持源 PDF 的原始 DPI。SDK 保持 PDF 的分辨率，因此水印在任何缩放级别下都保持清晰。

  • 我可以在同一个 PDF 中添加多个水印吗？
    是的。创建具有不同配置的单独 ImageWatermark 对象，并通过多次调用 addWatermark 或将它们添加到请求中的列表来顺序添加它们。

  • 支持的水印图像格式有哪些？
    API 接受常见的图像类型，例如 PNG、JPG、BMP、GIF 和 TIFF。推荐使用 PNG 以获得无损质量和透明度支持。

  • 是否有办法在应用水印之前预览它？
    您可以使用 GroupDocs.Watermark Cloud SDK for Java 生成带有水印的临时 PDF 并下载进行审阅。此操作使用相同的 addWatermark 调用，输出路径指向临时位置。

阅读更多

]]>