GroupDocs.Metadata Cloud SDK for Java consente agli sviluppatori Java di leggere e modificare programmaticamente le proprietà dei documenti PDF. In questa guida imparerai come modificare i metadati PDF in Java, aggiornare i campi standard come Titolo e Autore e aggiungere coppie chiave‑valore personalizzate. L’SDK fornisce un’API semplice per caricare un PDF, modificare i suoi metadati e salvare il file nuovamente nello storage. Segui le istruzioni passo‑passo per integrare la modifica dei metadati nelle tue applicazioni Java.

Prerequisiti e Configurazione

Per lavorare con i metadati PDF è necessario Java 8 o versioni successive e Maven installati sulla tua macchina di sviluppo. Scarica l’ultima versione da questa pagina.

Aggiungi l’SDK al tuo progetto Maven:

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

Oppure installalo tramite la riga di comando:

mvn install com.groupdocs:groupdocs-metadata-cloud

Crea un file di configurazione (o imposta le variabili d’ambiente) con il tuo client ID e client secret ottenuti dal dashboard di GroupDocs Cloud. Non è necessario un codice di licenza per questo esempio; è possibile richiedere una licenza temporanea dalla pagina della licenza.

Comprendere i metadati PDF

I file PDF contengono un insieme di proprietà standard (Titolo, Autore, Oggetto, Parole chiave) e consentono coppie chiave‑valore personalizzate. Queste proprietà sono memorizzate nel dizionario dei metadati del documento e possono essere lette o modificate senza alterare il contenuto visivo del file.

Caratteristiche principali di GroupDocs.Metadata Cloud SDK for Java

  • Leggi i metadati esistenti da PDF, DOCX, XLSX, e molti altri formati.
  • Aggiorna le proprietà standard come Titolo, Autore, Creatore e Produttore.
  • Aggiungi, modifica o rimuovi proprietà personalizzate usando una semplice interfaccia a mappa.
  • Salva le modifiche nel file originale o in una nuova destinazione di output.

Modifica delle proprietà standard del documento PDF

L’SDK espone la classe MetadataInfo che fornisce getter e setter per tutti i campi standard. È inoltre possibile accedere alla collezione CustomProperties per lavorare con le voci definite dall’utente.

Aggiunta di campi di metadati personalizzati

I metadati personalizzati sono memorizzati come un dizionario di chiavi e valori di tipo stringa. L’SDK serializza automaticamente queste voci quando il documento viene salvato, rendendole disponibili a qualsiasi lettore PDF che supporti i metadati personalizzati.

Passaggi per modificare i metadati PDF in Java

  1. Inizializzare il client API: Creare un oggetto Configuration con le proprie credenziali e istanziare il MetadataApi.
  2. Caricare il PDF di origine: Utilizzare il StorageApi per posizionare il file nel proprio storage GroupDocs Cloud.
  3. Caricare i metadati del PDF: Chiamare metadataApi.getMetadataInfo per recuperare un oggetto MetadataInfo.
  4. Aggiornare i campi: Impostare le proprietà standard (ad es., setTitle, setAuthor) e aggiungere voci personalizzate tramite getCustomProperties().put("MyKey", "MyValue").
  5. Salvare le modifiche: Invocare metadataApi.updateMetadataInfo per scrivere i metadati modificati nel file.

Per ulteriori dettagli sulle classi utilizzate, consultare il riferimento API.

Modifica i metadati PDF in Java - Esempio di codice completo

Il seguente esempio dimostra un flusso di lavoro completo: autenticazione, caricamento del file, modifica dei metadati e salvataggio del PDF aggiornato.

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (sample.pdf, C:/files/sample.pdf) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Modifica i metadati PDF tramite REST API usando cURL

Se preferisci non utilizzare la libreria Java, la stessa operazione può essere eseguita tramite GroupDocs Metadata Cloud REST API.

  1. Ottieni un token di accesso
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. Carica il file 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. Aggiorna i metadati
   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. Scarica il PDF aggiornato
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"

Questi comandi ti consentono di integrare la modifica dei metadati PDF negli script, nelle pipeline CI/CD o in qualsiasi ambiente in cui l’installazione della libreria Java non è pratica. Per un elenco completo degli endpoint, consulta la documentazione API.

Conclusione

Ora hai una comprensione completa di come modificare i metadati PDF in Java utilizzando GroupDocs.Metadata Cloud SDK for Java. La guida ha coperto la lettura dei metadati esistenti, la modifica dei campi standard come Titolo e Autore, l’aggiunta di coppie chiave‑valore personalizzate e il salvataggio delle modifiche. L’SDK funziona sulla tua macchina locale o sul server e richiede una licenza valida; puoi iniziare con una licenza temporanea dalla pagina della licenza e passare a una licenza commerciale completa per l’uso in produzione. Integra queste tecniche per mantenere i tuoi documenti PDF ben organizzati e ricercabili.

Domande frequenti

Come posso modificare i metadati PDF in Java usando GroupDocs.Metadata Cloud SDK?
Usa l’SDK per caricare un PDF, modificare le proprietà MetadataInfo e salvare il file. Consulta la documentazione GroupDocs.Metadata Cloud SDK for Java per ulteriori dettagli.

Posso aggiungere coppie chiave-valore personalizzate ai metadati di un PDF?
Sì, l’SDK consente di aggiungere voci personalizzate tramite il metodo setCustomProperties. Consulta il riferimento API per esempi.

Una licenza temporanea è sufficiente per lo sviluppo?
Una licenza temporanea dalla pagina della licenza ti consente di testare l’SDK. Per la produzione, acquista una licenza completa.

Dove posso trovare più esempi per la manipolazione dei metadati PDF?
La documentazione ufficiale e i forum contengono ulteriori esempi e supporto della community.

Leggi di più