ZIP in HTML konvertieren und Elemente pro Seite festlegen mit GroupDocs.Viewer Java

In vielen Webanwendungen müssen Sie den Inhalt eines ZIP- oder RAR-Archivs direkt im Browser anzeigen. Mit GroupDocs.Viewer für Java können Sie ZIP in HTML konvertieren in einem einzigen Schritt, steuern, wie viele Archiveinträge auf jeder Seite erscheinen, alle unterstützenden Bilder und CSS einbetten und sogar Dutzende von Archiven stapelweise verarbeiten. Dieses Tutorial führt Sie durch den gesamten Workflow, von der Maven‑Einrichtung bis zur Mehrseitendarstellung, und erklärt, warum jede Einstellung für Leistung und Benutzerfreundlichkeit wichtig ist.

Archive in HTML konvertieren mit GroupDocs.Viewer für Java

Schnelle Antworten

  • Was steuert “set items per page”? Es bestimmt, wie viele Dateien oder Ordner aus einem Archiv auf jeder erzeugten HTML‑Seite erscheinen.
  • Kann ich Bilder und CSS direkt in das HTML einbetten? Ja – verwenden Sie die Option forEmbeddedResources, um Ressourcen in das HTML einzubetten.
  • Ist eine Batch‑Konvertierung möglich? Absolut; Sie können über eine Sammlung von Archiven iterieren und jedes mit denselben Einstellungen rendern.
  • Benötige ich Maven, um GroupDocs.Viewer zu verwenden? Ja, fügen Sie die Maven‑Abhängigkeit groupdocs-viewer wie unten gezeigt hinzu.
  • Welche Ausgabeformate werden unterstützt? Single‑Page‑HTML und Multi‑Page‑HTML sind beide verfügbar, und die Bibliothek unterstützt über 50 Eingabe‑Archivtypen.

Was bedeutet “set items per page” in GroupDocs.Viewer?

Die Einstellung set items per page gehört zu den Optionen für die Archivdarstellung. Sie gibt dem Viewer an, wie viele Archiveinträge (Dateien oder Ordner) auf jeder HTML‑Seite angezeigt werden sollen, wenn Sie ein mehrseitiges HTML‑Dokument erzeugen. Die Anpassung dieses Werts hilft, die Seitengröße und die Navigationsgeschwindigkeit auszubalancieren, insbesondere bei großen Archiven.

Warum Ressourcen in HTML einbetten?

Das Einbetten von Ressourcen (Bilder, CSS, Schriftarten) direkt in die HTML‑Datei erzeugt ein einzelnes, portables Dokument, das ohne externe Dateien geöffnet werden kann. Dies ist ideal für E‑Mail‑Anhänge, Offline‑Ansicht oder das Einbetten der Ausgabe in andere Webseiten. Dieser Ansatz vereinfacht zudem die Bereitstellung, da keine externen Asset‑Pfade verwaltet werden müssen.

Voraussetzungen

  • Erforderliche Bibliotheken: GroupDocs.Viewer Version 25.2 oder höher einbinden.
  • Umgebung: Java Development Kit (JDK) installiert und konfiguriert.
  • Kenntnisse: Grundlegendes Java und Maven‑Abhängigkeitsverwaltung.

Maven GroupDocs Viewer Einrichtung

Fügen Sie das GroupDocs‑Repository und die Viewer‑Abhängigkeit zu Ihrer pom.xml hinzu:

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

Lizenzbeschaffung

GroupDocs.Viewer bietet einen Kostenlosen Testlink, eine temporäre Lizenz oder eine Vollkaufoption. Wählen Sie diejenige, die zu Ihrem Projektzeitplan passt.

Grundlegende Initialisierung

Nach der Maven‑Einrichtung bringen Sie den Viewer in Ihren Code:

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

Wie man Archive zu Single‑Page‑HTML rendert

Viewer ist die Kernklasse, die ein Dokument oder Archiv zum Rendern lädt.

Um eine einzelne HTML‑Datei zu erzeugen, die das gesamte Archiv enthält, erstellen Sie eine Viewer‑Instanz für die ZIP‑Datei und verwenden HtmlViewOptions.forEmbeddedResources(), um alle Bilder, CSS und Schriftarten einzubetten. Das Rendern des Archivs mit diesen Optionen erzeugt eine selbstenthaltene Seite, die sich für E‑Mail oder Offline‑Verwendung eignet.

