Aggiungi watermark a PDF con GroupDocs.Watermark per Java

In questa guida imparerai come aggiungere watermark a file PDF utilizzando il GroupDocs.Watermark Java SDK. Vedremo come caricare documenti da disco, stream o fonti protette da password, applicare watermark di testo o immagine e infine salvare il PDF aggiornato. Che tu stia creando un processore batch o un servizio per singolo file, questi passaggi ti forniscono una soluzione affidabile e pronta per la produzione.

Risposte rapide

  • Posso aggiungere un watermark a un PDF protetto da password? Sì – passa la password durante il caricamento del documento, quindi applica il watermark normalmente.
  • Quali formati possono essere watermarked? Oltre 30 formati, inclusi PDF, DOCX, PPTX e immagini.
  • È necessaria una licenza per lo sviluppo? Una licenza temporanea funziona per i test; è richiesta una licenza completa per la produzione.
  • Quale versione di Java è richiesta? Java 8 o superiore è supportato.
  • Lo streaming è supportato? Assolutamente – è possibile caricare da InputStream e salvare su OutputStream senza toccare il file system.

Cos’è aggiungere watermark a PDF?

Aggiungere watermark a PDF indica il processo di sovrapporre testo o immagini semi‑trasparenti su ogni pagina di un documento PDF per indicare proprietà, riservatezza o branding. GroupDocs.Watermark per Java fornisce un’API a chiamata singola che gestisce automaticamente posizionamento, opacità e selezione dell’intervallo di pagine.

Perché usare GroupDocs.Watermark per Java?

GroupDocs.Watermark supporta oltre 35 formati di file e può elaborare PDF di 500 pagine in meno di 2 secondi su una tipica CPU di classe server. La libreria funziona interamente in memoria, quindi non è mai necessario installare Microsoft Office o Adobe Acrobat. La sua API è thread‑safe, rendendola ideale per servizi web ad alto throughput.

Prerequisiti

  • Java 8 o versioni successive installate.
  • Progetto Maven o Gradle configurato con la dipendenza groupdocs-watermark.
  • Una licenza valida di GroupDocs.Watermark (licenza temporanea per la valutazione).
  • File PDF da proteggere, opzionalmente con password.

Come aggiungere watermark a PDF – passo passo

Carica il documento sorgente, applica un watermark, quindi salva il risultato. Le sezioni seguenti rispondono direttamente a ciascuna sotto‑attività.

Come caricare un documento dal disco?

Watermarker è la classe principale usata per caricare e manipolare documenti per il watermarking. Fornisci il percorso completo del file al costruttore Watermarker; l’SDK rileva automaticamente il formato del file, ne valida il contenuto e carica il documento in memoria pronto per qualsiasi operazione di watermark. Questo approccio funziona per PDF, file Word, immagini e molti altri tipi supportati.

Watermarker watermarker = new Watermarker("C:/files/input.pdf");

Dopo questa riga il PDF è completamente caricato in memoria, pronto per qualsiasi operazione di watermark.

Come caricare un documento dallo stream?

Watermarker può anche accettare un InputStream per caricare i documenti direttamente dalla memoria. Quando ricevi un file via HTTP o una coda di messaggi, avvolgi l’array di byte in un ByteArrayInputStream e passalo al costruttore Watermarker che accetta un InputStream. L’SDK legge lo stream senza scrivere su disco, preservando prestazioni e sicurezza, e supporta file di grandi dimensioni elaborando i dati a blocchi. Questo metodo è ideale per servizi web e architetture a micro‑servizi.

InputStream pdfStream = new ByteArrayInputStream(pdfBytes);
Watermarker watermarker = new Watermarker(pdfStream);

L’SDK legge lo stream senza scrivere su disco, preservando prestazioni e sicurezza.

Come caricare un documento protetto da password?

Watermarker supporta il caricamento di PDF protetti da password fornendo la password come secondo argomento. Fornisci la password come secondo argomento al costruttore. L’SDK decritta il PDF al volo, dopo di che puoi trattarlo come qualsiasi altro documento. Se la password è corretta, tutte le pagine diventano accessibili per il watermark; altrimenti la libreria genera un’eccezione chiara che puoi catturare e registrare per la risoluzione dei problemi.

Watermarker watermarker = new Watermarker("C:/files/secure.pdf", "mySecretPwd");

Se la password è errata, l’SDK genera un’eccezione informativa che puoi catturare e registrare.

