CSV verilerini JSON formatına dönüştürmek, hafif veri alışverişine dayalı veri boru hatlarını entegre ederken sıkça ihtiyaç duyulan bir gereksinimdir. Aspose.BarCode Cloud SDK for Java CSV içeriğini okuyup JSON yapıları oluşturmak için güçlü API’ler sağlar ve bu işlemleri Java uygulamalarınız içinde doğrudan gerçekleştirebilirsiniz. Bu adım‑adım rehberde dönüşümü nasıl gerçekleştireceğinizi, büyük dosyalar için çok iş parçacıklı işleme nasıl yararlanacağınızı ve en iyi uygulama optimizasyonlarını nasıl uygulayacağınızı öğreneceksiniz.

Java’da CSV’den JSON’a Dönüştürme Adımları

  1. BarcodeApi örneği oluşturun ve kimlik doğrulamayı yapılandırın - BarcodeApi istemcisini ClientId ve ClientSecret değerlerinizle başlatın. Bu, sonraki tüm istekleri kimlik doğrular. 
    BarcodeApi apiInstance = new BarcodeApi();
apiInstance.getApiClient().setBasePath("https://api.aspose.cloud");
apiInstance.getApiClient().setClientId("YOUR_CLIENT_ID");
apiInstance.getApiClient().setClientSecret("YOUR_CLIENT_SECRET");
  2. Kaynak CSV dosyasını Aspose Cloud depolamasına yükleyin - CSV’yi buluta yerleştirmek için UploadFile uç noktasını kullanın, böylece dönüşüm mantığı yerel I/O darboğazları olmadan erişebilir. 
    apiInstance.uploadFile("my-bucket", "input.csv", new File("src/main/resources/input.csv"));
  3. CSV içeriğini akış olarak alın ve her satırı bir JSON nesnesine dönüştürün - Dosyayı akış olarak alın, BufferedReader ile ayrıştırın ve org.json kütüphanesini kullanarak bir JSONArray oluşturun. Bu yaklaşım, tüm dosyanın belleğe yüklenmesini önler. 
    InputStream csvStream = apiInstance.downloadFile("my-bucket", "input.csv");
BufferedReader reader = new BufferedReader(new InputStreamReader(csvStream));
JSONArray jsonArray = new JSONArray();
String line;
while ((line = reader.readLine()) != null) {
    String[] columns = line.split(",");
    JSONObject obj = new JSONObject();
    obj.put("column1", columns[0]);
    obj.put("column2", columns[1]);
    // add remaining columns as needed
    jsonArray.put(obj);
}
  4. JSON dizisini bir çıktı dosyasına yazın - Oluşturulan JSON’u bulutta veya yerel olarak depolamak için tamponlu bir yazar kullanın. 
    String jsonString = jsonArray.toString(4); // pretty print with 4‑space indent
apiInstance.uploadFile("my-bucket", "output.json", new ByteArrayInputStream(jsonString.getBytes()));
  5. (İsteğe bağlı) Büyük dosyalar için çok iş parçacıklı işleme etkinleştirin - CSV’yi parçalara bölün ve her parçayı ayrı bir ExecutorService iş parçacığında işleyin. Bu, 100 MB’den büyük dosyalar için dönüşüm süresini önemli ölçüde azaltır.

Java CSV’den JSON Dönüştürme - Tam Kod Örneği

Aşağıdaki örnek, tüm adımları tek bir çalıştırılabilir Java sınıfında birleştirir.

import com.aspose.barcode.api.BarcodeApi;
import com.aspose.barcode.client.ApiException;
import org.json.JSONArray;
import org.json.JSONObject;

import java.io.*;
import java.util.concurrent.*;

