Δημιουργία μικρογραφίας λογιστικού φύλλου Java χρησιμοποιώντας το GroupDocs.Parser
Αν ψάχνετε να δημιουργήσετε μικρογραφία λογιστικού φύλλου Java, βρίσκεστε στο σωστό μέρος. Σε αυτόν τον οδηγό θα σας δείξουμε πώς να δημιουργήσετε προεπισκοπήσεις PNG υψηλής ποιότητας από βιβλία εργασίας .xlsx χρησιμοποιώντας το GroupDocs.Parser για Java — ιδανικό για γρήγορες μικρογραφίες, κοινή χρήση στιγμιότυπων ή δημιουργία λειτουργίας προεπισκόπησης εγγράφων στην εφαρμογή σας. Η λύση λειτουργεί χωρίς εγκατάσταση Microsoft Office και κλιμακώνεται σε μεγάλα βιβλία εργασίας διατηρώντας χαμηλή χρήση μνήμης.
Γρήγορες Απαντήσεις
- Τι σημαίνει “preview Excel”; Δημιουργία αρχείων εικόνας (π.χ., PNG) που αντιπροσωπεύουν κάθε σελίδα φύλλου εργασίας.
- Ποια μορφή συνιστάται; Το PNG παρέχει ποιότητα χωρίς απώλειες και λειτουργεί καλά για μικρογραφίες στο web.
- Χρειάζομαι άδεια; Η δωρεάν δοκιμή λειτουργεί για ανάπτυξη· απαιτείται εμπορική άδεια για παραγωγή.
- Μπορώ να αλλάξω την ανάλυση της εικόνας; Ναι — ρυθμίστε το DPI στο
PreviewOptions. - Είναι δυνατόν να προεπισκοπήσετε άλλες μορφές; Το GroupDocs.Parser υποστηρίζει επίσης PDF, Word και πολλούς τύπους εικόνων.
Τι σημαίνει “πώς να προεπισκοπήσετε το Excel” με το GroupDocs.Parser;
Φορτώστε το βιβλίο εργασίας Excel και αποδώστε κάθε φύλλο ως εικόνα PNG χωρίς να χρειάζεται Microsoft Office. Το GroupDocs.Parser μεταδίδει τις σελίδες μία‑μια, παράγοντας μικρογραφίες χωρίς απώλειες που μπορούν να αποθηκευτούν στο δίσκο ή να επιστραφούν μέσω HTTP, καθιστώντας το ιδανικό για υπηρεσίες προεπισκόπησης στο web.
Το GroupDocs.Parser διαβάζει βιβλία εργασίας Excel, αποδίδει κάθε φύλλο ως οπτική σελίδα και σας επιτρέπει να μεταδώσετε αυτές τις σελίδες σε αρχεία εικόνας. Αυτό εξαλείφει την ανάγκη για διασύνδεση με το Office ή τρίτους μετατροπείς.
Γιατί να χρησιμοποιήσετε το GroupDocs.Parser για προεπισκοπήσεις Excel;
Θα πρέπει να χρησιμοποιήσετε το GroupDocs.Parser επειδή λειτουργεί σε οποιονδήποτε διακομιστή Java, δεν απαιτεί εγκατάσταση Office, διαχειρίζεται μεγάλα βιβλία εργασίας με χαμηλή μνήμη και παράγει εικόνες PNG χωρίς απώλειες με ρυθμιζόμενο DPI. Το SDK υποστηρίζει 100+ input and output formats, μπορεί να επεξεργαστεί ένα βιβλίο εργασίας 200 σελίδων σε λιγότερο από 3 δευτερόλεπτα και διατηρεί τη χρήση μνήμης κάτω από 50 MB ανά φύλλο.
- Δεν απαιτείται εγκατάσταση Office – λειτουργεί σε οποιοδήποτε περιβάλλον Java στο διακομιστή.
- Υποστηρίζει μεγάλα αρχεία – μεταδίδει σελίδες μία‑μία, διατηρώντας τη χρήση μνήμης χαμηλή.
- Έξοδος υψηλής ποιότητας – έλεγχος DPI, μορφής και επιλογών απόδοσης.
- Ευελιξία μεταξύ μορφών – το ίδιο API λειτουργεί για PDF, έγγραφα Word και άλλα.
Προαπαιτούμενα
- Java Development Kit (8 +).
- IDE όπως IntelliJ IDEA ή Eclipse.
- GroupDocs.Parser for Java SDK – κατεβάστε από here.
- Documentation – δείτε την επίσημη documentation.
- Δείγμα αρχείου Excel (
.xlsx) που θέλετε να προεπισκοπήσετε. - Maven ή Gradle (προαιρετικό) για διαχείριση εξαρτήσεων.
Εισαγωγή Πακέτων
These imports give you access to the parser, preview options, and stream handling utilities.
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;
Οδηγός βήμα‑βήμα για τη δημιουργία προεπισκοπήσεων σελίδων λογιστικού φύλλου
Βήμα 1: Αρχικοποίηση του αντικειμένου Parser
Parser is GroupDocs.Parser’s core class that provides read access to spreadsheet files and enables page‑wise rendering.
Create a Parser object pointing at your Excel workbook. The try‑with‑resources block ensures the parser is closed automatically.
try (Parser parser = new Parser("path/to/your/sample.xlsx")) {
// Your subsequent code will go here
}
Pro tip: Χρησιμοποιήστε απόλυτη διαδρομή ή διαμορφώστε φάκελο πόρων για να αποφύγετε το
FileNotFoundException.
Βήμα 2: Προετοιμασία των επιλογών προεπισκόπησης
PreviewOptions configures rendering parameters such as output format and DPI.ICreatePageStream is a callback interface that supplies an output stream for each generated page. Define how each page will be saved. The ICreatePageStream implementation returns a fresh FileOutputStream for every worksheet page.
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);
}
}
});
Αυτό το βήμα είναι όπου μετατρέπετε xlsx σε png — η ροή γράφει δεδομένα PNG στο δίσκο.
Βήμα 3: Προσθήκη αντιπροσώπου για σύλληψη πληροφοριών απόδοσης
If you need details about each rendered sheet (e.g., dimensions, sheet name), register a callback.
final PageRenderInfo[] renderInfoHolder = {null}; // to store info
previewOptions.setPreviewPageRender(new IPreviewPageRender() {
@Override
public void previewPageRender(PageRenderInfo pageRenderInfo) {
renderInfoHolder[0] = pageRenderInfo;
}
});
Βήμα 4: Καθορισμός μορφής εξόδου και DPI
Select PNG as the image format and set a DPI that balances quality and file size.
previewOptions.setPreviewFormat(PreviewFormats.Png); // PNG images
previewOptions.setDpi(150); // Higher DPI for better clarity
Ρυθμίστε το DPI αν χρειάζεστε μικρότερες μικρογραφίες (π.χ., 96) ή εκτυπώσεις υψηλής ανάλυσης (π.χ., 300).
Βήμα 5: Δημιουργία των προεπισκοπήσεων
With everything configured, call generatePreview. The SDK will iterate over each worksheet and invoke the stream you supplied.
parser.generatePreview(previewOptions);
Βήμα 6: Ορισμός της βοηθητικής μεθόδου getOutputPath()
getOutputPath() builds a file name based on the page (sheet) number and returns the full path for the output image. Feel free to customize the folder structure.
private static String getOutputPath(int pageNumber) {
return "output/preview_page_" + pageNumber + ".png"; // Custom path
}
Συνηθισμένο λάθος: Η παράλειψη δημιουργίας του καταλόγου
outputεκ των προτέρων θα προκαλέσειIOException. Δημιουργήστε το προγραμματιστικά ή βεβαιωθείτε ότι υπάρχει.
Πλήρες λειτουργικό παράδειγμα (απλοποιημένο)
Below is a compact version that ties all the pieces together. It demonstrates the δημιουργία μικρογραφίας λογιστικού φύλλου Java workflow from start to finish.
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();
}
Run this snippet, and you’ll find a series of preview_page_1.png, preview_page_2.png, … files in the output folder—each representing a sheet from the original Excel workbook.
Συχνά Προβλήματα & Λύσεις
| Issue | Cause | Fix |
|---|---|---|
| No images generated | getOutputPath returns an invalid directory | Ensure the target folder exists or create it with new File("output").mkdirs(); |
| Out‑of‑memory error on huge files | Loading the whole workbook at once | Use the streaming approach (as shown) and process pages one at a time |
| Incorrect DPI | setDpi not called or set to default (96) | Call previewOptions.setDpi(yourDesiredValue); before generatePreview |
| Unsupported format | Trying to preview a corrupted .xlsx | Validate the file with Excel or use Parser.isSupported before processing |
Συχνές Ερωτήσεις
Q: Μπορώ να δημιουργήσω προεπισκοπήσεις για PDF και εικόνες χρησιμοποιώντας το GroupDocs.Parser;
A: Ναι, το ίδιο API λειτουργεί για PDF, έγγραφα Word και πολλά μορφές εικόνων.
Q: Πώς αλλάζω τη μορφή εξόδου της εικόνας;
A: Καλείτε previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (ή Gif, Bmp, κλπ.).
Q: Είναι η απόδοση πρόβλημα με πολύ μεγάλα βιβλία εργασίας;
A: Το SDK μεταδίδει σελίδες, διατηρώντας τη χρήση μνήμης χαμηλή. Για τεράστια αρχεία, σκεφτείτε επεξεργασία σε παράλληλες παρτίδες.
Q: Πώς μπορώ να διαχειριστώ σφάλματα κατά τη δημιουργία προεπισκοπήσεων;
A: Τυλίξτε τον κώδικα σε μπλοκ try‑catch (όπως φαίνεται) και καταγράψτε τις λεπτομέρειες της εξαίρεσης. Βεβαιωθείτε ότι οι ροές κλείνουν στο block finally αν δεν χρησιμοποιείτε try‑with‑resources.
Q: Η βιβλιοθήκη απαιτεί εγκατάσταση Microsoft Office;
A: Όχι. Το GroupDocs.Parser είναι μια καθαρά Java λύση και λειτουργεί σε οποιαδήποτε πλατφόρμα υποστηρίζει Java 8+.
Τελευταία ενημέρωση: 2026-07-16
Δοκιμάστηκε με: GroupDocs.Parser 23.11 (latest at time of writing)
Συγγραφέας: GroupDocs