GroupDocs.Parser के साथ Java में Excel फ़ाइलों का प्रीव्यू कैसे करें

यदि आप प्रोग्रामेटिक रूप से how to preview Excel स्प्रेडशीट्स देखना चाहते हैं, तो आप सही जगह पर आए हैं। इस गाइड में हम GroupDocs.Parser for Java का उपयोग करके .xlsx वर्कबुक्स से इमेज प्रीव्यू (PNG) बनाने की प्रक्रिया बताएँगे—तेज़ थंबनेल बनाने, स्नैपशॉट शेयर करने, या आपके एप्लिकेशन में डॉक्यूमेंट‑प्रिव्यू फीचर बनाने के लिए एकदम उपयुक्त।

Quick Answers

“preview Excel” का क्या मतलब है? प्रत्येक वर्कशीट पेज का प्रतिनिधित्व करने वाली इमेज फ़ाइलें (जैसे PNG) बनाना।
कौन सा फ़ॉर्मेट सुझाया जाता है? PNG बिना गुणवत्ता खोए इमेज देता है और वेब थंबनेल के लिए उपयुक्त है।
क्या लाइसेंस चाहिए? विकास के लिए फ्री ट्रायल चलती है; प्रोडक्शन के लिए कमर्शियल लाइसेंस आवश्यक है।
क्या इमेज रिज़ॉल्यूशन बदल सकते हैं? हाँ—PreviewOptions में DPI समायोजित करें।
क्या अन्य फ़ॉर्मेट का प्रीव्यू भी संभव है? GroupDocs.Parser PDF, Word और कई इमेज टाइप्स को भी सपोर्ट करता है।

“how to preview Excel” with GroupDocs.Parser क्या है?

GroupDocs.Parser Excel वर्कबुक को पढ़ता है, प्रत्येक शीट को विज़ुअल पेज के रूप में रेंडर करता है, और उन पेजों को इमेज फ़ाइलों में स्ट्रीम करने की सुविधा देता है। इससे Office इंटरऑप या थर्ड‑पार्टी कन्वर्टर्स की जरूरत नहीं रहती।

Excel प्रीव्यू के लिए GroupDocs.Parser क्यों उपयोग करें?

Office इंस्टॉलेशन की ज़रूरत नहीं – किसी भी सर्वर‑साइड Java एनवायरनमेंट पर चलता है।
बड़ी फ़ाइलों को सपोर्ट – पेज‑बाय‑पेज स्ट्रीम करता है, जिससे मेमोरी उपयोग कम रहता है।
उच्च‑गुणवत्ता आउटपुट – DPI, फ़ॉर्मेट और रेंडरिंग विकल्पों पर नियंत्रण।
क्रॉस‑फ़ॉर्मेट लचीलापन – वही API PDFs, Word डॉक्यूमेंट्स आदि के लिए भी काम करता है।

Prerequisites

Java Development Kit (8 +).
IDE जैसे IntelliJ IDEA या Eclipse.
GroupDocs.Parser for Java SDK – डाउनलोड करें here.
सैंपल Excel फ़ाइल (.xlsx) जिसे आप प्रीव्यू करना चाहते हैं।
Maven या Gradle (वैकल्पिक) डिपेंडेंसी मैनेजमेंट के लिए।

Import Packages

इन इम्पोर्ट्स से आपको parser, preview options, और स्ट्रीम हैंडलिंग यूटिलिटीज़ मिलती हैं।

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;

Step‑by‑Step Guide to Generate Spreadsheet Page Previews

Step 1: Initialize the Parser Instance

एक Parser ऑब्जेक्ट बनाएं जो आपके Excel वर्कबुक की ओर इशारा करता हो। try‑with‑resources ब्लॉक parser को स्वचालित रूप से बंद कर देता है।

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

Pro tip: FileNotFoundException से बचने के लिए absolute path उपयोग करें या रिसोर्स फ़ोल्डर कॉन्फ़िगर करें।

Step 2: Prepare Your Preview Options

निर्धारित करें कि प्रत्येक पेज कैसे सेव होगा। ICreatePageStream इम्प्लीमेंटेशन हर वर्कशीट पेज के लिए एक नया 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);
        }
    }
});

यह चरण वह है जहाँ आप convert xlsx to png करते हैं—स्ट्रीम PNG डेटा को डिस्क पर लिखती है।

Step 3: Attach a Delegate to Capture Render Info

यदि आपको प्रत्येक रेंडर की गई शीट की जानकारी चाहिए (जैसे डाइमेंशन, शीट नाम), तो एक कॉलबैक रजिस्टर करें।

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

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

Step 4: Specify Output Format and DPI

इमेज फ़ॉर्मेट के रूप में PNG चुनें और ऐसा DPI सेट करें जो क्वालिटी और फ़ाइल साइज के बीच संतुलन बनाये।

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

छोटे थंबनेल (जैसे 96) या हाई‑रेज़ॉल्यूशन प्रिंट (जैसे 300) के लिए DPI समायोजित करें।

