GroupDocs.Metadata Cloud SDK for Java permite a los desarrolladores Java leer y modificar programáticamente las propiedades de los documentos PDF. En esta guía aprenderá cómo editar los metadatos de PDF en Java, actualizar campos estándar como Título y Autor, y agregar pares clave‑valor personalizados. El SDK ofrece una API sencilla para cargar un PDF, cambiar sus metadatos y guardar el archivo nuevamente en el almacenamiento. Siga las instrucciones paso a paso para integrar la edición de metadatos en sus aplicaciones Java.

Prerequisitos y Configuración

Para trabajar con los metadatos PDF necesita Java 8 o superior y Maven instalado en su máquina de desarrollo. Descargue la última versión desde esta página.

Agrega el SDK a tu proyecto Maven:

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

O instálelo a través de la línea de comandos:

mvn install com.groupdocs:groupdocs-metadata-cloud

Cree un archivo de configuración (o establezca variables de entorno) con su ID de cliente y su secreto de cliente obtenidos del panel de GroupDocs Cloud. No se requiere un código de licencia para este ejemplo; se puede solicitar una licencia temporal en la página de licencias.

Comprender los metadatos PDF

Los archivos PDF contienen un conjunto de propiedades estándar (Title, Author, Subject, Keywords) y permiten pares clave‑valor personalizados. Estas propiedades se almacenan en el diccionario de metadatos del documento y pueden leerse o modificarse sin alterar el contenido visual del archivo.

Características clave de GroupDocs.Metadata Cloud SDK for Java

  • Leer metadatos existentes de PDF, DOCX, XLSX, y muchos otros formatos.
  • Actualizar propiedades estándar como Título, Autor, Creador y Productor.
  • Añadir, editar o eliminar propiedades personalizadas usando una interfaz de mapa simple.
  • Guardar los cambios de vuelta al archivo original o a una nueva ubicación de salida.

Modificando las propiedades estándar del documento PDF

El SDK expone la clase MetadataInfo que proporciona getters y setters para todos los campos estándar. También puedes acceder a la colección CustomProperties para trabajar con entradas definidas por el usuario.

Agregar campos de metadatos personalizados

Los metadatos personalizados se almacenan como un diccionario de claves y valores de tipo cadena. El SDK serializa automáticamente estas entradas cuando se guarda el documento, haciéndolas disponibles para cualquier lector de PDF que admita metadatos personalizados.

Pasos para editar los metadatos PDF en Java

  1. Inicializar el cliente API: Cree un objeto Configuration con sus credenciales e instancie el MetadataApi.
  2. Cargar el PDF de origen: Utilice el StorageApi para colocar el archivo en su almacenamiento de GroupDocs Cloud.
  3. Cargar los metadatos del PDF: Llame a metadataApi.getMetadataInfo para obtener un objeto MetadataInfo.
  4. Actualizar campos: Establezca propiedades estándar (p. ej., setTitle, setAuthor) y añada entradas personalizadas mediante getCustomProperties().put("MyKey", "MyValue").
  5. Guardar los cambios: Invoque metadataApi.updateMetadataInfo para escribir los metadatos modificados de nuevo en el archivo.

Para obtener más detalles sobre las clases utilizadas, consulte la referencia de API.

Editar metadatos PDF en Java - Ejemplo de código completo

El siguiente ejemplo demuestra un flujo de trabajo completo: autenticación, carga de archivos, modificación de metadatos y guardado del PDF actualizado.

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de archivo (sample.pdf, C:/files/sample.pdf) para que coincidan con sus ubicaciones reales, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Editar metadatos PDF mediante API REST usando cURL

Si prefiere no usar la biblioteca Java, la misma operación se puede realizar a través de la GroupDocs Metadata Cloud REST API.

  1. Obtener un token de acceso
   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. Cargar el archivo 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. Actualizar metadatos
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. Descargar el PDF actualizado
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"

Estos comandos le permiten integrar la edición de metadatos PDF en scripts, pipelines CI/CD o cualquier entorno donde no sea práctico instalar la biblioteca Java. Para obtener una lista completa de los puntos finales, consulte la documentación de la API.

Conclusión

Ahora tienes una comprensión completa de cómo editar los metadatos de PDF en Java usando GroupDocs.Metadata Cloud SDK for Java. La guía cubrió la lectura de los metadatos existentes, la modificación de campos estándar como Título y Autor, la adición de pares clave‑valor personalizados y la persistencia de los cambios. El SDK se ejecuta en tu máquina local o servidor y requiere una licencia válida; puedes comenzar con una licencia temporal desde la página de licencias y actualizar a una licencia comercial completa para uso en producción. Incorpora estas técnicas para mantener tus documentos PDF bien organizados y buscables.

Preguntas frecuentes

¿Cómo puedo editar los metadatos de PDF en Java usando GroupDocs.Metadata Cloud SDK?
Use el SDK para cargar un PDF, modificar sus propiedades MetadataInfo y guardar el archivo. Consulte la documentación del GroupDocs.Metadata Cloud SDK for Java para obtener más detalles.

¿Puedo agregar pares clave‑valor personalizados a los metadatos de un PDF?
Sí, el SDK permite agregar entradas personalizadas mediante el método setCustomProperties. Consulte la referencia de API para obtener ejemplos.

¿Es una licencia temporal suficiente para el desarrollo?
Una licencia temporal de la página de licencias le permite probar el SDK. Para producción, adquiera una licencia completa.

¿Dónde puedo encontrar más ejemplos para la manipulación de metadatos PDF?
La documentación oficial y los foros contienen ejemplos adicionales y soporte de la comunidad.

Leer más