GroupDocs.Metadata Cloud SDK for Java 讓 Java 開發人員能以程式方式讀取和修改 PDF 文件屬性。 在本指南中，您將學習如何在 Java 中編輯 PDF 元資料，更新諸如標題和作者等標準欄位，並新增自訂鍵值對。 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），並允許自訂鍵‑值對。這些屬性儲存在文件的 metadata 字典中，且可以在不更改檔案視覺內容的情況下讀取或修改。

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"

這些指令讓您能將 PDF 元資料編輯整合到腳本、CI/CD 管道，或任何安裝 Java 程式庫不切實際的環境中。 如需完整的端點清單，請參閱 API 文件。

結論

您現在已完整了解如何在 Java 中使用 GroupDocs.Metadata Cloud SDK for 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 reference 获取示例。

臨時授權足以用於開發嗎？
來自授權頁面的臨時授權可讓您測試 SDK。對於正式環境，請購買完整授權。

我可以在哪裡找到更多 PDF 元資料操作的範例？
官方的文件和論壇提供了更多範例和社群支援。

閱讀更多