Inserire una filigrana in Excel usando Java

Incorporare una filigrana in un foglio di calcolo aiuta a proteggere i dati sensibili e a segnalare la proprietà del documento. Conholdate.Total for Java fornisce un’API semplice che consente di inserire una filigrana in Excel in Java con poche righe di codice. Questa guida ti accompagna attraverso la configurazione necessaria, l’implementazione completa e le principali opzioni di configurazione, così da poter proteggere i tuoi workbook Excel in modo efficiente.

Come inserire una filigrana in Excel con Java - Passo dopo passo

Carica la cartella di lavoro con ExcelLoadOptions

1. Carica la cartella di lavoro Excel: Usa Watermarker insieme a ExcelLoadOptions per aprire il file.

Watermarker watermarker = new Watermarker(inputPath, new ExcelLoadOptions());

La classe Watermarker è documentata nel riferimento API. Caricare con ExcelLoadOptions ti consente di controllare l’utilizzo della memoria, il che è fondamentale per cartelle di lavoro di grandi dimensioni.

Crea una filigrana di testo con stile

2. Crea una filigrana di testo: definisci carattere, colore, opacità, rotazione e allineamento.

Font font = new Font("Arial", 36);
TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
watermark.setColor(Color.RED);
watermark.setOpacity(0.3);
watermark.setRotationAngle(45);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);

Impostare opacity a 0,3 rende la filigrana semi‑trasparente, mentre una rotazione di 45 gradi la posiziona diagonalmente sul foglio. È possibile regolare questi valori per rispettare le linee guida del brand o i requisiti di conformità.

Applica la filigrana a tutti i fogli di lavoro

3. Aggiungi la filigrana alla cartella di lavoro: Il metodo add la applica a ogni foglio di lavoro in una singola chiamata.

watermarker.add(watermark);

Se hai bisogno di un controllo per foglio di lavoro, puoi recuperare i singoli fogli di lavoro tramite watermarker.getWorksheets() e chiamare add su ciascuno separatamente.

Salva la cartella di lavoro con filigrana

4. Salva la cartella di lavoro con filigrana: scegli ExcelSaveOptions per controllare il formato di output e preservare i metadati originali.

watermarker.save(outputPath, new ExcelSaveOptions());

L’oggetto ExcelSaveOptions consente di specificare se mantenere la versione originale del file o aggiornarla allo standard più recente XLSX.

Rilasciare le risorse per evitare perdite di memoria

5. Chiudi il Watermarker: Rilascia le risorse per evitare perdite di memoria, soprattutto quando si elaborano molti file in batch.

watermarker.close();

Chiudere il Watermarker svuota anche eventuali operazioni di scrittura in sospeso, garantendo che il file di output non venga corrotto.

Questi passaggi illustrano come inserire una filigrana in Excel in Java, offrendo al contempo il controllo sull’aspetto e sulle prestazioni.

Esempio di codice completo: Inserire una filigrana in Excel in Java - Filigrana Java completa

Il codice seguente dimostra l’intero processo dal caricamento della cartella di lavoro al salvataggio del risultato.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.TextWatermark;
import com.groupdocs.watermark.common.Font;
import com.groupdocs.watermark.common.Color;
import com.groupdocs.watermark.contents.HorizontalAlignment;
import com.groupdocs.watermark.contents.VerticalAlignment;
import com.groupdocs.watermark.options.load.ExcelLoadOptions;
import com.groupdocs.watermark.options.save.ExcelSaveOptions;

