Watermerk invoegen in Excel met Java

Het insluiten van een watermerk in een spreadsheet helpt gevoelige gegevens te beschermen en geeft eigendom van het document aan. Conholdate.Total for Java biedt een eenvoudige API waarmee je een watermerk in Excel in Java kunt invoegen met slechts een paar regels code. Deze gids leidt je door de benodigde configuratie, de volledige implementatie en belangrijke configuratie‑opties zodat je je Excel‑werkboeken efficiënt kunt beveiligen.

Hoe een Watermerk in Excel in Java Invoegen - Stap voor Stap

Laad de Werkmap met ExcelLoadOptions

1. Laad de Excel-werkmap: Gebruik Watermarker samen met ExcelLoadOptions om het bestand te openen.

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

De Watermarker-klasse is gedocumenteerd in de API-referentie. Laden met ExcelLoadOptions geeft je controle over het geheugenverbruik, wat essentieel is voor grote werkmappen.

Maak een tekstwatermerk met opmaak

2. Maak een tekstwatermerk: Definieer lettertype, kleur, doorzichtigheid, rotatie en uitlijning.

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);

Het instellen van opacity op 0.3 maakt het watermerk semi‑transparant, terwijl een rotatie van 45 graden het diagonaal over het blad plaatst. Je kunt deze waarden aanpassen om te voldoen aan merkrichtlijnen of nalevingsvereisten.

Watermerk toepassen op alle werkbladen

3. Voeg het watermerk toe aan de werkmap: De add‑methode past het toe op elk werkblad in één enkele oproep.

watermarker.add(watermark);

Als je per‑werkblad controle nodig hebt, kun je individuele werkbladen ophalen via watermarker.getWorksheets() en add voor elk afzonderlijk aanroepen.

Sla het watergemarkeerde werkboek op

4. Sla het watergemarkeerde werkboek op: Kies ExcelSaveOptions om het uitvoerformaat te regelen en de oorspronkelijke metadata te behouden.

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

Het ExcelSaveOptions-object stelt je in staat om op te geven of je de oorspronkelijke bestandsversie wilt behouden of wilt upgraden naar de nieuwste XLSX standaard.

Bronnen vrijgeven om geheugenlekken te voorkomen

5. Sluit de Watermarker: Geef bronnen vrij om geheugenlekken te voorkomen, vooral bij het verwerken van veel bestanden in één batch.

watermarker.close();

Het sluiten van de Watermarker zorgt er ook voor dat eventuele openstaande schrijfoperaties worden weggeschreven, zodat het uitvoerbestand niet beschadigd raakt.

Deze stappen illustreren hoe je een watermerk in Excel in Java kunt invoegen, terwijl je controle hebt over het uiterlijk en de prestaties.

Volledig codevoorbeeld: Watermerk invoegen in Excel in Java - Volledig Java-watermerk

De volgende code toont het volledige proces van het laden van de werkmap tot het opslaan van het resultaat.

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();
            }
        }
    }
}

Opmerking: Dit codevoorbeeld toont de kernfunctionaliteit. Voordat u het in uw project gebruikt, moet u de bestandspaden (input.xlsx, output_watermarked.xlsx) aanpassen zodat ze overeenkomen met uw werkelijke bestandslocaties, controleren of alle vereiste afhankelijkheden correct zijn geïnstalleerd, en grondig testen in uw ontwikkelomgeving. Als u problemen ondervindt, raadpleeg dan de officiële documentatie of neem contact op met het ondersteuningsteam voor hulp.

De omgeving gereed maken

Maven-repository en afhankelijkheid toevoegen

Voeg de Conholdate Maven-repository en de SDK-afhankelijkheid toe aan je 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>

U kunt de nieuwste JAR‑bestanden ook rechtstreeks van de downloadpagina downloaden. De SDK vereist Java 8 of hoger, en een compatibele IDE zoals IntelliJ IDEA of Eclipse maakt het debuggen gemakkelijker.

