GroupDocs.Metadata Cloud SDK for Java 使 Java 开发人员能够以编程方式读取和修改 PDF 文档属性。在本指南中，您将学习如何在 Java 中编辑 PDF 元数据，更新诸如 Title（标题）和 Author（作者）等标准字段，并添加自定义键‑值对。该 SDK 提供了一个简单的 API，用于加载 PDF、更改其元数据并将文件保存回存储。请按照分步说明将元数据编辑集成到您的 Java 应用程序中。

先决条件和设置

要使用 PDF 元数据，您需要在开发机器上安装 Java 8 或更高版本以及 Maven。从此页面下载最新版本。

将 SDK 添加到您的 Maven 项目中：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.9</version>
</dependency>

或者通过命令行安装：

mvn install com.groupdocs:groupdocs-metadata-cloud

创建一个配置文件（或设置环境变量），其中包含从 GroupDocs Cloud 仪表板获取的客户端 ID 和客户端密钥。此示例不需要许可证代码；您可以从许可证页面请求临时许可证。

了解 PDF 元数据

PDF 文件包含一组标准属性（Title、Author、Subject、Keywords），并允许自定义键‑值对。这些属性存储在文档的元数据字典中，可以在不更改文件视觉内容的情况下读取或修改。

GroupDocs.Metadata Cloud SDK for Java 的主要功能

  • 读取 PDF、DOCX、XLSX 等多种格式的现有元数据。
  • 更新标准属性，如标题、作者、创建者和生成者。
  • 使用简单的映射接口添加、编辑或删除自定义属性。
  • 将更改保存回原始文件或保存到新的输出位置。

修改标准 PDF 文档属性

SDK公开了 MetadataInfo 类，提供所有标准字段的 getter 和 setter。您还可以访问 CustomProperties 集合，以处理用户定义的条目。

添加自定义元数据字段

自定义元数据存储为字符串键和值的字典。SDK 在文档保存时会自动序列化这些条目，使其可供任何支持自定义元数据的 PDF 阅读器使用。

在 Java 中编辑 PDF 元数据的步骤

  1. 初始化 API 客户端：创建一个包含您凭据的 Configuration 对象并实例化 MetadataApi。
  2. 上传源 PDF：使用 StorageApi 将文件放置在您的 GroupDocs Cloud 存储中。
  3. 加载 PDF 元数据：调用 metadataApi.getMetadataInfo 来检索 MetadataInfo 对象。
  4. 更新字段：设置标准属性（例如 setTitle、setAuthor），并通过 getCustomProperties().put("MyKey", "MyValue") 添加自定义条目。
  5. 保存更改：调用 metadataApi.updateMetadataInfo 将修改后的元数据写回文件。

有关使用的类的更多详细信息，请参阅API 参考。

在 Java 中编辑 PDF 元数据 - 完整代码示例

以下示例演示了完整的工作流：身份验证、文件上传、元数据修改以及保存更新后的 PDF。

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

使用 cURL 通过 REST API 编辑 PDF 元数据

如果您不想使用 Java 库，可以通过 GroupDocs Metadata Cloud REST API 执行相同的操作。

  1. 获取访问令牌
curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. 上传 PDF 文件
   curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/octet-stream" \
        --data-binary "@C:/files/sample.pdf"
  1. 更新元数据
curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'
  1. 下载更新后的 PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "C:/files/updated_sample.pdf"

这些命令让您能够在脚本、CI/CD 流水线或任何不适合安装 Java 库的环境中集成 PDF 元数据编辑。完整的端点列表请参阅 API 文档。

结论

现在，您已经完整了解如何使用 GroupDocs.Metadata Cloud SDK for Java 在 Java 中编辑 PDF 元数据。指南涵盖了读取现有元数据、修改诸如 Title 和 Author 等标准字段、添加自定义键‑值对以及持久化更改。SDK 可以在本地机器或服务器上运行，并且需要有效的许可证；您可以从许可证页面获取临时许可证，并在生产环境中升级为完整的商业许可证。将这些技术应用于您的 PDF 文档，以保持其组织有序且可搜索。

常见问题

如何使用 GroupDocs.Metadata Cloud SDK 在 Java 中编辑 PDF 元数据？
使用 SDK 加载 PDF，修改其 MetadataInfo 属性，然后保存文件。有关详细信息，请参阅 GroupDocs.Metadata Cloud SDK for Java 文档。

我可以向 PDF 的元数据添加自定义键值对吗？
是的，SDK 允许通过 setCustomProperties 方法添加自定义条目。请参阅 API 参考 获取示例。

临时许可证足以用于开发吗？
来自许可证页面的临时许可证可让您测试 SDK。对于生产环境，请购买完整许可证。

在哪里可以找到更多关于 PDF 元数据操作的示例？
官方文档和论坛包含更多示例和社区支持。

阅读更多