Come applicare un watermark di testo?

TextWatermark rappresenta un watermark testuale che può essere applicato alle pagine con stile personalizzabile. Crea un oggetto TextWatermark con il testo desiderato, font, dimensione e colore. Quindi chiama add sull’istanza Watermarker, opzionalmente specificando gli intervalli di pagine. Il watermark viene renderizzato con l’opacità e la rotazione specificate, e può essere posizionato usando posizioni predefinite o coordinate personalizzate, garantendo un aspetto coerente su tutte le pagine.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 36));
watermark.setColor(Color.RED);
watermark.setTransparency(0.5);
watermarker.add(watermark);

Questa chiamata posiziona il watermark su ogni pagina per impostazione predefinita; puoi limitarlo con new PageRange(1, 5) se necessario.

Come applicare un watermark immagine?

ImageWatermark rappresenta un watermark basato su immagine, come un logo o un sigillo. Istanzia un ImageWatermark con il percorso o lo stream del tuo logo, quindi aggiungilo in modo simile al watermark di testo. L’SDK scala automaticamente l’immagine per adattarla alla pagina preservando il suo rapporto d’aspetto, e puoi regolare opacità, rotazione e posizionamento per ottenere l’effetto visivo desiderato senza distorcere il contenuto originale.

ImageWatermark imgWatermark = new ImageWatermark("C:/images/logo.png");
imgWatermark.setTransparency(0.3);
watermarker.add(imgWatermark);

L’SDK scala l’immagine per adattarla alla pagina preservando il rapporto d’aspetto.

Come salvare il documento watermarked?

save scrive il documento modificato nella posizione specificata nel formato scelto. Chiama save con il percorso di output e il formato desiderato. Lo stesso formato del sorgente viene usato quando ometti il parametro del formato. Il metodo scrive il PDF modificato su disco, preservando tutto il contenuto originale eccetto i nuovi livelli di watermark aggiunti, e supporta il salvataggio su stream per ulteriori elaborazioni.

watermarker.save("C:/files/output.pdf");

Il metodo scrive il PDF modificato su disco, preservando tutto il contenuto originale eccetto i nuovi livelli di watermark aggiunti.

Tutorial disponibili

Come caricare documenti protetti da password in Java usando GroupDocs.Watermark

Scopri come caricare e gestire i watermark in documenti protetti da password usando GroupDocs.Watermark per Java. Questa guida fornisce istruzioni passo‑passo, esempi pratici e suggerimenti per la risoluzione dei problemi.

Come caricare e watermarcare documenti Word protetti da password usando GroupDocs.Watermark in Java

Scopri come usare GroupDocs.Watermark con Java per caricare, gestire e applicare watermark a documenti Word protetti da password in modo efficiente.

Risorse aggiuntive

Problemi comuni e soluzioni

  • Errore di password non valida – verifica la stringa della password; deve essere codificata in UTF‑8.
  • Out‑of‑memory su PDF di grandi dimensioni – abilita la modalità streaming usando i costruttori Watermarker che accettano InputStream e OutputStream.
  • Watermark non visibile – assicurati che l’opacità del watermark sia impostata sopra 0.1 e che il colore contrasti con lo sfondo della pagina.

Domande frequenti

Q: Posso aggiungere più watermark allo stesso PDF?
A: Sì. Chiama watermarker.add() ripetutamente con diversi oggetti TextWatermark o ImageWatermark; ciascuno sarà sovrapposto nell’ordine in cui è aggiunto.

Q: La libreria preserva le annotazioni esistenti?
A: Assolutamente. Tutti gli oggetti PDF originali, incluse annotazioni, campi modulo e metadati, rimangono intatti a meno che non li modifichi esplicitamente.

Q: È possibile applicare watermark solo a pagine selezionate?
A: Sì. Passa un PageRange (ad esempio new PageRange(2, 4)) al metodo add per limitare il watermark a pagine specifiche.

Q: Qual è la dimensione massima del file supportata?
A: L’SDK può gestire file fino a 2 GB senza caricare l’intero documento in memoria, grazie alla sua architettura di streaming.

Q: Come rimuovere un watermark dopo che è stato aggiunto?
A: Usa watermarker.remove(watermarkId) dove watermarkId è l’identificatore restituito quando hai inizialmente aggiunto il watermark.

Ultimo aggiornamento: 2026-09-16
Testato con: GroupDocs.Watermark 23.9 for Java
Autore: GroupDocs

Tutorial correlati