Cách xem trước tệp Excel với GroupDocs.Parser trong Java

Nếu bạn đang tìm kiếm cách xem trước Excel dưới dạng bảng tính một cách lập trình, bạn đã đến đúng nơi. Trong hướng dẫn này, chúng tôi sẽ hướng dẫn cách tạo các bản xem trước hình ảnh (PNG) từ các workbook .xlsx bằng GroupDocs.Parser cho Java — hoàn hảo để tạo các thumbnail nhanh, chia sẻ ảnh chụp nhanh, hoặc xây dựng tính năng xem trước tài liệu trong ứng dụng của bạn.

Câu trả lời nhanh

• “preview Excel” có nghĩa là gì? Tạo các tệp hình ảnh (ví dụ: PNG) đại diện cho mỗi trang worksheet.
• Định dạng nào được đề xuất? PNG cung cấp chất lượng không mất dữ liệu và hoạt động tốt cho thumbnail trên web.
• Tôi có cần giấy phép không? Bản dùng thử miễn phí hoạt động cho phát triển; giấy phép thương mại cần thiết cho môi trường sản xuất.
• Tôi có thể thay đổi độ phân giải hình ảnh không? Có — điều chỉnh DPI trong PreviewOptions.
• Có thể xem trước các định dạng khác không? GroupDocs.Parser cũng hỗ trợ PDF, Word và nhiều loại hình ảnh.

“Cách xem trước Excel” là gì với GroupDocs.Parser?

GroupDocs.Parser đọc các workbook Excel, render mỗi sheet thành một trang hình ảnh, và cho phép bạn truyền các trang đó thành các tệp hình ảnh. Điều này loại bỏ nhu cầu sử dụng Office interop hoặc các bộ chuyển đổi của bên thứ ba.

Tại sao nên sử dụng GroupDocs.Parser để xem trước Excel?

• Không cần cài đặt Office – chạy trên bất kỳ môi trường Java phía server nào.
• Hỗ trợ tệp lớn – stream các trang từng cái một, giữ mức sử dụng bộ nhớ thấp.
• Đầu ra chất lượng cao – kiểm soát DPI, định dạng và các tùy chọn render.
• Linh hoạt đa định dạng – API giống nhau hoạt động cho PDF, tài liệu Word và hơn nữa.

Yêu cầu trước

• Java Development Kit (8 +).
• IDE such as IntelliJ IDEA or Eclipse.
• GroupDocs.Parser for Java SDK – download from here.
• Sample Excel file (.xlsx) you want to preview.
• Maven or Gradle (optional) for dependency management.

Nhập các gói

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;

Hướng dẫn từng bước để tạo bản xem trước trang bảng tính

Bước 1: Khởi tạo thể hiện Parser

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
}

Mẹo: Sử dụng đường dẫn tuyệt đối hoặc cấu hình thư mục tài nguyên để tránh FileNotFoundException.

Bước 2: Chuẩn bị các tùy chọn xem trước của bạn

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

Bước này là nơi bạn chuyển đổi xlsx sang png — luồng ghi dữ liệu PNG vào đĩa.

Bước 3: Gắn delegate để thu thập thông tin render

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

Bước 4: Chỉ định định dạng đầu ra và 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

Điều chỉnh DPI nếu bạn cần thumbnail nhỏ hơn (ví dụ: 96) hoặc in độ phân giải cao (ví dụ: 300).

Bước 5: Tạo các bản xem trước

With everything configured, call generatePreview. The SDK will iterate over each worksheet and invoke the stream you supplied.

parser.generatePreview(previewOptions);

Bước 6: Định nghĩa hàm trợ giúp getOutputPath()

This method builds a file name based on the page (sheet) number. Feel free to customize the folder structure.

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

Cạm bẫy thường gặp: Quên tạo thư mục output trước sẽ gây ra IOException. Tạo nó bằng chương trình hoặc đảm bảo nó tồn tại.

Ví dụ làm việc đầy đủ (đơn giản hoá)

Below is a compact version that ties all the pieces together. It demonstrates the create excel page preview 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.

Các vấn đề thường gặp & giải pháp

Câu hỏi thường gặp

Q: Tôi có thể tạo bản xem trước cho PDF và hình ảnh bằng GroupDocs.Parser không?
A: Có, cùng một API hoạt động cho PDF, tài liệu Word và nhiều định dạng hình ảnh.

Q: Làm thế nào để thay đổi định dạng hình ảnh đầu ra?
A: Gọi previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (hoặc Gif, Bmp, v.v.).

Q: Hiệu năng có phải là vấn đề với các workbook rất lớn không?
A: SDK stream các trang, giúp giảm mức sử dụng bộ nhớ. Đối với các tệp khổng lồ, cân nhắc xử lý theo các batch song song.

Q: Làm sao để xử lý lỗi trong quá trình tạo bản xem trước?
A: Bao bọc mã trong khối try‑catch (như đã minh họa) và ghi lại chi tiết ngoại lệ. Đảm bảo các luồng được đóng trong khối finally nếu bạn không sử dụng try‑with‑resources.

Q: Thư viện có yêu cầu cài đặt Microsoft Office không?
A: Không. GroupDocs.Parser là giải pháp thuần Java và hoạt động trên bất kỳ nền tảng nào hỗ trợ Java 8+.

Kết luận

Bạn đã có một phương pháp hoàn chỉnh, sẵn sàng cho sản xuất để cách xem trước Excel workbooks và chuyển đổi xlsx sang png bằng GroupDocs.Parser. Điều chỉnh DPI, thư mục đầu ra, hoặc định dạng hình ảnh để phù hợp với nhu cầu dự án, và tích hợp đoạn mã này vào các quy trình quản lý tài liệu lớn hơn.

Sẵn sàng cho bước tiếp theo? Khám phá tài liệu chính thức để biết các tùy chọn render nâng cao, tệp được bảo vệ bằng mật khẩu, và kỹ thuật xử lý batch.

Cập nhật lần cuối: 2026-02-06
Được kiểm tra với: GroupDocs.Parser 23.11 (latest at time of writing)
Tác giả: GroupDocs