Step 5: Generate the Previews

सभी सेटिंग्स के बाद, generatePreview को कॉल करें। SDK प्रत्येक वर्कशीट पर इटररेट करेगा और आपके द्वारा प्रदान किए गए स्ट्रीम को इनवोक करेगा।

parser.generatePreview(previewOptions);

Step 6: Define the `getOutputPath()` Helper

यह मेथड पेज (शीट) नंबर के आधार पर फ़ाइल नाम बनाता है। फ़ोल्डर स्ट्रक्चर को अपनी जरूरत के अनुसार कस्टमाइज़ कर सकते हैं।

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

Common pitfall: output डायरेक्टरी पहले से न बनाने पर IOException आएगा। इसे प्रोग्रामेटिकली बनाएं या सुनिश्चित करें कि वह मौजूद है।

Full Working Example (Simplified)

नीचे एक कॉम्पैक्ट वर्ज़न है जो सभी हिस्सों को जोड़ता है। यह create excel page preview वर्कफ़्लो को शुरू से अंत तक दर्शाता है।

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

इस स्निपेट को चलाएँ, और आपको output फ़ोल्डर में preview_page_1.png, preview_page_2.png, … जैसी फ़ाइलें मिलेंगी—जो मूल Excel वर्कबुक की प्रत्येक शीट का प्रतिनिधित्व करती हैं।

Common Issues & Solutions

Issue	Cause	Fix
No images generated	`getOutputPath` एक अमान्य डायरेक्टरी रिटर्न करता है	सुनिश्चित करें कि टार्गेट फ़ोल्डर मौजूद है या `new File("output").mkdirs();` से बनाएं
Out‑of‑memory error on huge files	पूरी वर्कबुक को एक बार लोड करना	स्ट्रीमिंग एप्रोच (जैसा दिखाया) उपयोग करें और पेज‑बाय‑पेज प्रोसेस करें
Incorrect DPI	`setDpi` नहीं बुलाया गया या डिफ़ॉल्ट (96) पर रहा	`previewOptions.setDpi(yourDesiredValue);` को `generatePreview` से पहले कॉल करें
Unsupported format	करप्ट `.xlsx` फ़ाइल को प्रीव्यू करने की कोशिश	फ़ाइल को Excel से वैलिडेट करें या प्रोसेस करने से पहले `Parser.isSupported` चेक करें

Frequently Asked Questions

Q: क्या GroupDocs.Parser का उपयोग करके PDFs और इमेजेज का भी प्रीव्यू बना सकते हैं?
A: हाँ, वही API PDFs, Word डॉक्यूमेंट्स और कई इमेज फ़ॉर्मेट्स के लिए काम करता है।

Q: आउटपुट इमेज फ़ॉर्मेट कैसे बदलें?
A: previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (या Gif, Bmp, आदि) कॉल करें।

Q: बहुत बड़े वर्कबुक्स के साथ परफ़ॉर्मेंस की चिंता है?
A: SDK पेजेस को स्ट्रीम करता है, जिससे मेमोरी उपयोग कम रहता है। बहुत बड़े फ़ाइलों के लिए पैरलल बैच प्रोसेसिंग पर विचार करें।

Q: प्रीव्यू जनरेशन के दौरान एरर कैसे हैंडल करें?
A: कोड को try‑catch ब्लॉक्स में रैप करें (जैसा दिखाया) और एक्सेप्शन डिटेल्स को लॉग करें। यदि आप try‑with‑resources नहीं उपयोग कर रहे हैं तो finally ब्लॉक में स्ट्रीम को क्लोज़ करें।

Q: क्या लाइब्रेरी को Microsoft Office इंस्टॉल होना ज़रूरी है?
A: नहीं। GroupDocs.Parser एक शुद्ध Java सॉल्यूशन है और Java 8+ सपोर्ट करने वाले किसी भी प्लेटफ़ॉर्म पर चलता है।

Conclusion

अब आपके पास how to preview Excel वर्कबुक्स और convert xlsx to png करने का एक पूर्ण, प्रोडक्शन‑रेडी मेथड है, जो GroupDocs.Parser का उपयोग करता है। DPI, आउटपुट फ़ोल्डर या इमेज फ़ॉर्मेट को अपने प्रोजेक्ट की जरूरतों के अनुसार एडजस्ट करें, और इस स्निपेट को बड़े डॉक्यूमेंट‑मैनेजमेंट वर्कफ़्लो में इंटीग्रेट करें।

अगला कदम उठाने के लिए तैयार हैं? आधिकारिक documentation देखें ताकि एडवांस्ड रेंडरिंग ऑप्शन्स, पासवर्ड‑प्रोटेक्टेड फ़ाइलें, और बैच प्रोसेसिंग तकनीकों को एक्सप्लोर कर सकें।

Last Updated: 2026-02-06
Tested With: GroupDocs.Parser 23.11 (latest at time of writing)
Author: GroupDocs