Schritt 1: Ausgabeverzeichnis definieren

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

Schritt 2: Dateinamen für Single‑Page‑Ausgabe festlegen

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

Schritt 3: Viewer initialisieren

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

Schritt 4: Rendering‑Optionen konfigurieren (Ressourcen in HTML einbetten)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Schritt 5: Als einzelne Seite rendern

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

Wie man Archive zu Multi‑Page‑HTML rendert und Elemente pro Seite festlegt

HtmlViewOptions konfiguriert, wie der Viewer HTML‑Ausgabe rendert, einschließlich Paginierung und Ressourcen‑Einbettung.

Um ein Archiv in mehrere Seiten aufzuteilen, erstellen Sie HtmlViewOptions.forEmbeddedResources() und setzen die gewünschte Seitengröße mit options.setItemsPerPage(20). Der Viewer erzeugt separate HTML‑Dateien, von denen jede bis zur angegebenen Anzahl von Einträgen anzeigt, was die Navigation bei großen Archiven verbessert und ein schnelleres Laden gewährleistet.

Schritt 1: Ausgabeverzeichnis wiederverwenden

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

Schritt 2: Dateinamensformat für mehrere Seiten festlegen

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

Schritt 3: Viewer erneut initialisieren

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

Schritt 4: Multi‑Page‑Optionen konfigurieren (Ressourcen in HTML einbetten)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Schritt 5: Elemente pro Seite festlegen (primäres Schlüsselwort in Aktion)

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

Praktische Anwendungen

  • Dokumentenmanagement‑Systeme: Archivvorschaufunktionalität hinzufügen, ohne zusätzliche Viewer zu installieren.
  • Webportale: Benutzern eine schnelle, download‑freie Möglichkeit bieten, gebündelte Dokumente zu erkunden.
  • Collaboration‑Tools: Teams ermöglichen, gemeinsam genutzte Archive direkt im Browser zu inspizieren.

Leistungsüberlegungen

  • Ressourcenverwaltung: Speicherverbrauch gering halten, indem Archive in Streams verarbeitet werden; der Viewer kann Archive bis zu 500 MB handhaben, ohne die gesamte Datei in den Speicher zu laden.
  • Batch‑Konvertierung von Archiven: Durchlaufen Sie eine Liste von Archivdateien und rufen Sie dieselbe Rendering‑Logik auf, um den Durchsatz zu maximieren.
  • Caching‑Strategie: Rendertes HTML in einem Cache speichern, wenn dasselbe Archiv häufig aufgerufen wird, wodurch die Wiederholungsbearbeitungszeit um bis zu 70 % reduziert wird.

Häufig gestellte Fragen

Q: Was ist GroupDocs.Viewer Java?
A: GroupDocs.Viewer Java ist eine serverseitige Bibliothek, die über 50 Dokument‑ und Archivformate—including ZIP und RAR—nach HTML, PDF oder Bilddateien rendert, ohne externe Anwendungen zu benötigen.

Q: Wie kann ich eine kostenlose Testversion von GroupDocs.Viewer erhalten?
A: Besuchen Sie den free trial link, um herunterzuladen und zu testen.

Q: Kann ich andere Dokumenttypen außer Archiven konvertieren?
A: Ja, der Viewer unterstützt PDFs, Word, Excel, PowerPoint und über 35 weitere Formate.

Q: Was soll ich tun, wenn das Rendering langsam ist?
A: Reduzieren Sie die Anzahl der Elemente pro Seite, aktivieren Sie Streaming oder verarbeiten Sie Archive in kleineren Batches, um die Geschwindigkeit zu verbessern.

Q: Wo kann ich Hilfe oder Support erhalten?
A: Wenden Sie sich über das support forum an uns.

Q: Ist es möglich, CSS und Bilder direkt in das HTML einzubetten?
A: Absolut—verwenden Sie HtmlViewOptions.forEmbeddedResources, wie in den Beispielen gezeigt.

Q: Wie konvertiere ich einen Ordner mit Archiven stapelweise?
A: Durchlaufen Sie jede Datei mit einer for‑Schleife und wenden Sie für jede Iteration dieselbe Viewer‑ und HtmlViewOptions‑Konfiguration an.

Ressourcen

Zuletzt aktualisiert: 2026-08-03
Getestet mit: GroupDocs.Viewer 25.2
Autor: GroupDocs

Verwandte Tutorials