Erstellen von Spreadsheet‑Thumbnails in Java mit GroupDocs.Parser

Wenn Sie Spreadsheet‑Thumbnails in Java erstellen möchten, sind Sie hier genau richtig. In diesem Leitfaden zeigen wir, wie Sie hochwertige PNG‑Vorschauen aus .xlsx‑Arbeitsmappen mit GroupDocs.Parser für Java erzeugen – ideal für schnelle Thumbnails, das Teilen von Schnappschüssen oder den Aufbau einer Dokument‑Vorschaufunktion in Ihrer Anwendung. Die Lösung funktioniert ohne Microsoft‑Office‑Installation und skaliert bei großen Arbeitsmappen, während der Speicherverbrauch gering bleibt.

Schnelle Antworten

• Was bedeutet “Excel‑Vorschau”? Erzeugen von Bilddateien (z. B. PNG), die jede Arbeitsblattseite darstellen.
• Welches Format wird empfohlen? PNG liefert verlustfreie Qualität und eignet sich gut für Web‑Thumbnails.
• Benötige ich eine Lizenz? Eine kostenlose Testversion reicht für die Entwicklung; für den Produktionseinsatz ist eine kommerzielle Lizenz erforderlich.
• Kann ich die Bildauflösung ändern? Ja – passen Sie die DPI in PreviewOptions an.
• Ist es möglich, andere Formate vorzuschauen? GroupDocs.Parser unterstützt zudem PDF, Word und viele Bildformate.

Was bedeutet “Excel‑Vorschau” mit GroupDocs.Parser?

Laden Sie Ihre Excel‑Arbeitsmappe und rendern Sie jedes Blatt als PNG‑Bild, ohne Microsoft Office zu benötigen. GroupDocs.Parser streamt Seiten einzeln, erzeugt verlustfreie Thumbnails, die auf die Festplatte gespeichert oder per HTTP zurückgegeben werden können – ideal für webbasierte Vorschaudienste.

GroupDocs.Parser liest Excel‑Arbeitsmappen, rendert jedes Blatt als visuelle Seite und ermöglicht das Streamen dieser Seiten in Bilddateien. Dadurch entfällt die Notwendigkeit von Office‑Interop oder Drittanbieter‑Konvertern.

Warum GroupDocs.Parser für Excel‑Vorschauen verwenden?

Sie sollten GroupDocs.Parser einsetzen, weil es auf jedem Java‑Server läuft, keine Office‑Installation erfordert, große Arbeitsmappen mit geringem Speicherverbrauch verarbeitet und verlustfreie PNG‑Bilder mit konfigurierbarer DPI erzeugt. Das SDK unterstützt über 100 Eingabe‑ und Ausgabeformate, kann eine 200‑seitige Arbeitsmappe in weniger als 3 Sekunden verarbeiten und hält den Speicherverbrauch unter 50 MB pro Blatt.

• Keine Office‑Installation nötig – läuft in jeder serverseitigen Java‑Umgebung.
• Unterstützt große Dateien – streamt Seiten einzeln, wodurch der Speicherverbrauch niedrig bleibt.
• Ausgabe in hoher Qualität – Kontrolle über DPI, Format und Rendering‑Optionen.
• Flexibel über Formate hinweg – dieselbe API funktioniert für PDFs, Word‑Dokumente und mehr.

Voraussetzungen

• Java Development Kit (8 +).
• IDE wie IntelliJ IDEA oder Eclipse.
• GroupDocs.Parser für Java SDK – Download von hier.
• Dokumentation – siehe die offizielle Dokumentation.
• Beispieldatei (.xlsx), die Sie vorschauen möchten.
• Maven oder Gradle (optional) für das Dependency‑Management.

Pakete importieren

Diese Importe geben Ihnen Zugriff auf den Parser, die Vorschau‑Optionen und Hilfs‑Utilities für das Stream‑Handling.

import com.groupdocs.parser.Parser;
import com.groupdocs.parser.options.PreviewOptions;
import com.groupdocs.parser.options.PreviewFormats;
import com.groupdocs.parser.options.ICreatePageStream;
import com.groupdocs.parser.options.IPreviewPageRender;
import com.groupdocs.parser.results.PageRenderInfo;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.io.IOException;

Schritt‑für‑Schritt‑Anleitung zur Generierung von Spreadsheet‑Seiten‑Vorschauen

Schritt 1: Parser‑Instanz initialisieren

Parser ist die Kernklasse von GroupDocs.Parser, die Lesezugriff auf Spreadsheet‑Dateien bietet und das seitenweise Rendern ermöglicht.
Erzeugen Sie ein Parser‑Objekt, das auf Ihre Excel‑Arbeitsmappe zeigt. Der try‑with‑resources‑Block sorgt dafür, dass der Parser automatisch geschlossen wird.

try (Parser parser = new Parser("path/to/your/sample.xlsx")) {
    // Your subsequent code will go here
}

Pro‑Tipp: Verwenden Sie einen absoluten Pfad oder konfigurieren Sie einen Ressourcen‑Ordner, um FileNotFoundException zu vermeiden.

Schritt 2: Vorschauoptionen vorbereiten

PreviewOptions konfiguriert Render‑Parameter wie Ausgabeformat und DPI.
ICreatePageStream ist ein Callback‑Interface, das für jede erzeugte Seite einen Ausgabestream bereitstellt. Definieren Sie, wie jede Seite gespeichert werden soll. Die Implementierung von ICreatePageStream liefert für jedes Arbeitsblatt einen frischen FileOutputStream.

