Táblázat bélyegkép létrehozása Java-val a GroupDocs.Parser használatával

Ha create spreadsheet thumbnail Java programokat keresel, jó helyen jársz. Ebben az útmutatóban bemutatjuk, hogyan generálhatunk magas minőségű PNG előnézeteket .xlsx munkafüzetekből a GroupDocs.Parser for Java segítségével – tökéletes gyors bélyegképekhez, pillanatképek megosztásához vagy dokumentum‑előnézet funkció építéséhez az alkalmazásodban. A megoldás Microsoft Office telepítése nélkül működik, és nagy munkafüzetek esetén is alacsony memóriahasználattal skálázható.

Gyors válaszok

  • Mi jelent a „preview Excel”? Képfájlok (pl. PNG) generálása, amelyek minden munkalap oldalát ábrázolják.
  • Melyik formátum ajánlott? A PNG veszteségmentes minőséget biztosít, és jól működik webes bélyegképekhez.
  • Szükségem van licencre? Egy ingyenes próba verzió fejlesztéshez megfelelő; a termeléshez kereskedelmi licenc szükséges.
  • Módosíthatom a kép felbontását? Igen – állítsd be a DPI‑t a PreviewOptions‑ban.
  • Lehetséges más formátumok előnézetét is készíteni? A GroupDocs.Parser támogatja a PDF, Word és számos képformátum előnézetét is.

Mi az a „hogyan előnézet Excel” a GroupDocs.Parser-rel?

Töltsd be az Excel munkafüzetet, és rendereld minden munkalapot PNG képként anélkül, hogy Microsoft Office-ra lenne szükség. A GroupDocs.Parser egyesével streameli az oldalakat, veszteségmentes bélyegképeket készítve, amelyeket lemezre menthetünk vagy HTTP‑n keresztül visszaküldhetünk, így ideális web‑alapú előnézeti szolgáltatásokhoz.

A GroupDocs.Parser beolvassa az Excel munkafüzeteket, minden munkalapot vizuális oldalként renderel, és lehetővé teszi ezen oldalak képfájlokba való streamelését. Ez megszünteti az Office interop vagy harmadik fél konverterek szükségességét.

Miért használjuk a GroupDocs.Parser-t Excel előnézetekhez?

A GroupDocs.Parser-t azért érdemes használni, mert bármely Java szerveren működik, nem igényel Office telepítést, nagy munkafüzeteket kezel alacsony memóriaigénnyel, és konfigurálható DPI‑val veszteségmentes PNG képeket állít elő. Az SDK 100+ bemeneti és kimeneti formátumot támogat, egy 200 oldalas munkafüzetet 3 másodperc alatt képes feldolgozni, és a memóriahasználatot laponként 50 MB alatt tartja.

  • Nincs szükség Office telepítésére – bármely szerver‑oldali Java környezetben fut.
  • Nagy fájlok támogatása – egyesével streameli az oldalakat, alacsony memóriahasználatot biztosítva.
  • Magas minőségű kimenet – DPI, formátum és renderelési beállítások szabályozása.
  • Kereszt‑formátum rugalmasság – ugyanaz az API működik PDF‑ek, Word dokumentumok és egyéb formátumok esetén is.

Előfeltételek

  • Java Development Kit (8 +).
  • IDE, például IntelliJ IDEA vagy Eclipse.
  • GroupDocs.Parser for Java SDK – töltsd le itt.
  • Documentation – lásd a hivatalos documentation.
  • Sample Excel file (.xlsx), amelyet elő szeretnél nézni.
  • Maven vagy Gradle (opcionális) a függőségkezeléshez.

Csomagok importálása

Ezek az importok hozzáférést biztosítanak a parserhez, az előnézeti beállításokhoz és a stream kezelő segédeszközökhöz.

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;

Lépésről‑lépésre útmutató a táblázat oldal előnézetek generálásához

1. lépés: A Parser példány inicializálása

A Parser a GroupDocs.Parser központi osztálya, amely olvasási hozzáférést biztosít a táblázatfájlokhoz, és lehetővé teszi az oldalankénti renderelést.
Hozz létre egy Parser objektumot, amely a te Excel munkafüzetedre mutat. A try‑with‑resources blokk automatikusan bezárja a parser‑t.

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

Pro tipp: Használj abszolút útvonalat vagy konfigurálj egy erőforrás mappát a FileNotFoundException elkerüléséhez.

2. lépés: Az előnézeti beállítások előkészítése

