Znak wodny PDF w Javie – Dodaj tekst do adnotacji obrazów

Chronienie plików PDF przed nieautoryzowanym rozpowszechnianiem jest codziennym problemem dla programistów. Watermark PDF Java pozwala osadzić widoczny tekst bezpośrednio na adnotacjach obrazów, zapewniając, że każda strona zawiera Twoje logo lub informację poufności. W tym samouczku zobaczysz, dlaczego to podejście jest niezawodne, co jest potrzebne do rozpoczęcia oraz implementację krok po kroku przy użyciu GroupDocs.Watermark dla Javy.

Szybkie odpowiedzi

  • Co robi biblioteka? Dodaje, edytuje lub usuwa znaki wodne w plikach PDF, Word, Excel i obrazach.
  • Która główna metoda tworzy znak wodny? Watermark.add() zastosowana do obiektu Annotation.
  • Czy potrzebuję licencji do rozwoju? Darmowa wersja próbna działa do testów; stała licencja jest wymagana w produkcji.
  • Czy mogę przetwarzać duże pliki PDF? Tak – API strumieniuje strony, obsługując pliki > 500 MB bez ładowania całego dokumentu do pamięci.
  • Czy rozwiązanie jest wątkowo‑bezpieczne? Wszystkie publiczne metody są bezstanowe, więc możesz bezpiecznie uruchamiać wiele instancji równolegle.

Czym jest watermark pdf java?

watermark pdf java odnosi się do możliwości dodawania wizualnych znaków wodnych do dokumentów PDF z kodu Java, zazwyczaj przy użyciu biblioteki takiej jak GroupDocs.Watermark. Pomaga to wymusić własność, poufność lub branding bezpośrednio w pliku, zachowując oryginalny układ i umożliwiając precyzyjną kontrolę nad wyglądem i pozycjonowaniem.

Dlaczego używać GroupDocs.Watermark dla Javy?

GroupDocs.Watermark obsługuje ponad 50 formatów wejściowych i wyjściowych, przetwarza wielostronicowe PDF‑y w mniej niż 2 sekundy na standardowym sprzęcie i nie wymaga zainstalowanego pełnego przeglądarki PDF. Jego silnik świadomy adnotacji zachowuje oryginalny układ, jednocześnie wstawiając tekstowe znaki wodne z regulowaną przezroczystością, rotacją i stylizacją czcionki, co czyni go szybkim i niezawodnym wyborem do znakowania na poziomie przedsiębiorstwa.

Wymagania wstępne

  • Java Development Kit (JDK) 8 lub wyższy.
  • Maven (lub ręczne dołączanie JAR‑ów) do zarządzania zależnościami.
  • Podstawowa znajomość struktury PDF oraz koncepcji programowania w Javie.

Jakie są wymagania wstępne do znakowania PDF‑ów w Javie?

Potrzebujesz kompatybilnego JDK, Maven (lub plików JAR) oraz ważnej licencji GroupDocs.Watermark. Biblioteka działa na każdym systemie operacyjnym obsługującym Java 8+, i współpracuje z Java 11, 17 oraz nowszymi wersjami LTS. Dodatkowo, upewnij się, że Twój projekt ma wystarczającą pamięć heap (co najmniej 2 GB) do przetwarzania dużych PDF‑ów oraz że masz uprawnienia zapisu do katalogu wyjściowego.

Konfiguracja GroupDocs.Watermark dla Javy

Zanim napiszesz jakikolwiek kod, dodaj bibliotekę do swojego projektu.

Konfiguracja Maven

Add the following to your pom.xml file:

<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

Alternatywnie, pobierz najnowszą wersję z GroupDocs.Watermark for Java releases.

Uzyskanie licencji

  • Free Trial – przetestuj podstawowe funkcje bez opłat.
  • Temporary License – odblokuj pełne możliwości podczas rozwoju.
  • Purchase – uzyskaj stałą licencję do użytku produkcyjnego i wsparcie premium.

Podstawowa inicjalizacja

Watermark jest klasą wejściową, która ładuje dokument, stosuje obiekty znaków wodnych i zapisuje wynik.

import com.groupdocs.watermark.Watermarker;