Licenties configureren (productiegebruik)

Voordat u de watermerkcode in een productieomgeving uitvoert, past u uw licentiebestand toe:

import com.groupdocs.watermark.License;

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

Een tijdelijke licentie is beschikbaar voor evaluatie op de tijdelijke licentiepagina. Voor langetermijnprojecten, bekijk de prijspagina om het juiste plan te kiezen.

Wat maakt Conholdate.Total for Java geschikt voor Excel-watermerken

Uitgebreide XLS/XLSX-ondersteuning

De bibliotheek verwerkt zowel legacy XLS als moderne XLSX-formaten zonder conversie, en behoudt formules, grafieken en macro’s.

Efficiënte streamingmodus voor grote werkboeken

Bij het werken met werkboeken die duizenden rijen bevatten, schakelt u streaming in door loadOptions.setLoadAllWorksheets(false) in te stellen. Dit vermindert het geheugenverbruik drastisch.

Uitgebreide opties voor watermerkstyling

U kunt het lettertype, de grootte, de kleur, de dekking, de rotatiehoek en de uitlijning regelen. De onderstaande tabel geeft een overzicht van de meest vaak aangepaste eigenschappen:

Automatic Worksheet Coverage

Een enkele aanroep van watermarker.add(watermark) verspreidt het watermerk naar elk blad, waardoor je geen repetitieve lussen meer hoeft te schrijven.

Eenvoudige opslaanopties

ExcelSaveOptions stelt u in staat om het oorspronkelijke bestandsformaat te behouden of te upgraden naar de nieuwste XLSX-versie, en u kunt ook opgeven of macro’s behouden moeten worden.

Al deze mogelijkheden worden in detail beschreven in de officiële documentatie.

Conclusie

In deze tutorial heb je geleerd hoe je een watermerk in Excel in Java kunt invoegen met behulp van de krachtige functies van Conholdate.Total for Java. Door de stapsgewijze handleiding te volgen, kun je je spreadsheets beschermen met aangepaste tekst, het uiterlijk regelen en grote bestanden efficiënt verwerken. Voor productie‑implementaties heb je een gelicentieerde versie nodig; bekijk de prijzen op de prijspagina en verkrijg een tijdelijke licentie via de pagina voor tijdelijke licentie om de SDK te evalueren.

Veelgestelde vragen

• Hoe voeg ik een afbeelding‑watermerk toe in plaats van tekst?
  Gebruik de ImageWatermark‑klasse, stel de dekking en uitlijning in, en voeg deze toe aan de Watermarker‑instantie net als in het tekstvoorbeeld. De afbeelding kan een PNG, JPEG, of BMP zijn, en u kunt deze ook schalen om op het werkblad te passen. Zie de API‑referentie voor details.

• Zal het watermerk zichtbaar zijn na het converteren van de werkmap naar PDF?
  Ja. Het watermerk is ingebed in de werkmap en zal verschijnen in elk formaat dat u later converteert, zoals PDF, bij gebruik van Conholdate.Total for Java. Het conversieproces behoudt alle visuele elementen, inclusief watermerken.

• Kan ik de watermerk per werkblad regelen?
  De SDK past het watermerk standaard toe op alle werkbladen, maar je kunt individuele werkbladen laden met watermarker.getWorksheets().get_Item(index) en add selectief op elk van hen aanroepen. Dit geeft je fijnmazige controle voor rapporten die per blad een andere branding vereisen.

• Moet ik een licentie hebben voor ontwikkeling en testen?
  Een tijdelijke licentie is beschikbaar voor evaluatie op de pagina tijdelijke licentie. Voor commercieel gebruik koopt u een volledige licentie via de prijspagina. Het licentiebestand moet tijdens runtime worden geladen zoals weergegeven in de sectie Setup.

Lees meer

• Excel naar afbeelding converteren in Java
• Rijen of kolommen automatisch aanpassen in Excel met Java
• Afbeelding naar grijstinten converteren in Java