Wenn Sie in Java ein Wasserzeichen zu PDF hinzufügen müssen, kann ein visuelles Overlay Ihre Dokumente vor unbefugter Nutzung schützen. Conholdate.Total for Java bietet ein leistungsstarkes SDK, das die PDF‑Manipulation auf der Serverseite vereinfacht. In diesem Leitfaden sehen Sie ein vollständiges, sofort ausführbares Beispiel, erfahren, wie jede Zeile funktioniert, richten die Maven‑Abhängigkeit ein und entdecken Optionen, um Deckkraft, Drehung und Ausrichtung für professionelle Ergebnisse fein abzustimmen.

Vollständiges Codebeispiel: Hinzufügen eines Textwasserzeichens zu PDF in Java

Das folgende Beispiel zeigt, wie man ein Textwasserzeichen zu einer PDF hinzufügt, indem man Conholdate.Total for Java verwendet.

import com.groupdocs.watermark.Watermark;
import com.groupdocs.watermark.options.PdfLoadOptions;
import com.groupdocs.watermark.options.PdfSaveOptions;
import com.groupdocs.watermark.watermarks.TextWatermark;
import com.groupdocs.watermark.watermarks.HorizontalAlignment;
import com.groupdocs.watermark.watermarks.VerticalAlignment;
import java.awt.Color;
import java.awt.Font;

