Jak ładować chronione hasłem dokumenty Word i dodawać znaki wodne przy użyciu GroupDocs.Watermark Java

Szybkie odpowiedzi

  • Czy GroupDocs.Watermark może otwierać zaszyfrowane pliki Word? Tak, wystarczy podać hasło za pomocą WordProcessingLoadOptions.
  • Czy potrzebna jest licencja do programowania? Licencja trial działa w trybie ewaluacyjnym; pełna licencja jest wymagana w środowisku produkcyjnym.
  • Jakie współrzędne Maven są wymagane? com.groupdocs:groupdocs-watermark:24.11 (lub nowsze).
  • Czy można przetwarzać wsadowo wiele chronionych dokumentów? Oczywiście – utwórz Watermarker dla każdego pliku w pętli.
  • Jakie wersje Javy są obsługiwane? Java 8 i wyższe.

Co oznacza „Load Password Protected Word”?

Ładowanie chronionego hasłem dokumentu Word oznacza otwarcie pliku .docx, który został zaszyfrowany hasłem, odszyfrowanie go w pamięci oraz wykonanie operacji, takich jak dodawanie znaków wodnych. Bez prawidłowego hasła plik pozostaje niedostępny.

Dlaczego warto używać GroupDocs.Watermark Java?

GroupDocs.Watermark Java oferuje prosty interfejs API do obsługi szerokiej gamy formatów dokumentów, w tym zaszyfrowanych plików Word. Ukrywa szczegóły niskiego poziomu, pozwala dodać znak wodny tekstowy lub graficzny w kilku linijkach kodu i zapewnia wysoką wydajność nawet przy dużych dokumentach.

Wymagania wstępne

  • Java 8+ (IntelliJ IDEA, Eclipse lub dowolne inne IDE)
  • Maven zainstalowany do zarządzania zależnościami
  • Dostęp do licencji GroupDocs.Watermark Java (trial lub płatna)
  • Dokument Word chroniony hasłem do testów

Konfiguracja GroupDocs.Watermark dla Javy

Konfiguracja Maven

Dodaj repozytorium i zależność do pliku 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>

Pobranie ręczne

Jeśli wolisz ręczną konfigurację, pobierz najnowszy plik JAR z oficjalnego źródła: GroupDocs.Watermark for Java releases.

Kroki uzyskania licencji

  1. Free Trial – Uzyskaj tymczasową licencję, aby wypróbować wszystkie funkcje.
  2. Purchase – Nabycie pełnej licencji umożliwia nieograniczone użycie w produkcji.

Jak ładować chronione hasłem dokumenty Word

Krok 1: Import wymaganych pakietów

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

Krok 2: Ustawienie opcji ładowania z hasłem

String filePath = "YOUR_DOCUMENT_DIRECTORY/protected-document.docx"; // Replace with your document path.
WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setPassword("P@$$w0rd"); // Set the correct password here.

Wywołanie setPassword informuje GroupDocs.Watermark, jak odszyfrować plik, aby można było na nim pracować.

Krok 3: Inicjalizacja Watermarker

Watermarker watermarker = new Watermarker(filePath, loadOptions);

Utworzenie instancji Watermarker daje pełną kontrolę nad zawartością dokumentu i znakami wodnymi.

Krok 4: Dodanie tekstowego znaku wodnego

import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 12));
watermarker.add(watermark);

Tutaj tworzymy prosty tekstowy znak wodny. Można dostosować czcionkę, rozmiar, kolor, obrót i położenie.

Krok 5: Zapis i zamknięcie

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/protected-document.docx";
watermarker.save(outputFilePath);
watermarker.close();

Zapis zapisuje nowy znak wodny do nowego pliku, a zamknięcie zwalnia wszystkie zasoby natywne.

Typowe problemy i rozwiązania

  • Nieprawidłowe hasło – Sprawdź hasło u właściciela dokumentu; niezgodne hasło powoduje wyrzucenie WrongPasswordException.
  • Problemy ze ścieżką pliku – Używaj ścieżek bezwzględnych lub upewnij się, że katalog roboczy wskazuje właściwy folder.
  • Brakujące zależności Maven – Ponownie sprawdź sekcje <repositories> i <dependencies>; uruchom mvn clean install, aby odświeżyć lokalną pamięć podręczną.

Praktyczne zastosowania

  1. Kancelarie prawne – Dodawanie poufnych znaków wodnych do akt spraw przed udostępnieniem klientom.
  2. Instytucje edukacyjne – Ochrona notatek wykładowych poprzez znakowanie, przy jednoczesnym umożliwieniu studentom przeglądania treści.
  3. Przedsiębiorstwa – Zabezpieczanie wewnętrznych raportów znakami wodnymi firmowej marki, nawet gdy pliki są chronione hasłem.

Wskazówki dotyczące wydajności

  • Zmniejsz rozmiar dokumentu przed ładowaniem, aby ograniczyć zużycie pamięci.
  • Ponownie używaj instancji Watermarker tylko przy przetwarzaniu jednego dokumentu; w scenariuszach wsadowych twórz nowe instancje dla każdego pliku.
  • Szybko zamykaj zasoby (watermarker.close()), aby uniknąć wycieków pamięci.

Najczęściej zadawane pytania

P: Czy GroupDocs.Watermark obsługuje inne chronione formaty (np. PDFy)?
O: Tak, biblioteka obsługuje PDFy, prezentacje i arkusze kalkulacyjne chronione hasłem, korzystając z odpowiednich klas opcji ładowania.

P: Co się stanie, jeśli spróbuję załadować dokument bez podania hasła?
O: Biblioteka wyrzuci WrongPasswordException. Zawsze ustaw hasło w WordProcessingLoadOptions, gdy plik jest zaszyfrowany.

P: Czy można dodać znak wodny graficzny zamiast tekstowego?
O: Oczywiście. Użyj klasy ImageWatermark i określ ścieżkę obrazu, przezroczystość oraz położenie.

P: Jak usunąć znak wodny, który został wcześniej dodany?
O: Pobierz obiekt znaku wodnego za pomocą watermarker.getWatermarks() i wywołaj watermarker.remove(watermark).

P: Czy API obsługuje dokumenty wielojęzyczne?
O: Tak, znaki Unicode są w pełni wspierane, co umożliwia znaki wodne w dowolnym języku.

Zasoby

Ostatnia aktualizacja: 2025-12-23
Testowano z: GroupDocs.Watermark 24.11 for Java
Autor: GroupDocs