public class ExcelWatermarkExample {
    public static void main(String[] args) {
        String inputPath = "input.xlsx";
        String outputPath = "output_watermarked.xlsx";

Watermarker watermarker = null;
        try {
            // Load the Excel workbook (works for both XLS and XLSX)
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            // For very large workbooks you can enable streaming mode:
            // loadOptions.setLoadAllWorksheets(false);
            watermarker = new Watermarker(inputPath, loadOptions);

// Create a text watermark with desired appearance
            Font font = new Font("Arial", 36);
            TextWatermark watermark = new TextWatermark("CONFIDENTIAL", font);
            watermark.setColor(Color.RED);
            watermark.setOpacity(0.3);               // 30% opacity
            watermark.setRotationAngle(45);          // diagonal
            watermark.setHorizontalAlignment(HorizontalAlignment.Center);
            watermark.setVerticalAlignment(VerticalAlignment.Center);

// Apply the watermark to all worksheets
            watermarker.add(watermark);

// Save the watermarked workbook
            ExcelSaveOptions saveOptions = new ExcelSaveOptions();
            watermarker.save(outputPath, saveOptions);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (watermarker != null) {
                watermarker.close();
            }
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.xlsx, output_watermarked.xlsx) per corrispondere alle tue reali posizioni, 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.

Preparare l’ambiente

Aggiungere il repository Maven e la dipendenza

Aggiungi il repository Maven di Conholdate e la dipendenza SDK al tuo pom.xml:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Puoi anche scaricare gli ultimi JAR direttamente dalla pagina di download. L’SDK richiede Java 8 o versioni successive e un IDE compatibile, come IntelliJ IDEA o Eclipse, renderà il debug più semplice.

Configurare la licenza (uso in produzione)

Prima di eseguire il codice del watermark in un ambiente di produzione, applica il tuo file di licenza:

import com.groupdocs.watermark.License;

License license = new License();
license.setLicense("path/to/Conholdate.Total.Java.lic");

Una licenza temporanea è disponibile per la valutazione nella pagina della licenza temporanea. Per progetti a lungo termine, consulta la pagina dei prezzi per scegliere il piano giusto.

Cosa rende Conholdate.Total for Java adatto per il watermarking di Excel

Supporto completo per XLS/XLSX

La libreria gestisce sia i formati legacy XLS che i moderni formati XLSX senza richiedere conversioni, preservando formule, grafici e macro.

Modalità di streaming efficiente per cartelle di lavoro di grandi dimensioni

Quando si lavora con cartelle di lavoro che contengono migliaia di righe, abilita lo streaming impostando loadOptions.setLoadAllWorksheets(false). Questo riduce drasticamente il consumo di memoria.

Opzioni di stile avanzate per filigrana

È possibile controllare la famiglia di caratteri, la dimensione, il colore, l’opacità, l’angolo di rotazione e l’allineamento. La tabella seguente riassume le proprietà più comunemente modificate:

Copertura automatica dei fogli di lavoro

Una singola chiamata a watermarker.add(watermark) propaga il watermark a tutti i fogli, risparmiandoti la scrittura di loop ripetitivi.

Simple Save Options

ExcelSaveOptions ti consente di mantenere il formato file originale o di aggiornare alla versione più recente di XLSX, e puoi anche specificare se preservare le macro.

Tutte queste funzionalità sono descritte in dettaglio nella documentazione ufficiale.

Conclusione

In questo tutorial hai imparato come inserire una filigrana in Excel in Java utilizzando le potenti funzionalità di Conholdate.Total for Java. Seguendo la guida passo‑passo, puoi proteggere i tuoi fogli di calcolo con testo personalizzato, controllare l’aspetto e gestire file di grandi dimensioni in modo efficiente. Per le distribuzioni in produzione avrai bisogno di una versione con licenza; esplora i prezzi nella pagina dei prezzi e ottieni una licenza temporanea dalla pagina della licenza temporanea per valutare l’SDK.

FAQ

• Come aggiungere una filigrana immagine invece di testo?
  Utilizza la classe ImageWatermark, imposta la sua opacità e allineamento, e aggiungila all’istanza Watermarker proprio come nell’esempio di testo. L’immagine può essere un PNG, un JPEG, o un BMP, e puoi anche ridimensionarla per adattarla al foglio di lavoro. Consulta il riferimento API per i dettagli.

• Il watermark sarà visibile dopo aver convertito la cartella di lavoro in PDF?
  Sì. Il watermark è incorporato nella cartella di lavoro e apparirà in qualsiasi formato in cui lo convertirai successivamente, come PDF, quando utilizzi Conholdate.Total for Java. Il processo di conversione conserva tutti gli elementi visivi, inclusi i watermark.

• Posso controllare il watermark per singolo foglio di lavoro?
  L’SDK applica il watermark a tutti i fogli di lavoro per impostazione predefinita, ma è possibile caricare singoli fogli di lavoro usando watermarker.getWorksheets().get_Item(index) e chiamare add su ciascuno in modo selettivo. Questo ti offre un controllo dettagliato per i report che richiedono un branding diverso per foglio.

• Ho bisogno di una licenza per lo sviluppo e il testing?
  È disponibile una licenza temporanea per la valutazione nella pagina della licenza temporanea. Per uso commerciale, acquista una licenza completa tramite la pagina dei prezzi. Il file di licenza deve essere caricato a runtime come mostrato nella sezione Setup.

Leggi di più

• Converti Excel in immagine in Java
• AutoFit righe o colonne in Excel usando Java
• Converti immagine in scala di grigi in Java