Menghasilkan pratinjau visual data spreadsheet adalah kebutuhan yang sering muncul saat membangun dasbor pelaporan atau ringkasan email. Conholdate.Total for Java menyediakan SDK yang kuat yang menyederhanakan proses mengonversi Excel menjadi gambar dalam aplikasi Java. Dalam panduan ini Anda akan melihat cara memuat workbook XLSX, mengonfigurasi output PNG, dan menghasilkan file gambar untuk seluruh lembar kerja, diagram, atau rentang tertentu. Pada akhir panduan Anda akan memiliki contoh kode siap‑jalankan yang dapat Anda adaptasi ke proyek Anda sendiri.

Apa yang Diperlukan Convert Excel Files to Image dari Aplikasi Anda

Pengembang sering perlu mengubah konten spreadsheet menjadi gambar statis untuk pratinjau web, laporan PDF, atau thumbnail seluler. Persyaratannya biasanya mencakup mempertahankan pemformatan sel, merender diagram yang disematkan, dan secara opsional membatasi konversi ke satu rentang saja. Menangani tugas‑tugas ini secara manual dengan membuka Excel, mengambil tangkapan layar, dan menyimpannya tidak dapat diskalakan dan dapat menghasilkan hasil yang tidak konsisten.

Kendala teknis untuk solusi yang dapat diandalkan meliputi: dukungan untuk file XLSX, kemampuan menyertakan diagram dan rumus, resolusi gambar yang dapat dikonfigurasi, serta pemrosesan batch pada beberapa lembar kerja. Konversi harus dijalankan di lingkungan server atau desktop tanpa memerlukan Microsoft Office.

Memilih Conholdate.Total for Java untuk Pekerjaan

Conholdate.Total for Java menawarkan API terpadu yang mencakup semua kemampuan yang dibutuhkan. ExcelLoadOptions-nya memungkinkan Anda memuat diagram dan rumus, sementara ImageConvertOptions memberikan kontrol detail atas format, kualitas, dan dimensi. SDK ini bekerja pada runtime Java apa pun, hanya memerlukan dependensi Maven, dan menangani buku kerja besar secara efisien.

Untuk penggunaan API yang detail, lihat dokumentasi resmi. Referensi lengkap untuk kelas seperti Conversion, ExcelLoadOptions, dan ImageConvertOptions tersedia di referensi API. Anda dapat mengunduh perpustakaan terbaru dari halaman rilis.

Implementasi Konversi Excel ke Gambar dalam Java

Proses konversi dapat dibagi menjadi beberapa langkah yang jelas. Bagian‑bagian berikut akan memandu Anda melalui setiap bagian, dengan cuplikan kode singkat yang diambil langsung dari contoh lengkap.

Instal Conholdate.Total for Java via Maven

Tambahkan repositori Maven Conholdate dan dependensi SDK ke pom.xml Anda:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Muat File Excel dengan Dukungan Grafik dan Rumus

Buat instance ExcelLoadOptions, aktifkan pemuatan diagram dan rumus, serta inisialisasi objek Conversion dengan aliran file:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

Konfigurasikan Opsi Output Gambar untuk PNG

Atur format gambar, kualitas, dan dimensi yang diinginkan. Lebar tetap tetap sementara tinggi mempertahankan rasio aspek:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Mengonversi Setiap Lembar Kerja atau Rentang menjadi Gambar PNG

Iterasi halaman workbook (lembar) dan konversi masing‑masing. Anda juga dapat menargetkan rentang tertentu dengan menyesuaikan pageNumber atau menggunakan opsi pemuatan tambahan:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Verifikasi Output dan Tangani Pengecualian

Bungkus logika konversi dalam blok try‑catch dan pastikan direktori output ada sebelum memulai:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

Langkah-langkah di atas menunjukkan cara mengonversi Excel menjadi gambar menggunakan Conholdate.Total SDK sambil memberi Anda fleksibilitas untuk menangani diagram, rentang, dan lembar kerja lengkap.

Contoh Kode Lengkap: Mengonversi Excel ke Gambar dengan Dukungan Seluruh Lembar

Kode berikut menunjukkan implementasi lengkap yang siap dijalankan seperti yang dijelaskan pada langkah‑langkah di atas.

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.xlsx, output_images) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Kesimpulan

Mengonversi Excel ke gambar di Java menjadi mudah ketika Anda memanfaatkan Conholdate.Total for Java. SDK menangani rendering grafik, evaluasi formula, dan output PNG berkualitas tinggi dengan kode minimal. Dengan mengikuti panduan langkah demi langkah, Anda dapat mengintegrasikan kemampuan ini ke dalam alat pelaporan, generator email, atau aplikasi apa pun yang membutuhkan representasi visual spreadsheet. Ingat bahwa penerapan produksi memerlukan lisensi komersial; Anda dapat menjelajahi opsi harga di halaman Conholdate.Total pricing dan memperoleh lisensi sementara dari temporary license page saat melakukan evaluasi.

FAQs

  • Bagaimana cara mengonversi Excel menjadi gambar di Java?
    Gunakan kelas Conversion dari Conholdate.Total for Java, konfigurasikan ExcelLoadOptions dan ImageConvertOptions, lalu panggil convert untuk setiap lembar kerja.

  • Bisakah saya mengonversi diagram Excel menjadi gambar?
    Ya. Aktifkan pemuatan diagram dengan loadOptions.setLoadCharts(true) dan tentukan nomor halaman diagram saat mengatur imgOptions.setPageNumber.

  • Apakah memungkinkan untuk mengonversi hanya rentang sel tertentu?
    Anda dapat menentukan rentang dalam opsi pemuatan atau memilih nomor halaman yang sesuai yang berhubungan dengan rentang yang diinginkan sebelum konversi.

  • Lisensi apa yang diperlukan untuk penggunaan produksi?
    Lisensi komersial diperlukan. Tinjau biaya pada halaman Harga Conholdate.Total dan dapatkan lisensi sementara dari halaman lisensi sementara.

Baca Selengkapnya