Dodaj znak wodny obrazu w Javie z GroupDocs.Watermark: kompleksowy przewodnik

Dodanie znaku wodnego obrazu w Javie jest powszechnym wymogiem w celu ochrony tożsamości marki i zapewnienia autentyczności dokumentu. W tym samouczku dowiesz się, jak add image watermark java używając biblioteki GroupDocs.Watermark, obejmując wszystko od ładowania pliku obrazu po wyszukiwanie istniejących znaków wodnych i wymianę ich na nowe grafiki. Po zakończeniu będziesz mieć wielokrotnego użytku wzorzec działający na dokumentach PDF, plikach Word oraz dokumentach opartych na obrazach.

Szybkie odpowiedzi

  • Która biblioteka obsługuje znaki wodne obrazu w Javie? GroupDocs.Watermark for Java.
  • Czy potrzebuję licencji do użytku produkcyjnego? Tak, licencja komercyjna usuwa ograniczenia wersji próbnej.
  • Czy mogę pracować z plikami PDF i Office? Tak, API obsługuje ponad 30 formatów.
  • Jaką wersję Javy wymaga się? JDK 8 lub nowszy.
  • Czy Maven jest jedynym sposobem dodania zależności? Maven jest zalecany, ale możesz również pobrać plik JAR ręcznie.

Co to jest add image watermark java?

add image watermark java odnosi się do procesu osadzania grafiki rastrowej (PNG, JPEG, BMP itp.) w dokumencie programowo przy użyciu kodu Java. Ta technika pozwala nakładać logotypy, informacje o prawach autorskich lub pieczątki bezpieczeństwa bez zmiany pierwotnego układu treści.

Dlaczego używać GroupDocs.Watermark dla Javy?

GroupDocs.Watermark obsługuje ponad 30 formatów wejściowych i wyjściowych — w tym PDF, DOCX, XLSX, PPTX oraz popularne typy obrazów — przy przetwarzaniu wielostronicowych plików bez ładowania całego dokumentu do pamięci. Silnik wyszukiwania oparty na hashach biblioteki może znajdować znaki wodne z dokładnością > 95 %, skracając czas skanowania dużych archiwów nawet o 70 %.

Wymagania wstępne

  • Java Development Kit (JDK): wersja 8 lub nowsza zainstalowana.
  • GroupDocs.Watermark for Java: wersja 24.11 (wersja użyta w tym przewodniku).
  • Maven: do zarządzania zależnościami, choć ręczne pobranie JAR również działa.

Jeśli jesteś nowy w Mavenie, poniższy fragment pom.xml pokazuje dokładnie, co należy dodać.

Konfiguracja Maven

Dodaj następującą konfigurację do swojego pom.xml, aby uwzględnić GroupDocs.Watermark jako zależność:

<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 możesz pobrać najnowszą wersję bezpośrednio z GroupDocs.Watermark for Java releases.

Uzyskanie licencji

  • Free trial: Pobierz pakiet próbny, aby przetestować podstawowe funkcje.
  • Temporary license: Uzyskaj klucz czasowo ograniczony do rozszerzonego testowania z portalu GroupDocs.
  • Commercial license: Kup pełną licencję do nieograniczonego użytku produkcyjnego i wsparcia priorytetowego.

Jak dodać znak wodny obrazu w Javie krok po kroku

Klasa Watermark reprezentuje dokument, który może być przetwarzany pod kątem operacji znaków wodnych. ImageSearchOptions konfiguruje kryteria wyszukiwania znaków wodnych obrazu. WatermarkSearchResult przechowuje kolekcję znalezionych znaków wodnych. Metoda setImage() zastępuje obraz znaku wodnego, a document.save() zapisuje zmodyfikowany dokument na dysku.

Załaduj docelowy dokument, znajdź istniejące znaki wodne i zamień je na nowy obraz — wszystko w trzech zwięzłych krokach. Poniższa bezpośrednia odpowiedź wyjaśnia ogólny przepływ przed przejściem do poszczególnych elementów.

Załaduj PDF (lub inny obsługiwany plik) przy użyciu Watermark.load(), skonfiguruj obiekt ImageSearchOptions, aby znaleźć znaki wodne pasujące do podanego hasha, iteruj po zwróconej kolekcji, wywołaj setImage() z nową tablicą bajtów, a na końcu zapisz zmodyfikowany dokument przy użyciu save(). Ten wzorzec działa dla PDF, Word, Excel, PowerPoint oraz plików graficznych i zapewnia, że zmieniane są tylko zamierzone znaki wodne.

Krok 1: załaduj plik obrazu w Javie

Aby zamienić znak wodny, najpierw potrzebujesz nowego obrazu jako tablicy bajtów. Poniższy kod odczytuje dowolny plik obrazu z dysku do pamięci, którą możesz następnie przekazać do API znaków wodnych.

import com.groupdocs.watermark.Watermarker;

public class Main {
    public static void main(String[] args) {
        Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_PATH.pdf");
        // Proceed to use GroupDocs.Watermark functionalities.
    }
}

Krok 2: wyszukaj znaki wodne w dokumencie

