Jak podglądać dokumenty przy użyciu GroupDocs.Watermark w Javie

Tworzenie how to preview documents funkcjonalności jest niezbędne dla każdej aplikacji obsługującej dużą liczbę plików. Dzięki GroupDocs.Watermark dla Javy możesz generować szybkie, wysokiej jakości podglądy bez ładowania całego dokumentu do pamięci. W tym przewodniku odkryjesz krok po kroku, jak skonfigurować bibliotekę, zarządzać strumieniami stron i tworzyć obrazy podglądu dla każdej strony dokumentu.

Szybkie odpowiedzi

• Jakiej biblioteki używać? GroupDocs.Watermark for Java)
• Jakie główne słowo kluczowe jest celem tego samouczka? how to preview documents
• Czy potrzebna jest licencja? A trial works for evaluation; a full license is required for production.
• Czy mogę dostosować format wyjściowy? Yes – you can change the file extension in the page‑stream template.
• Czy kod jest bezpieczny wątkowo? The Watermarker instance is not thread separate instance per thread.

Czym jest podgląd dokumentu w Javie?

Podgląd dokumentu to lekki obraz (często PNG lub JPEG), który przedstawia pojedynczą stronę pliku. Umożliwia użytkownikom szybkie spojrzenie na zawartość, poprawiając UX w przeglądarkach plików, platformach CMS oraz usługach przechowywania w chmurze.

Dlaczego używać GroupDocs.Watermark do generowania podglądów?

• Skoncentrowany na wydajności: Generates page images without rendering the whole document.
• Obsługa wielu formatów: Works with PDFs, and many others.
• Wbudowane zarządzanie strumieniami: Provides ICreatePageStream and IReleasePageStream interfaces for clean resource management.

Wymagania wstępne

Before you start, make sure you have:

1. GroupDocs.Watermark Java v24.11 – najnowsze stabilne wydanie.
2. JDK 8+ zainstalowane oraz IDE, takie jak IntelliJ IDEA lub Eclipse.
3. Podstawowa znajomość Javy (operacje na plikach, programowanie obiektowe).

Konfigurowanie GroupDocs.Watermark dla Javy

Add the library to your project using Maven:

<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>

Or download the JAR directly from the official page:
GroupDocs.Watermark for Java releases

Uzyskanie licencji

• Bezpłatna wersja próbna – ograniczona funkcjonalność, świetna do testów.
• Licencja tymczasowa – pełny zestaw funkcji na krótki okres oceny.
• Pełna licencja – nieograniczone użycie i wsparcie priorytetowe.

Przewodnik implementacji

Inicjalizacja Watermarker

Pierwszym krokiem jest utworzenie instancji Watermarker, która wskazuje na dokument źródłowy.

import com.groupdocs.watermark.Watermarker;

public class FeatureInitializeWatermarker {
    public static void main(String[] args) {
        String inputDocumentPath = "YOUR_DOCUMENT_DIRECTORY/diagram.vdx";
        
        // Initialize Watermarker with the specified document
        Watermarker watermarker = new Watermarker(inputDocumentPath);
        
        System.out.println("Watermarker initialized.");
    }
}

Wskazówka: Zamień YOUR_DOCUMENT_DIRECTORY/diagram.vdx na rzeczywistą ścieżkę pliku, który chcesz podglądać.

Utwórz strumień strony do generowania podglądu

Zaimplementuj ICreatePageStream, aby określić bibliotece, gdzie i jak zapisywać obraz każdej strony.

import java.io.FileOutputStream;
import com.groupdocs.watermark.options.ICreatePageStream;
import java.io.OutputStream;

public class FeatureCreatePageStream implements ICreatePageStream {
    private final String fileNameTemplate;

    public FeatureCreatePageStream(String outputDirectory) {
        this.fileNameTemplate = outputDirectory + "/page%s.png";
    }

    @Override
    public OutputStream createPageStream(int pageNumber) {
        String fileName = String.format(this.fileNameTemplate, pageNumber);
        try {
            return new FileOutputStream(fileName);
        } catch (Exception ex) 
        {
            throw new RuntimeException(ex);
        }
    }
}

page%s.png jest wzorcem page stream java, który automatycznie nazywa każdy plik podglądu (np. page1.png, page2.png).

Zwolnij strumień strony

Poprawne zamykanie strumieni zapobiega wyciekom pamięci.

import com.groupdocs.watermark.options.IReleasePageStream;
import java.io.OutputStream;

public class FeatureReleasePageStream implements IReleasePageStream {
    @Override
    public void releasePageStream(int pageNumber, OutputStream pageStream) {
        try 
        {
            pageStream.close();
        } catch (Exception ex)
        {
            throw new RuntimeException(ex);
        }
    }
}

Generowanie podglądu dokumentu

Teraz połącz wszystko i wywołaj generatePreview z preview options java.

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

public class FeatureGenerateDocumentPreview {
    public static void main(String[] args) {
        String inputDocumentPath = "YOUR_DOCUMENT_DIRECTORY/diagram.vdx";
        
        Watermarker watermarker = new Watermarker(inputDocumentPath);
        
        FeatureCreatePageStream createPageStream = new FeatureCreatePageStream("YOUR_OUTPUT_DIRECTORY");
        FeatureReleasePageStream releasePageStream = new FeatureReleasePageStream();
        
        PreviewOptions previewOptions = new PreviewOptions(createPageStream, releasePageStream);
        
        watermarker.generatePreview(previewOptions);
        
        watermarker.close();
    }
}

• createPageStream obsługuje tworzenie page stream java dla każdego obrazu podglądu.
• releasePageStream zapewnia zwolnienie zasobów po zapisaniu każdej strony.

Praktyczne zastosowania

• Aplikacje przeglądające PDF – wyświetlaj miniatury przed otwarciem pełnego pliku.
• Systemy zarządzania treścią – umożliw.
• **Usatury dla każdego przesłanego pliku.

Uwagi dotyczące wydajności

• Użycie pamięci – Korzystaj z interfejsów strumieni, aby uniknąć ładowania całych dokumentów do RAM.
  -ymalizacja I/O** – OwiOutputwarzowanie podglądów w równoległych wątkach, każdy z własną instancją Watermarker.

Typowe problemy i rozwiązania

Najczęściej zadawane pytania

P: Czy mogę generować podglądy dla dokumentów zabezpieczonych hasłem?
O: Tak. Przekaż hasło do przeciążenia konstruktora Watermarker, które przyjmuje ciąg znaków z hasłem.

**P: Jakie formaty obrazów są obsługiwane dla podgląd?: Domyślnie PNG, ale możesz zmienić rozszerzenie plCreatePageStream` na JPEG, BMP itp.

P: Czy można ograniczyć podgląd do konkretnych stron?
O: Użyj PreviewOptions.setPageNumber(int pageNumber), aby wygenerować podgląd jednej strony.

P: Czy biblioteka działa na Linux/macOS?
O: Zdecydowanie tak. GroupDocs.Watermark jest niezależny od platformy, o ile dostępny jest środowisko uruchomieniowe Javyczas Usuń cz—

Ostatnia aktualizacja: 2026-02-03
Testowano z: GroupDocs.Watermark Java 24.11
Autor: GroupDocs