public class AddPdfWatermark {
    public static void main(String[] args) {
        String inputFile = "input.pdf";
        String outputFile = "output.pdf";

// Create a text watermark
        Font font = new Font("Arial", Font.BOLD, 48);
        TextWatermark textWatermark = new TextWatermark("CONFIDENTIAL", font);
        textWatermark.setColor(Color.RED);
        textWatermark.setOpacity(0.3);
        textWatermark.setRotationAngle(45);
        textWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
        textWatermark.setVerticalAlignment(VerticalAlignment.Center);

// Load options for the source PDF (enable caching for large files)
        PdfLoadOptions loadOptions = new PdfLoadOptions(inputFile);
        loadOptions.setCacheSize(100 * 1024 * 1024); // 100 MB cache

// Initialize the Watermark processor
        Watermark watermark = new Watermark();

try {
            // Apply the watermark to every page of the PDF
            watermark.add(textWatermark, loadOptions);

// Save the watermarked PDF
            PdfSaveOptions saveOptions = new PdfSaveOptions();
            watermark.save(outputFile, saveOptions);
        } catch (Exception e) {
            System.err.println("Failed to add watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.pdf, output.pdf usw.) an Ihre tatsächlichen Dateistandorte anpassen, dass alle erforderlichen Abhängigkeiten korrekt installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Verständnis des Hinzufügens von Wasserzeichen zu PDF im Java-Code

Der Code zum Hinzufügen eines Wasserzeichens zu PDF in Java folgt einer klaren Reihenfolge, die Sie für jedes PDF‑Dokument anpassen können.

  1. Initialisieren des Wasserzeichenprozessors - Watermark watermark = new Watermark(); erstellt die Engine, die Wasserzeichen anwendet.
  2. Erstellen eines TextWatermark - Das TextWatermark-Objekt enthält den Text, die Schriftart, die Farbe, die Deckkraft und die Drehung.
    Font font = new Font("Arial", Font.BOLD, 48);
TextWatermark textWatermark = new TextWatermark("CONFIDENTIAL", font);
  3. Aussehen konfigurieren - Methoden wie setColor, setOpacity und setRotationAngle bestimmen, wie das Wasserzeichen auf der Seite aussieht.
  4. Laden der Quell-PDF - PdfLoadOptions lädt die Eingabedatei und aktiviert das Caching für große Dokumente, was den Speicherverbrauch reduziert.
  5. Anwenden und Speichern - watermark.add(textWatermark, loadOptions); wendet das Wasserzeichen auf jede Seite an, und watermark.save(outputFile, saveOptions); schreibt das Ergebnis.

Laden der Quell-PDF mit Caching

Wenn Sie mit PDFs von mehreren Megabyte arbeiten, verhindert das Aktivieren eines Caches, dass das SDK das gesamte Dokument in den Speicher lädt. Die Zeile loadOptions.setCacheSize(100 * 1024 * 1024); reserviert 100 MB für temporären Speicher, sodass der Prozessor Seiten bei Bedarf streamen kann. Dieser Ansatz ist besonders nützlich in Serverumgebungen, in denen viele gleichzeitige Wasserzeichen‑Aufgaben ausgeführt werden können.

Für detaillierte API-Informationen siehe die Java API-Referenz.

Umgebung für PDF-Wasserzeichen vorbereiten

Der Workflow zum Hinzufügen eines Wasserzeichens zu PDF in Java beginnt mit dem Hinzufügen der Maven‑Abhängigkeit. Danach benötigen Sie ein kompatibles JDK und eine kleine Menge an Konfiguration.

Voraussetzungen und Java-Version

  • Java 8 oder höher ist erforderlich; das SDK verwendet moderne Sprachfeatures und Streams.
  • Maven 3.5+ vereinfacht das Abhängigkeitsmanagement.
  • Stellen Sie sicher, dass das pom.xml Ihres Projekts das Conholdate-Repository enthält, damit Maven das Artefakt auflösen kann.
<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>

Sie können die JAR‑Dateien auch direkt von der Download‑Seite erhalten. Nachdem Sie die Abhängigkeit hinzugefügt haben, führen Sie mvn clean install aus, um zu überprüfen, dass das SDK in Ihrem Klassenpfad ist.

Verwendung der REST-API (Optional)

Wenn Sie einen sprachunabhängigen Ansatz bevorzugen, bietet Conholdate.Total ebenfalls einen REST‑Endpunkt, der Wasserzeichen hinzufügen kann, ohne dass Java‑Code erforderlich ist. Ein einfacher curl‑Befehl sieht folgendermaßen aus:

curl -X POST "https://api.conholdate.com/v1/pdf/watermark" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@input.pdf" \
  -F "text=CONFIDENTIAL" \
  -F "font=Arial" \
  -F "fontSize=48" \
  -F "color=FF0000" \
  -F "opacity=0.3" \
  -F "angle=45" \
  -F "horizontalAlignment=center" \
  -F "verticalAlignment=center" \
  -o output.pdf

Die REST-Version folgt denselben logischen Schritten Laden, Konfigurieren, Anwenden und Speichern, sodass Sie den Ansatz wählen können, der am besten zu Ihrer Architektur passt.

Konfigurieren des Wasserzeichen‑Aussehens und der Position

Das SDK stellt mehrere Eigenschaften bereit, mit denen Sie das Wasserzeichen feinabstimmen können. Nachfolgend sind die am häufigsten angepassten Einstellungen aufgeführt.

Anpassen von Schriftart und Farbe

Sie können die Standardschriftart Arial durch jede auf dem Server verfügbare TrueType‑Schrift ersetzen. Das Ändern der Farbe ist genauso einfach, indem Sie eine andere java.awt.Color‑Konstante übergeben oder einen benutzerdefinierten RGB‑Wert erstellen.

Font customFont = new Font("Times New Roman", Font.ITALIC, 36);
textWatermark.setColor(new Color(0, 102, 204)); // Deep blue
textWatermark.setFont(customFont);

Anpassen von Deckkraft und Drehung

Die Opazität steuert, wie transparent das Wasserzeichen erscheint. Werte reichen von 0.0 (vollständig unsichtbar) bis 1.0 (vollständig undurchsichtig). Die Drehung lässt Sie den Text kippen, um das Entfernen zu erschweren.

textWatermark.setOpacity(0.45);      // 45% opacity
textWatermark.setRotationAngle(30); // 30 degrees clockwise

Ausrichten des Wasserzeichens auf der Seite

Horizontale und vertikale Ausrichtungs‑Eigenschaften akzeptieren Left, Center, Right und Top, Center, Bottom. Zentrieren ist üblich für vertrauliche Stempel, aber Sie können das Wasserzeichen zu Marken­zwecken in einer Ecke platzieren.

textWatermark.setHorizontalAlignment(HorizontalAlignment.Right);
textWatermark.setVerticalAlignment(VerticalAlignment.Bottom);

Wenn Sie Textwasserzeichen zu PDF in Java hinzufügen möchten, mit einem anderen Layout auf jeder Seite, können Sie diese Eigenschaften in einer Schleife ändern, die die Seiten einzeln verarbeitet. Das SDK unterstützt außerdem Bildwasserzeichen, Farbverläufe und mehrzeiligen Text, falls Ihr Anwendungsfall mehr visuelle Komplexität erfordert.

Fazit

Das Hinzufügen eines Wasserzeichens zu PDF in Java ist mit Conholdate.Total for Java unkompliziert. Das SDK übernimmt das Laden, Verarbeiten und Speichern von PDFs effizient, selbst bei großen Dateien dank integriertem Caching. Durch Anpassen von Transparenz, Drehung, Schriftart, Farbe und Ausrichtung können Sie professionell aussehende Wasserzeichen erstellen, die eine unautorisierte Verbreitung verhindern. Denken Sie daran, für den Produktionseinsatz eine gültige Lizenz zu erwerben; Sie können eine temporäre Lizenz über die temporäre Lizenzseite anfordern oder die Preisoptionen auf der Preisübersichtsseite einsehen. Mit dem bereitgestellten Code und den Konfigurationsschritten sind Sie bereit, PDF‑Wasserzeichen in Ihre Java‑Anwendungen zu integrieren.

FAQs

Wie kann ich in Java ein Wasserzeichen zu PDF hinzufügen, ohne Low‑Level-PDF-Code zu schreiben?
Verwenden Sie die Watermark‑Klasse von Conholdate.Total for Java. Sie abstrahiert die PDF‑Struktur, sodass Sie sich auf Wasserzeichen‑Eigenschaften wie Text, Schriftart und Platzierung konzentrieren können.

Welche Optionen stehen zur Verfügung, um das Textwasserzeichen zu formatieren?
Sie können die Schriftart (new Font(...)), Größe, Stil (fett, kursiv), Farbe (setColor), Transparenz (setOpacity), Drehung (setRotationAngle) und Ausrichtung (setHorizontalAlignment, setVerticalAlignment) festlegen. Diese Optionen werden im vollständigen Codebeispiel demonstriert.

Ist das SDK in der Lage, große PDFs effizient zu verarbeiten?
Ja. Durch die Konfiguration von PdfLoadOptions.setCacheSize aktivieren Sie Streaming und Caching, was den Speicherverbrauch für mehr‑megabyte‑große PDFs reduziert. Dadurch ist der Workflow „add Watermark to PDF in Java“ für die Stapelverarbeitung auf Servern geeignet.

Muss ich eine Lizenz erwerben, um dieses Beispiel auszuführen?
Eine Lizenz ist für Produktionsbereitstellungen erforderlich. Holen Sie sich eine temporäre Lizenz von der temporary license page oder erkunden Sie die vollständigen Preisinformationen auf der pricing page.

Mehr lesen