Następnie skonfiguruj kryteria wyszukiwania, aby silnik wiedział, które znaki wodne są celem. Możesz dopasować po hash obrazu, rozmiarze lub przezroczystości; poniższy przykład używa podejścia opartego na hashach dla wysokiej precyzji.

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

public class LoadImageData {
    private static final String IMAGE_PNG_PATH = "YOUR_DOCUMENT_DIRECTORY/image.png";

    public byte[] loadImageData() throws Exception {
        File imageFile = new File(IMAGE_PNG_PATH);
        byte[] imageData = new byte[(int) imageFile.length()];
        try (InputStream imageInputStream = new FileInputStream(imageFile)) {
            imageInputStream.read(imageData); // Read the file into the byte array.
        }
        return imageData;
    }
}

Krok 3: zamień obraz w znakach wodnych

Na koniec iteruj po znalezionych znakach wodnych i zamień dane obrazu każdego z nich na nową tablicę bajtów utworzoną w Kroku 1. Po aktualizacji zapisz dokument do nowego pliku, aby zachować oryginał.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.search.ImageDctHashSearchCriteria;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class SearchForWatermarks {
    private static final String INPUT_PDF_PATH = "YOUR_DOCUMENT_DIRECTORY/document.pdf";

    public PossibleWatermarkCollection searchWatermarks() throws Exception {
        Watermarker watermarker = new Watermarker(INPUT_PDF_PATH);
        ImageDctHashSearchCriteria searchCriteria = new ImageDctHashSearchCriteria("YOUR_DOCUMENT_DIRECTORY/logo.bmp");
        
        return watermarker.search(searchCriteria);
    }
}

Typowe problemy i rozwiązywanie

LoadOptions pozwala określić parametry takie jak hasło lub tryb ładowania przy otwieraniu dokumentu. Enum LoadMode definiuje sposób ładowania pliku, np. STREAM dla dostępu strumieniowego.

ObjawPrawdopodobna przyczynaRozwiązanie
Nie znaleziono znaków wodnychHash wyszukiwania nie pasuje (różna rozdzielczość lub głębia kolorów)Wygeneruj hash z dokładnego pliku źródłowego lub użyj ImageSearchOptions.setSimilarity(0.85), aby zezwolić na dopasowanie przybliżone.
Błąd braku pamięci przy dużych PDFCały dokument wczytany do pamięciUżyj Watermark.load(inputPath, LoadOptions.create().setLoadMode(LoadMode.STREAM)), aby strumieniowo przetwarzać plik.
Zapisany dokument jest uszkodzonyStrumień wyjściowy nie został prawidłowo zamkniętyUpewnij się, że użyto try‑with‑resources dla strumienia wyjściowego lub wywołaj document.close() po zapisaniu.
Nowy znak wodny jest przesuniętyOryginalny znak wodny miał metadane rotacji lub skalowaniaZachowaj oryginalne ustawienia Watermark.getTransform() i zastosuj je do nowego obrazu za pomocą watermark.setTransform(originalTransform).

Najczęściej zadawane pytania

Q: Czy mogę dodać znak wodny do chronionego hasłem PDF?
A: Tak. Załaduj dokument przy użyciu Watermark.load(path, new LoadOptions(password)) i API odszyfruje go do przetworzenia.

Q: Czy GroupDocs.Watermark obsługuje obrazy SVG?
A: Biblioteka może rasteryzować pliki SVG do PNG przed osadzeniem, ale natywne wstawianie SVG nie jest obecnie dostępne.

Q: Ile stron może być przetwarzanych w jednym wywołaniu?
A: API może obsłużyć dokumenty z ponad 500 stronami bez ładowania całego pliku do pamięci, dzięki architekturze strumieniowej.

Q: Czy można dodać wiele różnych znaków wodnych do tego samego dokumentu?
A: Oczywiście. Utwórz osobne obiekty Watermark dla każdego obrazu i wywołaj document.add(watermark) dla każdego z nich.

Q: Jakie platformy są obsługiwane przez Java SDK?
A: Windows, Linux i macOS są obsługiwane, a biblioteka działa w każdym środowisku kompatybilnym z JVM, w tym w kontenerach Docker.

Ostatnia aktualizacja: 2026-08-04
Testowano z: GroupDocs.Watermark 24.11 for Java
Autor: GroupDocs

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.search.PossibleWatermarkCollection;

public class ReplaceImageInWatermarks {
    private static final String OUTPUT_PDF_PATH = "YOUR_OUTPUT_DIRECTORY/modified_document.pdf";
    
    public void replaceImages(PossibleWatermarkCollection watermarks, byte[] newImageData) throws Exception {
        Watermarker watermarker = new Watermarker(INPUT_PDF_PATH);

        for (PossibleWatermark watermark : watermarks) {
            try {
                watermark.setImageData(newImageData);
            } catch (Exception e) {
                // Handle exceptions related to unsupported formats or entities.
            }
        }

        watermarker.save(OUTPUT_PDF_PATH);
        watermarker.close();
    }
}

Powiązane samouczki