Mengonversi spreadsheet Excel ke JSON merupakan kebutuhan yang sering muncul saat membangun pipeline pertukaran data atau memberi makan API. Conholdate.Total for Java adalah SDK yang kuat yang menyederhanakan tugas ini bagi pengembang Java. Dalam panduan ini Anda akan belajar cara menyiapkan pustaka, menjalani implementasi lengkap, dan menyesuaikan opsi konversi agar sesuai dengan kebutuhan proyek Anda.

Prasyarat dan Penyiapan untuk Conholdate.Total for Java

Sebelum Anda memulai, pastikan Anda memiliki:

  • Java 17 atau yang lebih baru terpasang.
  • Maven 3.6+ untuk manajemen dependensi.
  • File Excel (.xlsx) yang ingin Anda konversi.

Tambahkan repositori Maven Conholdate.Total dan dependensinya 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>

Anda juga dapat mengunduh JAR terbaru secara langsung dari halaman unduhan. Dengan SDK yang sudah terpasang, Anda siap memulai konversi excel ke JSON di Java.

Konversi Excel ke JSON dalam Java: Panduan Langkah-demi-Langkah

Langkah 1: Muat Dokumen Excel Sumber

Pertama, tentukan jalur ke file XLSX sumber dan buat sebuah instance Conversion. Blok try‑with‑resources memastikan objek konversi dibuang dengan benar.

String inputFile = "sample.xlsx";
try (Conversion conversion = new Conversion(inputFile)) {
    // conversion object ready
}

Langkah 2: Konfigurasikan Opsi Konversi JSON

Buat objek JsonConvertOptions dan sesuaikan pengaturan seperti pretty‑print, penyertaan header, format tanggal dan angka khusus, serta ukuran batch. Opsi‑opsi ini mengontrol bagaimana konversi excel ke JSON dalam Java membentuk output akhir.

JsonConvertOptions jsonOptions = new JsonConvertOptions();
jsonOptions.setPrettyPrint(true);
jsonOptions.setIncludeHeaders(true);
jsonOptions.setDateFormat(JsonConvertOptions.DateFormat.CUSTOM);
jsonOptions.setCustomDateFormat("yyyy-MM-dd");
jsonOptions.setNumberFormat(JsonConvertOptions.NumberFormat.CUSTOM);
jsonOptions.setCustomNumberFormat("#.##");
jsonOptions.setRowsPerBatch(5000);

Langkah 3: Jalankan Konversi

Berikan nama file JSON target dan panggil metode convert. SDK menangani transformasi secara internal.

String outputFile = "sample.json";
conversion.convert(outputFile, jsonOptions);

Langkah 4: Tangani Hasil dan Pembersihan

Setelah konversi, keluarkan pesan konfirmasi. Setiap pengecualian ditangkap dan dicetak ke konsol.

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
} catch (Exception e) {
    System.err.println("Error during Excel to JSON conversion:");
    e.printStackTrace();
}

Dengan langkah‑langkah ini, konversi Excel ke JSON dalam Java selesai, dan Anda dapat mengintegrasikan JSON yang dihasilkan ke dalam API atau alur kerja pemrosesan data Anda.

Implementasi Lengkap: Konversi Excel ke JSON dengan Java

Contoh berikut menunjukkan cara melakukan konversi excel ke JSON dalam Java menggunakan Conholdate.Total for Java.

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.convert.JsonConvertOptions;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.DateFormat;
import com.groupdocs.conversion.options.convert.JsonConvertOptions.NumberFormat;

public class ExcelToJsonDemo {
    public static void main(String[] args) {
        // Input Excel file (generic path)
        String inputFile = "sample.xlsx";
        // Desired JSON output file
        String outputFile = "sample.json";

// Perform conversion inside try‑with‑resources to ensure proper cleanup
        try (Conversion conversion = new Conversion(inputFile)) {

// Configure JSON conversion options
            JsonConvertOptions jsonOptions = new JsonConvertOptions();

// Pretty‑print the JSON for readability
            jsonOptions.setPrettyPrint(true);

// Include column headers as JSON property names
            jsonOptions.setIncludeHeaders(true);

// Define how dates and numbers should be formatted in the JSON output
            jsonOptions.setDateFormat(DateFormat.CUSTOM);
            jsonOptions.setCustomDateFormat("yyyy-MM-dd");
            jsonOptions.setNumberFormat(NumberFormat.CUSTOM);
            jsonOptions.setCustomNumberFormat("#.##");

// Optional performance tweak: limit rows processed per batch (useful for very large sheets)
            jsonOptions.setRowsPerBatch(5000);

// Execute the conversion
            conversion.convert(outputFile, jsonOptions);

System.out.println("Conversion completed successfully. JSON saved to: " + outputFile);
        } catch (Exception e) {
            // Basic error handling – in production code you might want more sophisticated logging
            System.err.println("Error during Excel to JSON conversion:");
            e.printStackTrace();
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsionalitas inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan 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.

Opsi Konversi dan Pengaturan

SDK menawarkan beberapa opsi untuk menyesuaikan output JSON:

  • Pretty Print - Meningkatkan keterbacaan dengan menambahkan indentasi.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Menggunakan baris pertama worksheet sebagai nama properti.
    setIncludeHeaders(true) (lihat referensi API).
  • Custom Date Format - Menentukan pola tanggal, misalnya "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Mengontrol presisi numerik, misalnya "#.##".
    setCustomNumberFormat("#.##").

Menyesuaikan pengaturan ini memungkinkan Anda menyelaraskan JSON yang dihasilkan dengan harapan layanan hilir atau basis data.

Kesimpulan

Anda sekarang memiliki konversi excel ke JSON yang berfungsi dalam implementasi Java yang didukung oleh Conholdate.Total for Java. SDK menangani pekerjaan berat, sementara opsi yang dapat dikonfigurasi memberi Anda kontrol atas format dan kinerja. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; Anda dapat meminta halaman lisensi sementara untuk mengevaluasi perpustakaan atau meninjau halaman harga lengkap untuk syarat komersial. Selamat coding!

FAQs

  • Bagaimana cara melakukan konversi excel ke JSON di Java dengan Conholdate.Total?
    Gunakan kelas Conversion bersama dengan JsonConvertOptions seperti yang ditunjukkan dalam contoh kode. SDK mengabstraksi penanganan file dan menyediakan satu panggilan convert.

  • Apakah saya dapat menyesuaikan format tanggal dan angka selama konversi excel ke JSON di Java?
    Ya. Metode setCustomDateFormat dan setCustomNumberFormat memungkinkan Anda mendefinisikan pola yang sesuai dengan harapan sistem target Anda.

  • Opsi lisensi apa yang tersedia untuk Conholdate.Total for Java?
    Anda dapat memperoleh lisensi evaluasi sementara dari halaman lisensi sementara atau membeli lisensi penuh melalui halaman harga.

  • Apakah pemrosesan batch didukung untuk file Excel besar?
    Opsi setRowsPerBatch memungkinkan Anda memproses lembar kerja dalam potongan, yang ideal untuk skenario konversi batch.

Baca Selengkapnya