Comment prévisualiser des documents avec GroupDocs.Watermark en Java

Créer une fonctionnalité de prévisualisation de documents est essentiel pour toute application qui gère un grand nombre de fichiers. Avec GroupDocs.Watermark pour Java, vous pouvez générer des aperçus rapides et de haute qualité sans charger le document complet en mémoire. Dans ce guide, vous découvrirez étape par étape comment configurer la bibliothèque, gérer les flux de pages et produire des images d’aperçu pour chaque page d’un document.

Réponses rapides

Quelle bibliothèque est recommandée ? GroupDocs.Watermark pour Java (v24.11)
Quel mot‑clé principal ce tutoriel cible‑t‑il ? how to preview documents
’une licence ? Une version d’essai fonctionne pour l’é production.
Puis‑je personnaliser le format – vous’extension fichier dans le page.
Le code est‑il thread‑safe ? L’instance Watermarker n’est pas thread‑safe ; créez une instance distincte par thread.

Qu’est‑ce que l’aperçu de document en Java ?

Un aperçu de document est une image légère (souvent PNG ou JPEG) qui représente une seule page d’un fichier. Il permet aux utilisateurs de jeter un œil rapidement au contenu, améliorant l’expérience utilisateur dans les navigateurs de fichiers, les plateformes CMS et les services de stockage cloud.

Pourquoi utiliser GroupDocs.Watermark pour la génération d’aperçus ?

Axé sur la performance  document entier.
charge multiplateforme** : fonctionne avec les PDF, les fichiers Office, Visio et bien d’autres.
Gestion intégrée des flux : fournit les interfaces ICreatePageStream et IReleasePageStream pour une gestion propre des ressources.

Prérequis1. GroupDocs.Watermark Java v24.11 – la dernière version stable.

** 8+** installé et un IDE tel qu’IntelliJ IDEA ou Eclipse.
Des connaissances de base en Java (I/O de fichiers, programmation orientée objet).

Configuration de GroupDocs.Watermark pour Java

Ajoutez la bibliothèque à votre projet avec 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>

Ou téléchargez le JAR directement depuis la page officielle :
GroupDocs.Watermark for Java releases

Acquisition de licence

Essai gratuit – fonctionnalités limitées, idéal pour les tests.
Licence temporaire – ensemble complet de fonctionnalités pour une courte période d’évaluation.
Licence complète – utilisation illimitée et support prioritaire.

Guide d’implémentation

Initialiser Watermarker

La première étape consiste à créer une instance Watermarker qui pointe vers le document source.

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.");
    }
}

Astuce : Remplacez YOUR_DOCUMENT_DIRECTORY/diagram.vdx par le chemin réel du fichier que vous souhaitez prévisualiser.

Créer un flux de page pour la génération d’aperçu

Implémentez ICreatePageStream pour indiquer à la bibliothèque où et comment stocker chaque image de page.

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 est un modèle page stream java qui nomme automatiquement chaque fichier d’aperçu (par ex., page1.png, page2.png).

Libérer le flux de page

Fermer mémoire.

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);
        }
    }
}

Générer l’aperçu du document

Combinez maintenant le tout et appelez generatePreview avec 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();
    }
}

`createPage** pour chaque image d’aperçu.
releasePageStream garantit la libération des ressources après l’écriture de chaque page.

Applications pratiques

Applications de visualisation PDF – afficher des miniatures avant d’ouvrir le fichier complet.
Systèmes de gestion de contenu – permettre aux éditeurs de parcourir rapidement le contenu des documents.
Services de stockage cloud – générer des miniatures à la volée pour tout fichier téléchargé.

Considérations de performance

Utilisation mémoire – utilisez les interfaces de flux pour éviter de charger les documents entiers en RAM. encapsStreamdans unBufferedOutputStreamsiement par lots** – exécutez la génération d’aperçus dans des threads parallèles, chacun disposant de sa propre instanceWatermarker`.

Problèmes courants & solutions

Foire aux questions

Q : Puis‑je par mot de passe ?
R : Oui. Passez le mot de passe au constructeur Watermarker qui accepte une chaîne de mot de passe.

**Q  sont pris en charge pour les aperçus ? changer l’Q’aperçu à des pages spécifiques.setPageNumber(int pageNumber)` pour générer un aperçu d’une seule page.

Q : La bibliothèque fonctionne‑t‑elle sous Linux/macOS ?
R : Absolument. GroupDocs.Watermark est indépendant de Java est disponible.

Q : Comment nettoyer les fichiers temporaires après un traitement par lots ?
R : Supprimez manuellement les fichiers d’aperçu générés ou implémentez une tâche de nettoyage planifiée.

Dernière mise à jouré avec : GroupDocs.Watermark Java 24.11
Auteur : GroupDocs