public class WatermarkDemo {
    public static void main(String[] args) {
        // Initialize the watermarker with your PDF document path
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        try (Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions)) {
            System.out.println("Setup complete!");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Jak dodać tekstowy znak wodny do adnotacji obrazów PDF przy użyciu GroupDocs.Watermark dla Javy?

Watermark.load() ładuje dokument PDF do API Watermark w celu przetworzenia. TextWatermark reprezentuje tekstowy znak wodny z możliwością dostosowania czcionki, rozmiaru, koloru, przezroczystości i rotacji. ImageAnnotation jest adnotacją PDF zawierającą osadzony obraz, którą można poddać znakowaniu. annotation.addWatermark() dołącza utworzony znak wodny do adnotacji, a watermark.save() zapisuje zmodyfikowany dokument w określonej ścieżce.

Załaduj swój PDF za pomocą Watermark.load("sample.pdf"), utwórz instancję TextWatermark, przeiteruj każdą ImageAnnotation i wywołaj annotation.addWatermark(textWatermark). Na koniec zapisz zmodyfikowany dokument przy użyciu watermark.save("output.pdf"). Ten zwięzły przepływ obsługuje dowolną liczbę adnotacji w jednym przebiegu i zachowuje oryginalne metadane adnotacji.

Dodawanie tekstowego znaku wodnego do adnotacji obrazów PDF

Poniższe sekcje opisują każdy krok.

Krok 1: Załaduj dokument PDF

Otwórz docelowy plik PDF, aby API mogło przeglądać jego obiekty adnotacji.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.PdfLoadOptions;

PdfLoadOptions loadOptions = new PdfLoadOptions();
try (Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions)) {
    System.out.println("PDF loaded successfully.");
}

Krok 2: Utwórz tekstowy znak wodny

TextWatermark reprezentuje tekstowy znak wodny z możliwością dostosowania czcionki, rozmiaru, koloru, przezroczystości i rotacji.

import com.groupdocs.watermark.contents.PdfAnnotation;
import com.groupdocs.watermark.watermarks.TextWatermark;
import java.awt.Font;
import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.saving.SizingType;

TextWatermark textWatermark = new TextWatermark("Confidential", new Font("Arial", 36));
textWatermark.setHorizontalAlignment(HorizontalAlignment.Center);
textWatermark.setVerticalAlignment(VerticalAlignment.Bottom);
textWatermark.setSizingType(SizingType.ScaleToParentDimensions);
textWatermark.setScaleFactor(0.5);

Krok 3: Zastosuj znak wodny do adnotacji

ImageAnnotation jest adnotacją PDF zawierającą osadzony obraz, którą można poddać znakowaniu.

import com.groupdocs.watermark.contents.PdfPage;

for (PdfPage page : watermarker.getContent().getPages()) {
    for (PdfAnnotation annotation : page.getAnnotations()) {
        // Add watermark to image annotations
        if (annotation.getImageData() != null) {
            annotation.addWatermark(textWatermark);
        }
    }
}

Krok 4: Zapisz oznaczony znakami wodnymi PDF

watermark.save() zapisuje zmodyfikowany dokument w określonej ścieżce.

watermarker.save("YOUR_DOCUMENT_DIRECTORY/watermarked_document.pdf");
System.out.println("Document saved with watermark.");

Typowe problemy i rozwiązania

  • Missing Dependencies – Sprawdź, czy wszystkie artefakty GroupDocs są wymienione w pom.xml.
  • File Path Issues – Używaj ścieżek bezwzględnych lub Paths.get(), aby uniknąć niespodzianek związanych ze ścieżkami względnymi.
  • Unsupported Annotation Types – API obecnie obsługuje ImageAnnotation, TextAnnotation i StampAnnotation; inne typy wymagają obsługi niestandardowej.

Praktyczne zastosowania

Dodawanie tekstowego znaku wodnego do adnotacji obrazów PDF jest szczególnie przydatne do:

  1. Dokumenty prawne – Oznacz umowy jako „Poufne – wyłącznie do użytku wewnętrznego”.
  2. Raporty poufne – Zapobiegaj przypadkowym wyciekom, osadzając etykietę obejmującą całą firmę.
  3. Materiały marketingowe – Oznacz promocyjne PDF‑y subtelnym nakładaniem logo‑tekstu.
  4. Szkice akademickie – Wskaż „Szkic – Nie rozpowszechniać” na pracach badawczych przed recenzją.

Rozważania dotyczące wydajności

  • Batch Processing – Grupuj wiele PDF‑ów w jednym puli wątków, aby zminimalizować narzut JVM.
  • Memory Management – Biblioteka strumieniuje strony, więc przydziel co najmniej 2 GB pamięci heap dla plików większych niż 200 MB.
  • Watermark Settings – Niższa przezroczystość (np. 30 %) zmniejsza wizualny bałagan, pozostając jednocześnie wykrywalna.

Najczęściej zadawane pytania

Q: Czy mogę dodawać znaki wodne do innych typów adnotacji?
A: Tak, możesz celować w TextAnnotation, StampAnnotation lub własne obiekty adnotacji, używając tej samej metody addWatermark.

Q: Czy istnieje limit liczby znaków wodnych, które mogę umieścić na stronie?
A: Nie ma sztywnego limitu, ale utrzymuj łączną przezroczystość poniżej 70 %, aby zachować czytelność i uniknąć spadku wydajności.

Q: Jak usunąć znak wodny po jego zastosowaniu?
A: Użyj annotation.removeWatermark(watermarkId) lub wywołaj Watermark.removeAll(), aby usunąć wszystkie znaki wodne z dokumentu.

Q: Czy biblioteka obsługuje PDF‑y zabezpieczone hasłem?
A: Tak – podaj hasło podczas ładowania dokumentu: Watermark.load("secure.pdf", "myPassword").

Q: Jaki jest maksymalny obsługiwany rozmiar pliku?
A: API może przetwarzać pliki do 2 GB na 64‑bitowym JVM; większe pliki należy podzielić na sekcje przed znakowaniem.

Zasoby

Ostatnia aktualizacja: 2026-07-30
Testowano z: GroupDocs.Watermark 23.9 for Java
Autor: GroupDocs

Powiązane samouczki