Skapa kalkylblads‑miniatyrbild Java med GroupDocs.Parser

Om du letar efter create spreadsheet thumbnail Java‑program, har du hamnat på rätt ställe. I den här guiden går vi igenom hur du genererar högkvalitativa PNG‑förhandsgranskningar från .xlsx‑arbetsböcker med GroupDocs.Parser för Java—perfekt för snabba miniatyrbilder, dela ögonblicksbilder eller bygga en dokument‑förhandsgranskningsfunktion i din applikation. Lösningen fungerar utan en Microsoft Office‑installation och skalar till stora arbetsböcker samtidigt som minnesanvändningen hålls låg.

Snabba svar

• Vad betyder “preview Excel”? Genererar bildfiler (t.ex. PNG) som representerar varje kalkylbladssida.
• Vilket format rekommenderas? PNG ger förlustfri kvalitet och fungerar bra för webb‑miniatyrbilder.
• Behöver jag en licens? En gratis provversion fungerar för utveckling; en kommersiell licens krävs för produktion.
• Kan jag ändra bildens upplösning? Ja—justera DPI i PreviewOptions.
• Är det möjligt att förhandsgranska andra format? GroupDocs.Parser stödjer också PDF, Word och många bildtyper.

Vad är “how to preview Excel” med GroupDocs.Parser?

Läs in din Excel‑arbetsbok och rendera varje blad som en PNG‑bild utan att behöva Microsoft Office. GroupDocs.Parser strömmar sidor en i taget och producerar förlustfria miniatyrbilder som kan sparas till disk eller returneras via HTTP, vilket gör det idealiskt för webbaserade förhandsgransknings‑tjänster.

GroupDocs.Parser läser Excel‑arbetsböcker, renderar varje blad som en visuell sida och låter dig strömma dessa sidor till bildfiler. Detta eliminerar behovet av Office‑interop eller tredjeparts‑konverterare.

Varför använda GroupDocs.Parser för Excel‑förhandsgranskningar?

Du bör använda GroupDocs.Parser eftersom det fungerar på vilken Java‑server som helst, kräver ingen Office‑installation, hanterar stora arbetsböcker med låg minnesanvändning och producerar förlustfria PNG‑bilder med konfigurerbar DPI. SDK‑et stödjer 100+ in‑ och utdataformat, kan bearbeta en 200‑sidig arbetsbok på under 3 sekunder och håller minnesanvändningen under 50 MB per blad.

• Ingen Office‑installation krävs – körs på vilken server‑side Java‑miljö som helst.
• Stöder stora filer – strömmar sidor en‑och‑en, vilket håller minnesanvändningen låg.
• Högkvalitativ output – kontroll över DPI, format och renderingsalternativ.
• Tvärformatflexibilitet – samma API fungerar för PDF‑filer, Word‑dokument och mer.

Förutsättningar

• Java Development Kit (8 +).
• IDE såsom IntelliJ IDEA eller Eclipse.
• GroupDocs.Parser for Java SDK – ladda ner från here.
• Documentation – se den officiella documentation.
• Sample Excel file (.xlsx) du vill förhandsgranska.
• Maven eller Gradle (valfritt) för beroendehantering.

Importera paket

Dessa importeringar ger dig åtkomst till parsern, förhandsgranskningsalternativen och verktyg för strömhantering.

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;

Steg‑för‑steg‑guide för att generera kalkylblads‑sidoförhandsgranskningar

Steg 1: Initiera Parser‑instansen

Parser är GroupDocs.Parser:s kärnklass som ger läsåtkomst till kalkylbladsfiler och möjliggör sid‑vis rendering.
Skapa ett Parser‑objekt som pekar på din Excel‑arbetsbok. try‑with‑resources-blocket säkerställer att parsern stängs automatiskt.

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

Pro tip: Använd en absolut sökväg eller konfigurera en resursmapp för att undvika FileNotFoundException.

Steg 2: Förbered dina förhandsgranskningsalternativ

PreviewOptions konfigurerar renderingsparametrar såsom utdataformat och DPI.
ICreatePageStream är ett callback‑gränssnitt som tillhandahåller en utström för varje genererad sida. Definiera hur varje sida ska sparas. ICreatePageStream‑implementationen returnerar ett nytt FileOutputStream för varje kalkylbladssida.

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);
        }
    }
});

Detta steg är där du convert xlsx to png—strömmen skriver PNG‑data till disk.

Steg 3: Anslut en delegat för att fånga renderingsinformation

Om du behöver detaljer om varje renderat blad (t.ex. dimensioner, bladnamn), registrera en callback.

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

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

Steg 4: Ange utdataformat och DPI

Välj PNG som bildformat och sätt en DPI som balanserar kvalitet och filstorlek.

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

Justera DPI om du behöver mindre miniatyrbilder (t.ex. 96) eller högupplösta utskrifter (t.ex. 300).

Steg 5: Generera förhandsgranskningarna

När allt är konfigurerat, anropa generatePreview. SDK‑et itererar över varje kalkylblad och anropar den ström du tillhandahöll.

parser.generatePreview(previewOptions);

Steg 6: Definiera hjälpfunktionen getOutputPath()

getOutputPath() bygger ett filnamn baserat på sid‑ (blad‑)numret och returnerar hela sökvägen för utdata‑bilden. Anpassa gärna mappstrukturen.

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

Vanligt fallgropp: Att glömma att skapa output‑katalogen i förväg kommer att orsaka ett IOException. Skapa den programmässigt eller säkerställ att den finns.

Fullt fungerande exempel (förenklat)

Nedan är en kompakt version som binder ihop alla delar. Den demonstrerar create spreadsheet thumbnail Java‑arbetsflödet från början till slut.

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();
}

Kör detta kodsnutt, så hittar du en serie preview_page_1.png, preview_page_2.png, …‑filer i output‑mappen—varje fil representerar ett blad från den ursprungliga Excel‑arbetsboken.

Vanliga problem & lösningar

Vanliga frågor

Q: Kan jag generera förhandsgranskningar för PDF‑filer och bilder med GroupDocs.Parser?
A: Ja, samma API fungerar för PDF‑filer, Word‑dokument och många bildformat.

Q: Hur ändrar jag utdata‑bildformatet?
A: Anropa previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (eller Gif, Bmp, osv.).

Q: Är prestanda ett problem med mycket stora arbetsböcker?
A: SDK‑et strömmar sidor, vilket håller minnesanvändningen låg. För enorma filer, överväg att bearbeta i parallella batcher.

Q: Hur kan jag hantera fel under förhandsgranskningens generering?
A: Omge koden med try‑catch‑block (som visat) och logga undantagsdetaljerna. Säkerställ att strömmar stängs i finally‑blocket om du inte använder try‑with‑resources.

Q: Kräver biblioteket att Microsoft Office är installerat?
A: Nej. GroupDocs.Parser är en ren Java‑lösning och fungerar på alla plattformar som stödjer Java 8+.

Senast uppdaterad: 2026-07-16
Testat med: GroupDocs.Parser 23.11 (latest at time of writing)
Författare: GroupDocs

Relaterade handledningar

• Hur man genererar förhandsgranskning – Dokument‑sidoförhandsgransknings‑handledningar för GroupDocs.Parser Java
• Parse Excel Java med GroupDocs.Parser: Komplett guide
• Hur man extraherar råtext från Excel‑blad med GroupDocs.Parser för Java: En steg‑för‑steg‑guide