So previewen Sie Excel-Dateien mit GroupDocs.Parser in Java

Wenn Sie nach how to preview Excel Tabellenkalkulationen programmatisch suchen, sind Sie hier genau richtig. In diesem Leitfaden zeigen wir, wie Sie Bildvorschauen (PNG) aus .xlsx Arbeitsmappen mit GroupDocs.Parser für Java erstellen – ideal zum schnellen Erzeugen von Thumbnails, zum Teilen von Schnappschüssen oder zum Aufbau einer Dokument‑Vorschaufunktion in Ihrer Anwendung.

Schnelle Antworten

• What does “preview Excel” mean? Generieren von Bilddateien (z. B. PNG), die jede Arbeitsblattseite darstellen.
• Which format is recommended? PNG bietet verlustfreie Qualität und eignet sich gut für Web‑Thumbnails.
• Do I need a license? Eine kostenlose Testversion funktioniert für die Entwicklung; für die Produktion ist eine kommerzielle Lizenz erforderlich.
• Can I change the image resolution? Ja – passen Sie die DPI in PreviewOptions an.
• Is it possible to preview other formats? GroupDocs.Parser unterstützt außerdem PDF, Word und viele Bildformate.

Was ist “how to preview Excel” mit GroupDocs.Parser?

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?

• No Office installation required – läuft in jeder serverseitigen Java‑Umgebung.
• Supports large files – streamt Seiten einzeln und hält den Speicherverbrauch gering.
• High‑quality output – Kontrolle über DPI, Format und Rendering‑Optionen.
• Cross‑format flexibility – dieselbe API funktioniert für PDFs, Word‑Dokumente und mehr.

Voraussetzungen

• Java Development Kit (8 +).
• IDE wie IntelliJ IDEA oder Eclipse.
• GroupDocs.Parser for Java SDK – Download von here.
• Sample Excel file (.xlsx), die Sie previewen möchten.
• Maven or Gradle (optional) für das Dependency‑Management.

Pakete importieren

Diese Importe geben Ihnen Zugriff auf den Parser, die Vorschau‑Optionen und Hilfsprogramme 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 Erstellung von Tabellenblatt‑Vorschauen

Schritt 1: Parser‑Instanz initialisieren

Erstellen 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 Ressourcenordner, um FileNotFoundException zu vermeiden.

Schritt 2: Vorschau‑Optionen vorbereiten

Definieren Sie, wie jede Seite gespeichert wird. Die ICreatePageStream‑Implementierung liefert für jedes Arbeitsblatt einen neuen 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, in dem Sie convert xlsx to png – der Stream schreibt PNG‑Daten auf die Festplatte.

Schritt 3: Delegate 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

Diese Methode erstellt einen Dateinamen basierend auf der Seiten‑ (Blatt‑) Nummer. Passen Sie die Ordnerstruktur nach Belieben an.

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

Häufiges Problem: Wenn das output‑Verzeichnis nicht vorher erstellt wird, 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 Teile zusammenführt. Sie demonstriert den create excel page preview‑Ablauf 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 output‑Ordner – jede stellt ein Blatt der ursprünglichen Excel‑Arbeitsmappe dar.

Häufige Probleme & Lösungen

Häufig gestellte Fragen

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

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

Q: Ist die Performance bei sehr großen Arbeitsmappen ein Problem?
A: Das SDK streamt Seiten, wodurch der Speicherverbrauch gering bleibt. Bei riesigen Dateien sollten Sie die Verarbeitung in parallelen Batches erwägen.

Q: Wie kann ich Fehler bei der Vorschau‑Erstellung behandeln?
A: Umschließen Sie den Code mit try‑catch‑Blöcken (wie gezeigt) und protokollieren Sie die Ausnahmedetails. Stellen Sie sicher, dass Streams im finally‑Block geschlossen werden, wenn Sie kein try‑with‑resources verwenden.

Q: Benötigt die Bibliothek Microsoft Office installiert zu haben?
A: Nein. GroupDocs.Parser ist eine reine Java‑Lösung und funktioniert auf jeder Plattform, die Java 8+ unterstützt.

Fazit

Sie haben nun eine vollständige, produktionsreife Methode für how to preview Excel Arbeitsmappen und convert xlsx to png mit GroupDocs.Parser. Passen Sie DPI, Ausgabeverzeichnis oder Bildformat an die Anforderungen Ihres Projekts an und integrieren Sie dieses Snippet in größere Dokument‑Management‑Workflows.

Bereit für den nächsten Schritt? Erkunden Sie die offizielle documentation für erweiterte Rendering‑Optionen, passwortgeschützte Dateien und Batch‑Verarbeitungstechniken.

Zuletzt aktualisiert: 2026-02-06
Getestet mit: GroupDocs.Parser 23.11 (latest at time of writing)
Autor: GroupDocs