PreviewOptions previewOptions = new PreviewOptions(new ICreatePageStream() {
    @Override
    public OutputStream createPageStream(int pageNumber) {
        try {
            String outputPath = getOutputPath(pageNumber); // define this method later
            return new FileOutputStream(outputPath);
        } catch (IOException ex) {
            throw new RuntimeException("Error creating output stream", ex);
        }
    }
});

Dieser Schritt ist der Ort, an dem Sie xlsx zu png konvertieren – der Stream schreibt PNG‑Daten auf die Festplatte.

Schritt 3: Einen Delegaten anhängen, um Render‑Informationen zu erfassen

Wenn Sie Details zu jedem gerenderten Blatt benötigen (z. B. Abmessungen, Blattname), registrieren Sie einen Callback.

final PageRenderInfo[] renderInfoHolder = {null}; // to store info

previewOptions.setPreviewPageRender(new IPreviewPageRender() {
    @Override
    public void previewPageRender(PageRenderInfo pageRenderInfo) {
        renderInfoHolder[0] = pageRenderInfo;
    }
});

Schritt 4: Ausgabeformat und DPI festlegen

Wählen Sie PNG als Bildformat und setzen Sie eine DPI, die Qualität und Dateigröße ausbalanciert.

previewOptions.setPreviewFormat(PreviewFormats.Png); // PNG images
previewOptions.setDpi(150); // Higher DPI for better clarity

Passen Sie die DPI an, wenn Sie kleinere Thumbnails benötigen (z. B. 96) oder hochauflösende Drucke (z. B. 300).

Schritt 5: Vorschauen generieren

Nachdem alles konfiguriert ist, rufen Sie generatePreview auf. Das SDK iteriert über jedes Arbeitsblatt und ruft den von Ihnen bereitgestellten Stream auf.

parser.generatePreview(previewOptions);

Schritt 6: Hilfsmethode getOutputPath() definieren

getOutputPath() erstellt einen Dateinamen basierend auf der Seiten‑ (Blatt‑)Nummer und gibt den vollständigen Pfad für das Ausgabebild zurück. Passen Sie die Ordnerstruktur gern nach Ihren Bedürfnissen an.

private static String getOutputPath(int pageNumber) {
    return "output/preview_page_" + pageNumber + ".png"; // Custom path
}

Häufiges Stolper‑Problem: Wenn das Verzeichnis output nicht vorher erstellt wurde, führt das zu einer IOException. Erstellen Sie es programmgesteuert oder stellen Sie sicher, dass es existiert.

Vollständiges funktionierendes Beispiel (vereinfacht)

Unten finden Sie eine kompakte Version, die alle Bausteine zusammenführt. Sie demonstriert den Spreadsheet‑Thumbnail‑Workflow in Java von Anfang bis Ende.

try (Parser parser = new Parser("path/to/your/sample.xlsx")) {
    final PageRenderInfo[] renderInfoHolder = {null};

    PreviewOptions options = new PreviewOptions(new ICreatePageStream() {
        @Override
        public OutputStream createPageStream(int pageNumber) {
            try {
                return new FileOutputStream(getOutputPath(pageNumber));
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    });

    options.setPreviewPageRender(pageRenderInfo -> {
        renderInfoHolder[0] = pageRenderInfo;
    });
    options.setPreviewFormat(PreviewFormats.Png);
    options.setDpi(150);

    parser.generatePreview(options);
} catch (Exception e) {
    e.printStackTrace();
}

Führen Sie diesen Code aus, und Sie finden eine Reihe von preview_page_1.png, preview_page_2.png, … Dateien im Ordner output – jede stellt ein Blatt der ursprünglichen Excel‑Arbeitsmappe dar.

Häufige Probleme & Lösungen

Häufig gestellte Fragen

F: Kann ich Vorschauen für PDFs und Bilder mit GroupDocs.Parser erzeugen?
A: Ja, dieselbe API funktioniert für PDFs, Word‑Dokumente und viele Bildformate.

F: Wie ändere ich das Ausgabe‑Bildformat?
A: Rufen Sie previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (oder Gif, Bmp usw.) auf.

F: Ist die Performance bei sehr großen Arbeitsmappen ein Problem?
A: Das SDK streamt Seiten, wodurch der Speicherverbrauch niedrig bleibt. Bei extrem großen Dateien kann eine parallele Batch‑Verarbeitung sinnvoll sein.

F: Wie gehe ich mit Fehlern während der Vorschauerstellung um?
A: Umschließen Sie den Code mit try‑catch‑Blöcken (wie gezeigt) und protokollieren Sie die Ausnahme‑Details. Stellen Sie sicher, dass Streams im finally‑Block geschlossen werden, falls Sie kein try‑with‑resources verwenden.

F: Benötigt die Bibliothek eine Microsoft‑Office‑Installation?
A: Nein. GroupDocs.Parser ist eine reine Java‑Lösung und läuft auf jeder Plattform, die Java 8+ unterstützt.

Zuletzt aktualisiert: 2026-07-16
Getestet mit: GroupDocs.Parser 23.11 (zum Zeitpunkt des Schreibens)
Autor: GroupDocs

Verwandte Tutorials

• How to Generate Preview – Document Page Preview Generation Tutorials for GroupDocs.Parser Java
• Parse Excel Java with GroupDocs.Parser: Complete Guide
• How to Extract Raw Text from Excel Sheets Using GroupDocs.Parser for Java: A Step‑by‑Step Guide