Jak dodać znak wodny do PDF przy użyciu GroupDocs.Watermark dla Javy

W dzisiejszym świecie cyfrowym jak dodać znak wodny do PDF jest częstym pytaniem osób, które muszą chronić własność intelektualną lub zasoby marki. Dodawanie znaków wodnych — zarówno tekstowych, jak i graficznych — pomaga wymusić **bezpieczeńnia nieautoryzowaną dystrybucję. W tym samouczku krok po kroku dowiesz się, jak używać GroupDocs.Watermark dla Javy, aby dodać zarówno tekstowe, jak i graficzne znaki wodne do dokumentów PDF.

Szybkie odpowiedzi

Jaką bibliotekę dodać znaki wodne do PDF w Javie? GroupDocs.Watermark dla odstr kopiowania:

Java Development Kit (JDK) 8+ zainstalowany na komputerze.
GroupDocs.Watermark dla Javy (najnowsza wersja).
Maven (lub możliwość ręcznego dodania pliku JAR).

Konfiguracja środowiska

Konfiguracja Maven

Dodaj repozytorium GroupDocs oraz zależność watermark do swojego pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Bezpośrednie pobranie

Jeśli nie chcesz używać Maven, możesz pobrać plik JAR bezpośrednio z GroupDocs.Watermark for Java releases.

Uzyskanie licencji

Aby rozpocząć od wersji próbnej lub uzyskać tymczasową licencję, odwiedź GroupDocs Licensing. W przypadku produkcyjnego użycia zakup subskrypcję, aby odblokować wszystkie funkcje.

Konfiguracja GroupDocs.Watermark dla Javy

Zaimportuj podstawową klasę, która steruje wszystkimi operacjami znakowania:

import com.groupdocs.watermark.Watermarker;

Ten import daje dostęp do klasy Watermarker, będącej punktem wejścia do dodawania znaków wodnych do dowolnego obsługiwanego typu dokumentu.

Implementacja krok po kroku

Poniżej dzielimy proces na logiczne sekcje: tworzenie znaków wodnych tekstowych, tworzenie znaków wodnych graficznych oraz ich stosowanie do obrazów wewnątrz PDF.

1. Inicjalizacja tekstowego znaku wodnego

Dlaczego tekstowy znak wodny? Jest lekki, przeszukiwalny i idealny do dodawania informacji o prawach autorskich lub oświadczeń poufności.

1.1 Utwórz instancję TextWatermark

// Create a text watermark with custom settings
TextWatermark textWatermark = new TextWatermark("Protected image", new Font("Arial", 8));

1.2 Ustaw wyrównanie

// Align watermark to the center of images
textWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
textWatermark.setVerticalAlignment(VerticalAlignment.Center);

1.3 Obróć znak wodny

// Rotate the watermark by 45 degrees
textWatermark.setRotateAngle(45);

1.4 Skonfiguruj rozmiar

// Scale watermark based on parent image size
textWatermark.setSizingType(SizingType.ScaleToParentDimensions);
textWatermark.setScaleFactor(1);

2. Inicjalizacja graficznego znaku wodnego

Kiedy używać graficznego znaku wodnego? Idealny do brandingu za pomocą logotypów lub do dodawania złożonych wzorów wizualnych.

2.1 Załaduj plik obrazu

// Load an image file as a watermark
ImageWatermark imageWatermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY\\ProtectJpg");

2.2 Ustaw wyrównanie

// Align image watermark to the center
imageWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
imageWatermark.setVerticalAlignment(VerticalAlignment.Center);

2.3 Obróć graficzny znak wodny

// Rotate the image watermark by -45 degrees
textWatermark.setRotateAngle(-45);

2.4 Skonfiguruj rozmiar

// Scale the image watermark relative to its parent dimensions
imageWatermark.setSizingType(SizingType.ScaleToParentDimensions);
imageWatermark.setScaleFactor(1);

3. Dodawanie znaków wodnych do obrazów wewnątrz PDF

Teraz połączymy wszystko: otworzymy PDF, znajdziemy każdy obraz i zastosujemy odpowiedni znak wodny (tekstowy lub graficzny) w zależności od rozmiaru.

3.1 Otwórz dokument PDF

// Open the PDF containing images for watermarking
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY\\document.pdf");

3.2 Pobierz wszystkie obrazy

// Get a collection of all images within the PDF
WatermarkableImageCollection images = watermarker.getImages();

3.3 Zastosuj znaki wodne warunkowo

for (int i = 0; i < images.getCount(); i++) {
    // Check if the image exceeds specific size criteria
    if (images.get_Item(i).getWidth() > 100 && images.get_Item(i).getHeight() > 100) {
        // Alternate between text and image watermarks
        if (i % 2 == 0) {
            images.get_Item(i).add(textWatermark);
        } else {
            images.get_Item(i).add(imageWatermark);
        }
    }
}

3.4 Zwolnij zasoby obrazów

// Close the image watermark instance after use
imageWatermark.close();

3.5 Zapisz zmodyfikowany PDF

// Save the PDF with added watermarks in a new file
watermarker.save("YOUR_OUTPUT_DIRECTORY\\document.pdf");

3.6 Sprzątanie

// Close the main watermarker to release document resources
watermarker.close();

Praktyczne zastosowania znakowania PDF

Przypadek użycia	Jak znakowanie pomaga
Bezpieczeństwo dokumentu	Oznacza pliki poufne, odstraszając wycieki.
Ochrona marki	Osadza logotypy w materiałach marketingowych, wzmacniając tożsamość marki.
Twierdzenie praw autorskich	Dodaje imię autora lub symbol ©, aby potwierdzić własność.
Kontrola wersji	Wyświetla numery wersji lub daty bezpośrednio na stronie.

Typowe pułapki i wskazówki

Separatory ścieżek: Używaj podwójnych backslashów (\\) w Windows lub ukośników (/) w Linux/macOS, aby uniknąć FileNotFoundException.
Duże PDF‑y: Przetwarzaj obrazy partiami lub zwiększ rozmiar sterty JVM (-Xmx2g), aby zapobiec błędom OutOfMemory.
**Ogracają w kierunku przeciwnym do ruchu wskazówek zegara.

Najczęściej zadawane pytania

P: Czy mogę znakować PDF‑y zabezpieczone hasłem?
O: Tak. Otwórz dokument z hasłem, używ przyjmuje ciąg znaków hasła.

P: Czy biblioteka obsługuje inne formaty, takie jak DOCX czy PPTX?
O: Oczywiście. GroupDocs.Watermark działa również z Word, PowerPoint, Excel oraz plikami graficznymi.

P: Jak zmienić krycie (opacity) znaku wodnego?
O: Użyj setOpacity**P tylko na pierwszej stronie Watermarker`; po przetworzeniu zapisz strumień wyjściowy z powrotem w chmurze.

Zakończenie

Masz teraz kompletną, gotową do produkcji metodę jak dodać znak wodny do PDF przy użyciuąć solidne bezpieczeństwo dokumentu PDF, spełniające zarówno wymagania brandingowe inne funkcje biblioteki — takie jak usuwanie znaków wodnych czy przetwarzanie wsadowe — aby jeszcze bardziej rozbudować swój przepływ pracy z dokumentami.

Ostatnia aktualizacja: 2026-01-23
Testowano z: GroupDocs.Watermark 24.11 dla Javy
Autor: GroupDocs