Zip converteren naar html en items per pagina instellen met GroupDocs.Viewer Java

In veel webapplicaties moet je de inhoud van een ZIP- of RAR-archief direct in een browser tonen. Hoe zip te converteren naar HTML met GroupDocs.Viewer voor Java is een veelvoorkomende eis, en de bibliotheek laat je afbeeldingen, CSS en lettertypen insluiten zodat het resultaat een enkele, draagbare pagina is. Deze tutorial leidt je door alles—van Maven‑configuratie tot multi‑page rendering—en legt uit waarom elke optie belangrijk is voor prestaties en bruikbaarheid.

Archieven converteren naar HTML met GroupDocs.Viewer voor Java

Snelle antwoorden

  • Wat regelt “set items per page”? Het bepaalt hoeveel bestanden of mappen uit een archief op elke gegenereerde HTML-pagina verschijnen.
  • Kan ik afbeeldingen en CSS direct in de HTML insluiten? Ja – gebruik de forEmbeddedResources optie om resources in de HTML in te sluiten.
  • Is batchconversie mogelijk? Absoluut; je kunt over een verzameling archieven itereren en elk met dezelfde instellingen renderen.
  • Heb ik Maven nodig om GroupDocs.Viewer te gebruiken? Ja, voeg de groupdocs-viewer Maven-dependency toe zoals hieronder weergegeven.
  • Welke uitvoerformaten worden ondersteund? Single‑page HTML en multi‑page HTML zijn beide beschikbaar, en de bibliotheek ondersteunt meer dan 50 invoer‑archieftypen.

Wat is “set items per page” in GroupDocs.Viewer?

Het vertelt de viewer hoeveel archief‑items (bestanden of mappen) op elke HTML-pagina moeten worden weergegeven wanneer je een multi‑page document genereert. Het aanpassen van deze waarde helpt je de paginagrootte en navigatiesnelheid in balans te brengen, vooral bij grote archieven, door de hoeveelheid data per pagina te beperken en de rendertijd voor eindgebruikers te verkorten.

Waarom resources html insluiten?

Resources (afbeeldingen, CSS, lettertypen) direct in het HTML‑bestand insluiten creëert een enkel, draagbaar document dat kan worden geopend zonder externe bestanden. Dit is ideaal voor e‑mailbijlagen, offline weergave, of het insluiten van de output in andere webpagina’s. Het verwijdert bovendien de noodzaak om externe asset‑paden te beheren.

Vereisten

  • Vereiste bibliotheken: Inclusief GroupDocs.Viewer versie 25.2 of later.
  • Omgeving: Java Development Kit (JDK) geïnstalleerd en geconfigureerd.
  • Kennis: Basis Java en Maven dependency management.

Maven GroupDocs Viewer configuratie

Voeg de GroupDocs‑repository en de viewer‑dependency toe aan je 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>

Licentie verkrijgen

GroupDocs.Viewer biedt een gratis proeflink, een tijdelijke licentie, of een volledige aankoopoptie. Kies de optie die past bij je projectplanning.

Basisinitialisatie

De Viewer‑klasse is het toegangspunt voor het renderen van documenten en archieven. Na de Maven‑setup breng je de viewer in je code:

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

Hoe archieven te renderen naar single‑page html

De HtmlViewOptions‑klasse definieert instellingen voor HTML‑output, zoals het insluiten van resources. Laad het archief, configureer HTML‑opties om resources in te sluiten, en render alles naar één zelf‑bevatte pagina. Dit produceert een enkel HTML‑bestand dat alle bestanden, afbeeldingen, CSS en lettertypen bevat, klaar voor offline gebruik of e‑mailbijlage.

Direct antwoord: Maak een Viewer‑instance voor het ZIP‑bestand, roep HtmlViewOptions.forEmbeddedResources() aan, en voer viewer.view(documentPath, options) uit. Dit produceert een enkel HTML‑bestand dat alle bestanden, afbeeldingen, CSS en lettertypen bevat, klaar voor offline gebruik of e‑mailbijlage.

Stap 1: Outputdirectory definiëren

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

