Convertir zip en html et définir le nombre d’éléments par page avec GroupDocs.Viewer Java

Dans de nombreuses applications web, vous devez afficher le contenu d’une archive ZIP ou RAR directement dans le navigateur. Comment convertir des fichiers zip en HTML à l’aide de GroupDocs.Viewer pour Java est une exigence courante, et la bibliothèque vous permet d’intégrer des images, du CSS et des polices afin que le résultat soit une page unique et portable. Ce tutoriel vous guide à travers tout—de la configuration Maven au rendu multi‑pages—tout en expliquant pourquoi chaque option est importante pour les performances et la convivialité.

Convertir des archives en HTML avec GroupDocs.Viewer pour Java

Réponses rapides

  • À quoi sert le contrôle « set items per page » ? Il détermine combien de fichiers ou dossiers d’une archive apparaissent sur chaque page HTML générée.
  • Puis-je intégrer des images et du CSS directement dans le HTML ? Oui – utilisez l’option forEmbeddedResources pour intégrer les ressources HTML.
  • La conversion par lots est‑elle possible ? Absolument ; vous pouvez parcourir une collection d’archives et rendre chacune avec les mêmes paramètres.
  • Ai‑je besoin de Maven pour utiliser GroupDocs.Viewer ? Oui, ajoutez la dépendance Maven groupdocs-viewer comme indiqué ci‑dessous.
  • Quels formats de sortie sont pris en charge ? Le HTML à page unique et le HTML multi‑pages sont tous deux disponibles, et la bibliothèque prend en charge plus de 50 types d’archives en entrée.

Qu’est‑ce que « set items per page » dans GroupDocs.Viewer ?

Il indique au visualiseur combien d’entrées d’archive (fichiers ou dossiers) doivent être affichées sur chaque page HTML lors de la génération d’un document multi‑pages. Ajuster cette valeur vous aide à équilibrer la taille des pages et la vitesse de navigation, notamment pour les grandes archives, en limitant la quantité de données chargées par page et en réduisant le temps de rendu pour les utilisateurs finaux.

Pourquoi intégrer les ressources HTML ?

Intégrer les ressources (images, CSS, polices) directement dans le fichier HTML crée un document unique et portable qui peut être ouvert sans fichiers externes. C’est idéal pour les pièces jointes d’e‑mail, la visualisation hors ligne ou l’intégration du résultat dans d’autres pages web. Cela supprime également la nécessité de gérer les chemins des actifs externes.

Prérequis

  • Bibliothèques requises : Inclure GroupDocs.Viewer version 25.2 ou ultérieure.
  • Environnement : Kit de développement Java (JDK) installé et configuré.
  • Connaissances : Java de base et gestion des dépendances Maven.

Configuration Maven de GroupDocs Viewer

Ajoutez le dépôt GroupDocs et la dépendance du visualiseur à votre pom.xml :

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Acquisition de licence

GroupDocs.Viewer propose un lien d’essai gratuit, une licence temporaire ou une option d’achat complète. Choisissez celle qui correspond à votre calendrier de projet.

Initialisation de base

La classe Viewer est le point d’entrée pour le rendu des documents et des archives. Après la configuration Maven, intégrez le visualiseur dans votre code :

import com.groupdocs.viewer.Viewer;
// Your initialization code here

Comment rendre les archives en HTML à page unique

La classe HtmlViewOptions définit les paramètres de sortie HTML, tels que l’intégration des ressources. Chargez l’archive, configurez les options HTML pour intégrer les ressources, et rendez le tout dans une page autonome. Cela produit un fichier HTML unique contenant tous les fichiers, images, CSS et polices, prêt pour une utilisation hors ligne ou en pièce jointe d’e‑mail.

Réponse directe : Créez une instance Viewer pour le fichier ZIP, appelez HtmlViewOptions.forEmbeddedResources(), et invoquez viewer.view(documentPath, options). Cela produit un fichier HTML unique contenant tous les fichiers, images, CSS et polices, prêt pour une utilisation hors ligne ou en pièce jointe d’e‑mail.

Étape 1 : Définir le répertoire de sortie

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Étape 2 : Définir le nom de fichier pour la sortie à page unique

Path pageFilePathFormat = outputDirectory.resolve("RAR_result.html");

Étape 3 : Initialiser le visualiseur

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Further configuration steps follow
}

