Excel elektronik tablolarını JSON formatına dönüştürmek, veri‑değişim hatları oluştururken veya API’lere veri beslerken sık karşılaşılan bir gereksinimdir. Conholdate.Total for Java Java geliştiricileri için bu görevi basitleştiren güçlü bir SDK’dır. Bu rehberde kütüphaneyi nasıl kuracağınızı, tam bir uygulamayı adım adım nasıl gerçekleştireceğinizi ve projenizin ihtiyaçlarına uygun olacak şekilde dönüşüm seçeneklerini nasıl ince ayar yapacağınızı öğreneceksiniz.

Conholdate.Total for Java için Gereksinimler ve Kurulum

Başlamadan önce, şunların olduğundan emin olun:

  • Java 17 veya daha yeni bir sürüm yüklü.
  • Bağımlılık yönetimi için Maven 3.6+.
  • Dönüştürmek istediğiniz bir Excel dosyası (.xlsx).

Conholdate.Total Maven deposunu ve bağımlılığını pom.xml dosyanıza ekleyin:

<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>

En son JAR dosyalarını doğrudan indirme sayfasından da indirebilirsiniz. SDK kurulu olduğunda, Java’da Excel’den JSON’a dönüşümüne başlamaya hazırsınız.

Java’da Excel’ten JSON Dönüştürme: Adım Adım Rehber

Adım 1: Kaynak Excel Belgesini Yükleyin

İlk olarak, kaynak XLSX dosyasının yolunu belirtin ve bir Conversion örneği oluşturun. try‑with‑resources bloğu, dönüşüm nesnesinin doğru şekilde dispose edilmesini sağlar.

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

Adım 2: JSON Dönüştürme Seçeneklerini Yapılandırın

Bir JsonConvertOptions nesnesi oluşturun ve güzel‑yazdırma, başlık ekleme, özel tarih ve sayı biçimleri ve toplu iş boyutu gibi ayarları düzenleyin. Bu seçenekler, Java’da excel’den JSON’a dönüşümün nihai çıktısını nasıl şekillendirdiğini kontrol eder.

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

Adım 3: Dönüşümü Gerçekleştir

Hedef JSON dosya adını sağlayın ve convert metodunu çağırın. SDK dönüşümü dahili olarak yönetir.

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

Adım 4: Sonucu İşleyin ve Temizleyin

Dönüştürme işleminden sonra bir onay mesajı görüntülenir. Herhangi bir istisna yakalanır ve konsola yazdırılır.

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

Bu adımlarla, Java’da Excel’ten JSON’a dönüşüm tamamlanır ve oluşturulan JSON’u API’nize veya veri işleme akışınıza entegre edebilirsiniz.

Tam Uygulama: Java Excel’den JSON’a Dönüştürme

Aşağıdaki örnek, Java’da Conholdate.Total for Java kullanarak excel’den JSON dönüşümünün nasıl yapılacağını gösterir.

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

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Dönüştürme Seçenekleri ve Ayarlar

SDK, JSON çıktısını özelleştirmek için çeşitli seçenekler sunar:

  • Pretty Print - Okunabilirliği artırmak için girintileme ekler.
    jsonOptions.setPrettyPrint(true);
  • Include Headers - Çalışma sayfasının ilk satırını özellik adları olarak kullanır.
    setIncludeHeaders(true) (bkz. API reference).
  • Custom Date Format - Bir tarih deseni tanımlayın, örn., "yyyy-MM-dd".
    setCustomDateFormat("yyyy-MM-dd").
  • Custom Number Format - Sayısal hassasiyeti kontrol edin, örn., "#.##".
    setCustomNumberFormat("#.##").

Bu ayarları değiştirerek, oluşturulan JSON’u aşağı akış hizmetlerinin veya veritabanlarının beklentileriyle hizalayabilirsiniz.

Sonuç

Artık Java uygulamasında çalışan bir Excel’ten JSON’a dönüşümüne sahipsiniz ve bu, Conholdate.Total for Java tarafından desteklenmektedir. SDK, zor işleri hallederken, yapılandırılabilir seçenekler biçimlendirme ve performans üzerinde kontrol sağlar. Üretim kullanımı için uygun bir lisans almayı unutmayın; kütüphaneyi değerlendirmek için bir geçici lisans sayfası talep edebilir veya ticari koşullar için tam fiyatlandırma sayfasını inceleyebilirsiniz. İyi kodlamalar!

Sık Sorulan Sorular

  • Conholdate.Total ile Java’da Excel’i JSON’a dönüştürme nasıl yapılır?
    Kod örneğinde gösterildiği gibi Conversion sınıfını JsonConvertOptions ile birlikte kullanın. SDK, dosya işlemlerini soyutlar ve tek bir convert çağrısı sağlar.

  • Excel’den JSON’a dönüşüm sırasında tarih ve sayı formatlarını özelleştirebilir miyim?
    Evet. setCustomDateFormat ve setCustomNumberFormat yöntemleri, hedef sisteminizin beklentilerine uyan desenleri tanımlamanıza olanak tanır.

  • Conholdate.Total for Java için hangi lisans seçenekleri mevcuttur?
    Geçici bir değerlendirme lisansını geçici lisans sayfasından alabilir veya tam lisansı fiyatlandırma sayfası üzerinden satın alabilirsiniz.

  • Büyük Excel dosyaları için toplu işleme destekleniyor mu?
    setRowsPerBatch seçeneği, çalışma sayfalarını parçalar halinde işlemenizi sağlar; bu, toplu dönüştürme senaryoları için idealdir.

Daha Fazla Oku