Convertir un 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. Avec GroupDocs.Viewer pour Java, vous pouvez convert zip to html en une seule étape, contrôler le nombre d’entrées d’archive affichées sur chaque page, intégrer toutes les images et CSS de support, et même traiter par lots des dizaines d’archives. Ce tutoriel vous guide à travers le flux de travail complet, de la configuration Maven au rendu multi‑pages, et explique pourquoi chaque paramètre est important pour les performances et la convivialité.

Convertir des archives en HTML avec GroupDocs.Viewer pour Java

Réponses rapides

  • Que 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 ?

Le paramètre set items per page appartient aux options de rendu d’archive. Il indique au visualiseur combien d’entrées d’archive (fichiers ou dossiers) doivent être affichées sur chaque page HTML lorsque vous générez un document HTML multi‑pages. Ajuster cette valeur vous aide à équilibrer la taille des pages et la vitesse de navigation, surtout pour les archives volumineuses.

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. Cette approche simplifie également le déploiement car aucun chemin d’actif externe n’a besoin d’être géré.

Prérequis

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

Configuration Maven de GroupDocs Viewer

Add the GroupDocs repository and the viewer dependency to your 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

After the Maven setup, bring the viewer into your code:

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

Comment rendre les archives en HTML à page unique

Viewer est la classe principale qui charge un document ou une archive pour le rendu.

Pour générer un fichier HTML unique contenant l’ensemble de l’archive, créez une instance Viewer pour le fichier ZIP et utilisez HtmlViewOptions.forEmbeddedResources() afin d’intégrer toutes les images, le CSS et les polices. Le rendu de l’archive avec ces options produit une page autonome adaptée aux e‑mails ou à une utilisation hors ligne.

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

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

HtmlViewOptions configure la façon dont le visualiseur rend la sortie HTML, y compris la pagination et l’intégration des ressources.

Pour diviser une archive en plusieurs pages, créez HtmlViewOptions.forEmbeddedResources() et définissez la taille de page souhaitée avec options.setItemsPerPage(20). Le visualiseur générera des fichiers HTML séparés, chacun affichant jusqu’au nombre d’entrées spécifié, ce qui améliore la navigation pour les archives volumineuses et assure un chargement plus rapide.

É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 en 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 les 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 consommation de 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 en plus petits lots 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 à chaque itération.

Ressources

Dernière mise à jour : 2026-08-03
Testé avec : GroupDocs.Viewer 25.2
Auteur : GroupDocs

Tutoriels associés