Étape 4 : Configurer les options de rendu (intégrer les ressources HTML)

La classe HtmlViewOptions définit les paramètres de sortie HTML, tels que l’intégration des ressources. Utilisez forEmbeddedResources() pour regrouper le tout dans un seul fichier.

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Étape 5 : Rendre en une seule page

options.setRenderToSinglePage(true);
viewer.view(options);

Comment rendre les archives en HTML multi‑pages et définir le nombre d’éléments par page

La classe HtmlViewOptions prend également en charge la pagination. En appelant options.setItemsPerPage(N), vous indiquez au visualiseur de diviser l’archive en plusieurs fichiers HTML, chacun affichant jusqu’à N entrées. Cette approche améliore la vitesse de navigation pour les grandes archives tout en gardant chaque page légère.

Réponse directe : Utilisez HtmlViewOptions.forEmbeddedResources(), appelez options.setItemsPerPage(N), et rendez l’archive. Le visualiseur générera des fichiers HTML séparés—un par page—chacun contenant jusqu’à N entrées, ce qui accélère la navigation pour les grandes archives.

Étape 1 : Réutiliser le répertoire de sortie

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Étape 2 : Définir le format du nom de fichier pour plusieurs pages

Path pageFilePathFormat = outputDirectory.resolve("RAR_result_page_{0}.html");

Étape 3 : Réinitialiser le visualiseur

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Continue with multi‑page configuration
}

Étape 4 : Configurer les options multi‑pages (intégrer les ressources HTML)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Étape 5 : Définir le nombre d’éléments par page (mot‑clé principal dans l’action)

options.getArchiveOptions().setItemsPerPage(10); // Default is 16
viewer.view(options);

Applications pratiques

  • Systèmes de gestion de documents : Ajoutez une fonctionnalité d’aperçu d’archive sans installer de visualiseurs supplémentaires.
  • Portails web : Offrez aux utilisateurs un moyen rapide, sans téléchargement, d’explorer des documents groupés.
  • Outils de collaboration : Permettez aux équipes d’inspecter les archives partagées directement dans le navigateur.

Considérations de performance

  • Gestion des ressources : Maintenez une faible utilisation de la mémoire en traitant les archives en flux ; le visualiseur peut gérer des archives jusqu’à 500 Mo sans charger le fichier complet en mémoire.
  • Conversion par lots d’archives : Parcourez une liste de fichiers d’archive et appelez la même logique de rendu pour maximiser le débit.
  • Stratégie de mise en cache : Stockez le HTML rendu dans un cache si la même archive est fréquemment consultée, réduisant le temps de traitement répété jusqu’à 70 %.

Questions fréquemment posées

Q : Qu’est‑ce que GroupDocs.Viewer Java ?
R : GroupDocs.Viewer Java est une bibliothèque côté serveur qui rend plus de 50 formats de documents et d’archives—y compris ZIP et RAR—en HTML, PDF ou fichiers image sans nécessiter d’applications externes.

Q : Comment obtenir un essai gratuit de GroupDocs.Viewer ?
R : Visitez le lien d’essai gratuit pour télécharger et tester.

Q : Puis‑je convertir d’autres types de documents en plus des archives ?
R : Oui, le visualiseur prend en charge les PDF, Word, Excel, PowerPoint et plus de 35 formats supplémentaires.

Q : Que faire si le rendu est lent ?
R : Réduisez le nombre d’éléments par page, activez le streaming, ou traitez les archives par lots plus petits pour améliorer la vitesse.

Q : Où puis‑je obtenir de l’aide ou du support ?
R : Contactez‑nous via le forum de support.

Q : Est‑il possible d’intégrer le CSS et les images directement dans le HTML ?
R : Absolument—utilisez HtmlViewOptions.forEmbeddedResources comme illustré dans les exemples.

Q : Comment convertir par lots un dossier d’archives ?
R : Parcourez chaque fichier avec une boucle for, en appliquant la même configuration Viewer et HtmlViewOptions pour chaque itération.

Q : Où puis‑je discuter des problèmes avec d’autres utilisateurs ?
R : Visitez le forum GroupDocs pour des discussions communautaires.

Ressources

Last Updated: 2026-10-10
Tested With: GroupDocs.Viewer 25.2
Author: GroupDocs

Tutoriels associés