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. Met GroupDocs.Viewer voor Java kun je convert zip to html in één stap, bepalen hoeveel archiefitems op elke pagina verschijnen, alle ondersteunende afbeeldingen en CSS insluiten, en zelfs tientallen archieven in batch verwerken. Deze tutorial leidt je door de volledige workflow, van Maven‑configuratie tot multi‑page rendering, en legt uit waarom elke instelling 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? Zeker; je kunt over een collectie archieven itereren en elk ervan renderen met dezelfde instellingen.
  • 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?

De set items per page instelling behoort tot de archief‑renderopties. Het vertelt de viewer hoeveel archiefitems (bestanden of mappen) op elke HTML‑pagina moeten worden weergegeven wanneer je een multi‑page HTML‑document genereert. Het aanpassen van deze waarde helpt je de paginagrootte en navigatiesnelheid in balans te houden, vooral bij grote archieven.

Waarom resources html insluiten?

Resources (afbeeldingen, CSS, lettertypen) direct in het HTML‑bestand insluiten creëert een enkel, draagbaar document dat geopend kan worden zonder externe bestanden. Dit is ideaal voor e‑mailbijlagen, offline weergave, of het insluiten van de output in andere webpagina’s. Deze aanpak vereenvoudigt ook de implementatie omdat er geen externe asset‑paden beheerd hoeven te worden.

Vereisten

  • Vereiste bibliotheken: GroupDocs.Viewer versie 25.2 of hoger opnemen.
  • 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 free trial link, een tijdelijke licentie, of een volledige aankoopoptie. Kies de optie die past bij de planning van je project.

Basisinitialisatie

Na de Maven‑configuratie, breng de viewer in je code:

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

Hoe archieven renderen naar single‑page html

Viewer is de kernklasse die een document of archief laadt voor rendering.

Om een enkel HTML‑bestand te genereren dat het volledige archief bevat, maak je een Viewer‑instantie voor het ZIP‑bestand en gebruik je HtmlViewOptions.forEmbeddedResources() om alle afbeeldingen, CSS en lettertypen in te sluiten. Het renderen van het archief met deze opties produceert één zelfstandige pagina geschikt voor e‑mail of offline gebruik.

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: Viewer initialiseren

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

Stap 4: Renderingopties configureren (resources html insluiten)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Stap 5: Renderen als een enkele pagina

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

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

HtmlViewOptions configureert hoe de viewer HTML‑output rendert, inclusief paginering en resource‑insluiting.

Om een archief in meerdere pagina’s te splitsen, maak je HtmlViewOptions.forEmbeddedResources() en stel je de gewenste paginagrootte in met options.setItemsPerPage(20). De viewer genereert afzonderlijke HTML‑bestanden, elk met maximaal het opgegeven aantal items, wat de navigatie voor grote archieven verbetert en een snellere laadtijd garandeert.

Stap 1: Outputdirectory hergebruiken

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

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

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

Stap 3: 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 sleutelwoord in actie)

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

Praktische toepassingen

  • Document management systems: Voeg archief‑preview functionaliteit 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 geheugengebruik 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 opgevraagd, waardoor de verwerkingstijd bij herhaling met tot 70 % wordt verminderd.

Veelgestelde vragen

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

Q: Hoe kan ik een gratis proefversie van GroupDocs.Viewer verkrijgen?
A: Bezoek de free trial link om te downloaden en te testen.

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

Q: 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.

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

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

Q: Hoe batch ik een map met archieven?
A: Iterate over elk bestand met een for‑loop, waarbij je dezelfde Viewer‑ en HtmlViewOptions‑configuratie toepast voor elke iteratie.

Bronnen

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

Gerelateerde tutorials