A PreviewOptions a renderelési paramétereket állítja be, például a kimeneti formátumot és a DPI‑t.
Az ICreatePageStream egy callback interfész, amely minden generált oldalhoz egy kimeneti streamet biztosít. Határozd meg, hogyan legyen mentve az egyes oldalak. Az ICreatePageStream megvalósítás egy új FileOutputStream‑et ad vissza minden munkalap oldalhoz.

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

Ez a lépés, ahol convert xlsx to png—a stream PNG adatot ír a lemezre.

3. lépés: Delegált csatolása a renderelési információk rögzítéséhez

Ha részletekre van szükséged az egyes renderelt munkalapokról (pl. méretek, munkalap neve), regisztrálj egy callback‑et.

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

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

4. lépés: Kimeneti formátum és DPI megadása

Válaszd a PNG formátumot képként, és állíts be egy DPI‑t, amely egyensúlyban tartja a minőséget és a fájlméretet.

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

Állítsd be a DPI‑t, ha kisebb bélyegképekre (pl. 96) vagy nagy felbontású nyomtatásra (pl. 300) van szükség.

5. lépés: Az előnézetek generálása

Minden beállítás után hívd meg a generatePreview‑t. Az SDK végigiterál minden munkalapon, és meghívja a megadott streamet.

parser.generatePreview(previewOptions);

6. lépés: A getOutputPath() segédfüggvény definiálása

A getOutputPath() a lap (munkalap) száma alapján épít fel egy fájlnevet, és visszaadja a kimeneti kép teljes útvonalát. Nyugodtan testreszabhatod a mappaszerkezetet.

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

Gyakori hibaforrás: Ha előre nem hozod létre az output könyvtárat, IOException keletkezik. Hozd létre programozottan vagy győződj meg róla, hogy létezik.

Teljes működő példa (Egyszerűsített)

Az alábbiakban egy tömör változat látható, amely összekapcsolja az összes elemet. Bemutatja a create spreadsheet thumbnail Java munkafolyamatot az elejétől a végéig.

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

Futtasd ezt a kódrészletet, és a output mappában sorozatban megtalálod a preview_page_1.png, preview_page_2.png, … fájlokat – mindegyik az eredeti Excel munkafüzet egy munkalapját ábrázolja.

Gyakori problémák és megoldások

ProblémaOkMegoldás
Nem jönnek létre képekgetOutputPath érvénytelen könyvtárat ad visszaGyőződj meg róla, hogy a célkönyvtár létezik, vagy hozd létre a new File("output").mkdirs(); segítségével
Memóriahiány hiba hatalmas fájloknálA teljes munkafüzet egyszerre történő betöltéseHasználd a streaming megközelítést (ahogy bemutattuk), és dolgozd fel az oldalakat egyesével
Helytelen DPIsetDpi nincs meghívva vagy alapértelmezett (96) értékre van állítvaHívd meg a previewOptions.setDpi(kívántÉrték);‑t a generatePreview előtt
Nem támogatott formátumMegpróbálsz előnézetet készíteni egy sérült .xlsx fájlbólEllenőrizd a fájlt Excel‑lel, vagy a feldolgozás előtt használd a Parser.isSupported‑t

Gyakran feltett kérdések

K: Generálhatok előnézetet PDF‑ekhez és képekhez a GroupDocs.Parser használatával?
V: Igen, ugyanaz az API működik PDF‑ek, Word dokumentumok és számos képformátum esetén.

K: Hogyan változtathatom meg a kimeneti képformátumot?
V: Hívd meg a previewOptions.setPreviewFormat(PreviewFormats.Jpeg)‑t (vagy Gif, Bmp, stb.).

K: Teljesítményprobléma merül fel nagyon nagy munkafüzeteknél?
V: Az SDK oldalakat streameli, ami alacsony memóriahasználatot biztosít. Nagy fájlok esetén fontold meg a párhuzamos kötegelt feldolgozást.

K: Hogyan kezeljem a hibákat az előnézet generálása során?
V: Tedd a kódot try‑catch blokkokba (ahogy bemutattuk), és naplózd a kivétel részleteit. Győződj meg róla, hogy a stream-ek zárva vannak a finally blokkban, ha nem a try‑with‑resources‑t használod.

K: A könyvtár megköveteli a Microsoft Office telepítését?
V: Nem. A GroupDocs.Parser egy tiszta Java megoldás, és bármely, Java 8+‑t támogató platformon működik.

Utoljára frissítve: 2026-07-16
Tesztelve ezzel: GroupDocs.Parser 23.11 (a legújabb a írás időpontjában)
Szerző: GroupDocs

Kapcsolódó oktatóanyagok