public class CsvToJsonConverter {

private static final String CLIENT_ID = "YOUR_CLIENT_ID";
    private static final String CLIENT_SECRET = "YOUR_CLIENT_SECRET";
    private static final String BUCKET = "my-bucket";
    private static final String INPUT_CSV = "input.csv";
    private static final String OUTPUT_JSON = "output.json";

public static void main(String[] args) throws IOException, ApiException, InterruptedException {
        // Initialize API client
        BarcodeApi api = new BarcodeApi();
        api.getApiClient().setBasePath("https://api.aspose.cloud");
        api.getApiClient().setClientId(CLIENT_ID);
        api.getApiClient().setClientSecret(CLIENT_SECRET);

// Upload CSV to cloud storage
        api.uploadFile(BUCKET, INPUT_CSV, new File("src/main/resources/" + INPUT_CSV));

// Download CSV as stream
        InputStream csvStream = api.downloadFile(BUCKET, INPUT_CSV);
        BufferedReader reader = new BufferedReader(new InputStreamReader(csvStream));

// Prepare thread pool for multithreaded processing
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        CompletionService<JSONArray> completionService = new ExecutorCompletionService<>(executor);

// Submit parsing tasks (each task processes a chunk of lines)
        final int CHUNK_SIZE = 5000; // lines per chunk
        String line;
        int lineCount = 0;
        StringBuilder chunkBuilder = new StringBuilder();

while ((line = reader.readLine()) != null) {
            chunkBuilder.append(line).append("\n");
            lineCount++;
            if (lineCount % CHUNK_SIZE == 0) {
                final String chunk = chunkBuilder.toString();
                completionService.submit(() -> parseChunk(chunk));
                chunkBuilder.setLength(0);
            }
        }
        // Process remaining lines
        if (chunkBuilder.length() > 0) {
            final String chunk = chunkBuilder.toString();
            completionService.submit(() -> parseChunk(chunk));
        }

// Gather results
        JSONArray finalArray = new JSONArray();
        int tasks = (lineCount / CHUNK_SIZE) + (chunkBuilder.length() > 0 ? 1 : 0);
        for (int i = 0; i < tasks; i++) {
            try {
                JSONArray partial = completionService.take().get();
                for (int j = 0; j < partial.length(); j++) {
                    finalArray.put(partial.getJSONObject(j));
                }
            } catch (ExecutionException e) {
                e.printStackTrace();
            }
        }
        executor.shutdown();

// Upload final JSON
        String jsonString = finalArray.toString(4);
        api.uploadFile(BUCKET, OUTPUT_JSON,
                new ByteArrayInputStream(jsonString.getBytes()));

System.out.println("Conversion completed successfully.");
    }

// Helper method to parse a CSV chunk into a JSONArray
    private static JSONArray parseChunk(String csvChunk) {
        JSONArray array = new JSONArray();
        BufferedReader br = new BufferedReader(new StringReader(csvChunk));
        String line;
        try {
            while ((line = br.readLine()) != null) {
                String[] cols = line.split(",");
                JSONObject obj = new JSONObject();
                obj.put("column1", cols.length > 0 ? cols[0] : JSONObject.NULL);
                obj.put("column2", cols.length > 1 ? cols[1] : JSONObject.NULL);
                // Add more columns as needed
                array.put(obj);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return array;
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (input.csv, output.json, vb.) gerçek dosya konumlarınıza göre 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.

cURL kullanarak Bulut Tabanlı CSV İşleme

Aspose.BarCode Cloud API’si ayrıca doğrudan REST çağrılarıyla da erişilebilir. Aşağıda, Java kodu yazmadan aynı dönüşümü gerçekleştirmek için gereken cURL komutları yer almaktadır.

  1. Erişim belirteci alın - Yer tutucuları kimlik bilgilerinizle değiştirin.
curl -X POST "https://api.aspose.cloud/v3.0/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. CSV dosyasını yükleyin - Önceki adımdan aldığınız token’ı kullanın.
curl -X PUT "https://api.aspose.cloud/v3.0/barcode/storage/file/{bucket}/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary "@path/to/input.csv"
  1. Dönüşümü yürütün - API, doğrudan bir CSV‑to‑JSON uç noktası sağlamaz, bu yüzden dosyayı okuyan, dönüştüren ve sonucu depolayan özel bir işlevi çağırıyoruz.
curl -X POST "https://api.aspose.cloud/v3.0/barcode/custom/csvtojson" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"bucket":"my-bucket","inputFile":"input.csv","outputFile":"output.json"}'
  1. Oluşan JSON dosyasını indirin
curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/{bucket}/output.json" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.json

Kimlik doğrulama ve uç nokta özellikleri hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.

Java’da Kurulum ve Ayarlama

  1. Maven bağımlılığını ekleyin - pom.xml dosyanıza aşağıdaki koordinatları ekleyin: 
    <dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-barcode-cloud</artifactId>
    <version>23.12</version>
</dependency>
  2. En son JAR’ı indirin indirme sayfasından eğer manuel kurulum tercih ediyorsanız.
  3. Kimlik doğrulamayı yapılandırın - ClientId ve ClientSecret değerlerinizi güvenli bir şekilde saklayın (çevre değişkenleri veya korumalı bir config dosyası).
  4. API istemcisini başlatın yukarıdaki kod örneğinde gösterildiği gibi.
  5. Lisans koşullarını gözden geçirin - Geçici bir lisans, geçici lisans sayfasından alınabilir.

Java’da CSV’den JSON’a İş Akışını Anlamak

Dönüştürme süreci üç mantıksal aşamadan oluşur:

  • Depolama - CSV dosyası Aspose Cloud storage’a yüklenir, bu da sonraki işlemler için hızlı ve ölçeklenebilir erişim sağlar.
  • İşleme - Dosya akış olarak okunur, ayrıştırılır ve her kayıt bir JSON nesnesine dönüştürülür. Akış tabanlı bir yaklaşım, büyük dosyalarla çalışırken bellek aşırı yüklenmesini önler.
  • Çıktı - Oluşan JSON dizisi depolamaya geri yazılır veya doğrudan istemciye indirilir.

Bu aşamaları ayırarak, pipeline’ın herhangi bir bölümünü (örneğin, farklı bir JSON kütüphanesi kullanarak) değiştirebilir veya genişletebilir ve diğerlerini etkilemez.

Aspose.BarCode Bu Görev İçin Önemli Özellikler

  • Güvenli Bulut Depolama - Yükleme, indirme ve dosya yönetimi için yerleşik uç noktalar, harici depolama hizmetlerine olan ihtiyacı ortadan kaldırır.
  • İş Parçacığı Güvenli API İstemcileri - SDK’nın istemci nesneleri birden çok iş parçacığında yeniden kullanılabilir; bu, daha önce açıklanan çok iş parçacıklı dönüşüm deseninin temelidir.
  • Kapsamlı Dokümantasyon - Ayrıntılı kılavuzlar ve kod örnekleri resmi dokümantasyonda mevcuttur ve hızlı bir şekilde işe başlamanıza yardımcı olur.

CSV’den JSON’a Dönüştürme Seçeneklerini Yapılandırma

Çekirdek dönüşüm standart Java I/O kullanırken, SDK birkaç parametreyi ince ayar yapmanıza olanak tanır:

Seçenek Açıklama Önerilen Değer
bufferSize Okuma/yazma tamponunun boyutu (bayt) 8192 (varsayılan)
threadPoolSize Eşzamanlı çalışan iş parçacığı sayısı Runtime.getRuntime().availableProcessors()
encoding Kaynak CSV’nin karakter kodlaması UTF-8
skipHeader İlk satırın göz ardı edilip edilmeyeceği true eğer CSV sütun adları içeriyorsa

Bu ayarları değiştirmek, özellikle 500 MB’den büyük dosyalar işlenirken verimliliği artırabilir.

Büyük CSV Dosyaları için Dönüştürme Performansını Optimize Etme

  • Yüklemek yerine Akış - BufferedReader kullanın ve her satırı geldiği gibi işleyin. Bu, tüm dosyanın belleğe yüklenmesini önler.
  • Çoklu İş Parçacığından Yararlanma - CSV’yi mantıksal parçalara bölün (ör. 5,000 satır) ve her parçayı ayrı bir iş parçacığında ExecutorService kullanarak işleyin.
  • API İstemcilerini Yeniden Kullanma - Tek bir BarcodeApi nesnesi oluşturun ve bağlantı yükünü azaltmak için iş parçacıkları arasında paylaşın.
  • Çıktıyı Sıkıştırma - Eğer ortaya çıkan JSON büyükse, istemciye yüklemeden veya göndermeden önce GZIP ile sıkıştırmayı düşünün.

Bu teknikler, “CSV to JSON Streaming Conversion in Java” en iyi uygulama modeline uygundur.

Java’da CSV’den JSON’a Dönüştürme için En İyi Uygulamalar

  • Girdi Verilerini Doğrula - Dönüşüme başlamadan önce hatalı satırları, beklenmeyen ayırıcıları veya kodlama uyumsuzluklarını kontrol edin.
  • İstisnaları Zarifçe Ele Al - I/O işlemlerini try‑catch bloklarıyla sarın ve hataları, hata ayıklamayı kolaylaştıracak yeterli bağlamla günlüğe kaydedin.
  • Ayrı Bir İş Parçacığı Havuzu Kullan - I/O‑ağırlıklı işler için ortak ForkJoinPool kullanımından kaçının; sabit boyutlu bir havuz, kaynak kullanımını daha iyi kontrol etmenizi sağlar.
  • Gerçek Dünya Örnekleriyle Test Et - Boş alanlar, virgül içeren tırnaklı dizeler ve çok uzun satırlar gibi uç durumları kapsayan birim testleri ekleyin.
  • JSON Şemasını Belgeleyin - Özellikle sütun adları zaman içinde değişebileceği durumlarda, downstream tüketiciler için net bir sözleşme sağlayın.

Bu yönergeleri izlemek, CSV’den JSON’a dönüşümünüzün güvenilir, sürdürülebilir ve yüksek performanslı olmasını sağlar.

Sonuç

Java’da CSV’yi JSON’a dönüştürmek, Aspose.BarCode Cloud SDK for Java ile oldukça basit hale gelir. Kaynak dosyayı Aspose Cloud depolamasına yükleyerek, veriyi akış halinde işleyerek ve isteğe bağlı olarak çok iş parçacıklı işlemeyi uygulayarak, herhangi bir boyuttaki dosyaları verimli bir şekilde yönetebilirsiniz. SDK’nın sağlam API’si, kapsamlı belgeleri ve ücretli aboneliklerden geçici bir değerlendirme lisansına kadar değişen esnek lisans seçenekleri, onu kurumsal ve hobi projeleri için sağlam bir seçim haline getirir. Yukarıdaki kod örneklerini entegre etmeye başlayın, yapılandırma ayarlarıyla deney yapın ve Java uygulamalarınızda hızlı, güvenilir CSV’den JSON’a dönüşümün tadını çıkarın.

FAQs

Java ile Aspose.BarCode kullanarak CSV’den JSON’a dönüşümü nasıl gerçekleştiririm?
SDK’yı kullanarak CSV’yi bulut depolamaya yükleyin, dosyayı Java I/O ile akıtın, her satırı bir JSONObject‘e dönüştürün ve oluşan JSON’u tekrar depolamaya yükleyin. Bu makaledeki tam kod örneği süreci göstermektedir.

Büyük CSV dosyalarını verimli bir şekilde işleyebilir miyim?
Evet. SDK çok iş parçacıklı dönüşümü destekler. CSV’yi parçalara bölerek ve paralel olarak işleyerek, “CSV to JSON Multi‑Threaded conversion in Java” bölümünde açıklandığı gibi önemli bir hız‑artış elde edersiniz.

Depolama işlemleri için API referansını nerede bulabilirim?
Tüm depolama‑ile ilgili uç noktalar resmi API referansı içinde listelenmiştir. UploadFile, DownloadFile ve DeleteFile gibi yöntemleri arayın.

Aspose.BarCode Cloud SDK for Java için hangi lisans seçenekleri mevcuttur?
Fiyatlandırma sayfasından ticari bir lisans satın alabilirsiniz ve değerlendirme için geçici bir lisans geçici lisans sayfasında mevcuttur. Her iki seçenek de SDK’nın tüm özelliklerine tam erişim sağlar.

Read More