Stap 2: Bestandsnaam instellen voor single‑page output

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

Stap 3: De viewer initialiseren

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

Stap 4: Renderingopties configureren (resources html insluiten)

De HtmlViewOptions‑klasse definieert instellingen voor HTML‑output, zoals het insluiten van resources. Gebruik forEmbeddedResources() om alles in één bestand te bundelen.

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Stap 5: Renderen als een enkele pagina

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

Hoe archieven te renderen naar multi‑page html en items per page instellen

De HtmlViewOptions‑klasse ondersteunt ook paginering. Door options.setItemsPerPage(N) aan te roepen, instrueer je de viewer om het archief op te splitsen in meerdere HTML‑bestanden, elk met maximaal N items. Deze aanpak verbetert de navigatiesnelheid voor grote archieven terwijl elke pagina licht blijft.

Direct antwoord: Gebruik HtmlViewOptions.forEmbeddedResources(), roep options.setItemsPerPage(N) aan, en render het archief. De viewer genereert afzonderlijke HTML‑bestanden—één per pagina—elk met tot N items, wat de navigatie voor grote archieven versnelt.

Stap 1: Outputdirectory hergebruiken

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

Stap 2: Bestandsnaamsjabloon definiëren voor meerdere pagina’s

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

Stap 3: De viewer opnieuw initialiseren

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

Stap 4: Multi‑page opties configureren (resources html insluiten)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Stap 5: Items per pagina instellen (primaire zoekterm in actie)

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

Praktische toepassingen

  • Document management systems: Voeg archiefpreviewfunctionaliteit toe zonder extra viewers te installeren.
  • Web portals: Bied gebruikers een snelle, geen‑download manier om gebundelde documenten te verkennen.
  • Collaboration tools: Laat teams gedeelde archieven direct in de browser inspecteren.

Prestatieoverwegingen

  • Resource management: Houd het geheugenverbruik laag door archieven in streams te verwerken; de viewer kan archieven tot 500 MB aan zonder het volledige bestand in het geheugen te laden.
  • Batch convert archives: Loop door een lijst met archiefbestanden en roep dezelfde renderlogica aan om de doorvoer te maximaliseren.
  • Caching strategy: Sla gerenderde HTML op in een cache als hetzelfde archief vaak wordt benaderd, waardoor de verwerkingstijd bij herhaling met tot 70 % wordt verminderd.

Veelgestelde vragen

V: Wat is GroupDocs.Viewer Java?
A: GroupDocs.Viewer Java is een server‑side bibliotheek die meer dan 50 document‑ en archiefformaten—including ZIP en RAR—rendert naar HTML, PDF of afbeeldingsbestanden zonder externe applicaties.

V: Hoe kan ik een gratis proefversie van GroupDocs.Viewer verkrijgen?
A: Bezoek de gratis proeflink om te downloaden en te testen.

V: Kan ik andere documenttypen dan archieven converteren?
A: Ja, de viewer ondersteunt PDF’s, Word, Excel, PowerPoint en meer dan 35 extra formaten.

V: Wat moet ik doen als het renderen traag is?
A: Verminder het aantal items per pagina, schakel streaming in, of verwerk archieven in kleinere batches om de snelheid te verbeteren.

V: Waar kan ik hulp of ondersteuning krijgen?
A: Neem contact op via het support forum.

V: Is het mogelijk om CSS en afbeeldingen direct in de HTML in te sluiten?
A: Absoluut—gebruik HtmlViewOptions.forEmbeddedResources zoals in de voorbeelden.

V: Hoe batch ik een map met archieven?
A: Iterate over elk bestand met een for‑loop, en pas dezelfde Viewer‑ en HtmlViewOptions‑configuratie toe voor elke iteratie.

V: Waar kan ik problemen bespreken met andere gebruikers?
A: Bezoek het GroupDocs forum voor community‑discussies.

Bronnen

Laatst bijgewerkt: 2026-10-10
Getest met: GroupDocs.Viewer 25.2
Auteur: GroupDocs

Gerelateerde tutorials