GroupDocs.Metadata Cloud SDK for Java permite que desenvolvedores Java leiam e modifiquem programaticamente as propriedades de documentos PDF. Neste guia, você aprenderá como editar metadados de PDF em Java, atualizar campos padrão como Título e Autor, e adicionar pares chave‑valor personalizados. O SDK fornece uma API simples para carregar um PDF, alterar seus metadados e salvar o arquivo de volta ao armazenamento. Siga as instruções passo a passo para integrar a edição de metadados em suas aplicações Java.

Pré-requisitos e Configuração

Para trabalhar com metadados de PDF, você precisa do Java 8 ou superior e do Maven instalados na sua máquina de desenvolvimento. Baixe a versão mais recente a partir desta página.

Adicione o SDK ao seu projeto Maven:

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

Ou instale-o via linha de comando:

mvn install com.groupdocs:groupdocs-metadata-cloud

Crie um arquivo de configuração (ou defina variáveis de ambiente) com seu ID de cliente e segredo de cliente obtidos no painel do GroupDocs Cloud. Nenhum código de licença é necessário para este exemplo; uma licença temporária pode ser solicitada na página de licença.

Entendendo Metadados PDF

Os arquivos PDF contêm um conjunto de propriedades padrão (Title, Author, Subject, Keywords) e permitem pares de chave‑valor personalizados. Essas propriedades são armazenadas no dicionário de metadados do documento e podem ser lidas ou modificadas sem alterar o conteúdo visual do arquivo.

Principais recursos do GroupDocs.Metadata Cloud SDK for Java

  • Leia metadados existentes de PDF, DOCX, XLSX, e muitos outros formatos.
  • Atualize propriedades padrão como Título, Autor, Criador e Produtor.
  • Adicione, edite ou remova propriedades personalizadas usando uma interface de mapa simples.
  • Salve as alterações de volta ao arquivo original ou em um novo local de saída.

Modificando Propriedades Padrão de Documento PDF

O SDK expõe a classe MetadataInfo que fornece getters e setters para todos os campos padrão. Você também pode acessar a coleção CustomProperties para trabalhar com entradas definidas pelo usuário.

Adicionando Campos de Metadados Personalizados

Metadados personalizados são armazenados como um dicionário de chaves e valores de string. O SDK serializa automaticamente essas entradas quando o documento é salvo, tornando‑as disponíveis para qualquer leitor de PDF que suporte metadados personalizados.

Etapas para editar metadados PDF em Java

  1. Inicializar o cliente da API: Crie um objeto Configuration com suas credenciais e instancie o MetadataApi.
  2. Carregar o PDF de origem: Use o StorageApi para colocar o arquivo no seu armazenamento GroupDocs Cloud.
  3. Carregar os metadados do PDF: Chame metadataApi.getMetadataInfo para recuperar um objeto MetadataInfo.
  4. Atualizar campos: Defina propriedades padrão (por exemplo, setTitle, setAuthor) e adicione entradas personalizadas via getCustomProperties().put("MyKey", "MyValue").
  5. Salvar as alterações: Invocar metadataApi.updateMetadataInfo para gravar os metadados modificados de volta ao arquivo.

Para mais detalhes sobre as classes usadas, consulte a referência da API.

Editar Metadados PDF em Java - Exemplo de Código Completo

O exemplo a seguir demonstra um fluxo de trabalho completo: autenticação, upload de arquivo, modificação de metadados e salvamento do PDF atualizado.

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (sample.pdf, C:/files/sample.pdf) para corresponderem às suas localizações reais, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Editar Metadados de PDF via API REST usando cURL

Se preferir não usar a biblioteca Java, a mesma operação pode ser realizada através da GroupDocs Metadata Cloud REST API.

  1. Obter um token de acesso
   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. Carregar o arquivo 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. Atualizar metadados
   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. Baixe o PDF atualizado
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"

Esses comandos permitem integrar a edição de metadados de PDF em scripts, pipelines CI/CD ou qualquer ambiente onde a instalação da biblioteca Java não seja prática. Para obter uma lista completa de endpoints, veja a documentação da API.

Conclusão

Agora você tem uma compreensão completa de como editar metadados de PDF em Java usando o GroupDocs.Metadata Cloud SDK for Java. O guia abordou a leitura dos metadados existentes, a modificação de campos padrão como Título e Autor, a adição de pares chave‑valor personalizados e a persistência das alterações. O SDK funciona na sua máquina local ou servidor e requer uma licença válida; você pode começar com uma licença temporária na página de licença e atualizar para uma licença comercial completa para uso em produção. Incorpore essas técnicas para manter seus documentos PDF bem organizados e pesquisáveis.

FAQs

Como posso editar metadados de PDF em Java usando o GroupDocs.Metadata Cloud SDK?
Use o SDK para carregar um PDF, modificar as propriedades MetadataInfo e salvar o arquivo. Consulte a documentação do GroupDocs.Metadata Cloud SDK for Java para obter detalhes.

Posso adicionar pares chave-valor personalizados aos metadados de um PDF?
Sim, o SDK permite adicionar entradas personalizadas via o método setCustomProperties. Consulte a referência da API para exemplos.

Uma licença temporária é suficiente para desenvolvimento?
Uma licença temporária da página de licença permite que você teste o SDK. Para produção, adquira uma licença completa.

Onde posso encontrar mais exemplos para manipulação de metadados PDF?
A documentação oficial documentação e os fóruns contêm amostras adicionais e suporte da comunidade.

Leia Mais