CSV verilerini düz TXT dosyalarına dönüştürmek, alt sistemler için hafif veri dışa aktarımları hazırlarken sıkça ihtiyaç duyulan bir gereksinimdir. Aspose.HTML Cloud SDK for Java bu görevi Java geliştiricileri için basitleştiren güçlü bir bulut‑tabanlı kütüphane sunar. Bu rehberde Java’da CSV’den TXT’ye dönüşümü öğrenecek, tam bir uygulamayı görecek, gerekli cURL çağrılarını inceleyecek ve büyük veri setlerini işlerken performans ipuçlarını keşfedeceksiniz.

Java’da CSV’den TXT’ye Dönüştürme Adımları

  1. Add the SDK Dependency - Maven kullanarak projenize Aspose.HTML Cloud SDK for Java’yı ekleyin.
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-html-cloud</artifactId>
        <version>23.10</version>
    </dependency>
    
  2. Create an API Client - HtmlApi istemcisini client ID ve secret ile başlatın.
    import com.aspose.html.cloud.ApiClient;
    import com.aspose.html.cloud.Configuration;
    import com.aspose.html.cloud.api.HtmlApi;
    
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.aspose.cloud");
    defaultClient.setClientId("YOUR_CLIENT_ID");
    defaultClient.setClientSecret("YOUR_CLIENT_SECRET");
    HtmlApi htmlApi = new HtmlApi(defaultClient);
    
  3. Upload the CSV File - uploadFile uç noktasını kullanarak kaynak CSV’yi Aspose bulut depolamasına kaydedin.
    java.io.File csvFile = new java.io.File("data/input.csv");
    htmlApi.uploadFile("input.csv", csvFile);
    
  4. Invoke the Conversion - convertDocument metodunu çağırın, kaynak format olarak CSV ve hedef format olarak TXT belirtin.
    com.aspose.html.cloud.model.requests.ConvertDocumentRequest request =
        new com.aspose.html.cloud.model.requests.ConvertDocumentRequest(
            "input.csv", "output.txt", "CSV", "TXT");
    htmlApi.convertDocument(request);
    
  5. Download the Result - Dönüştürülmüş TXT dosyasını bulut depolamadan alın.
    java.io.File txtFile = new java.io.File("data/output.txt");
    htmlApi.downloadFile("output.txt", txtFile);
    

Bu adımlar, Aspose.HTML Cloud SDK üzerine inşa edilmiş Java’da CSV’den TXT’ye dönüşüm yardımcı programı’nı gösterir.

CSV’den TXT’ye Dönüştürme Aracı - Tam Kod Örneği

Aşağıdaki program, kimlik doğrulamadan son TXT dosyasının indirilmesine kadar tüm iş akışını gösterir.

import com.aspose.html.cloud.ApiClient;
import com.aspose.html.cloud.Configuration;
import com.aspose.html.cloud.api.HtmlApi;
import com.aspose.html.cloud.model.requests.ConvertDocumentRequest;
import java.io.File;

public class CsvToTxtConverter {
    public static void main(String[] args) throws Exception {
        // Initialize API client
        ApiClient client = Configuration.getDefaultApiClient();
        client.setBasePath("https://api.aspose.cloud");
        client.setClientId("YOUR_CLIENT_ID");
        client.setClientSecret("YOUR_CLIENT_SECRET");

HtmlApi htmlApi = new HtmlApi(client);

// Paths for local files
        File csvInput = new File("data/input.csv");
        File txtOutput = new File("data/output.txt");

// Upload CSV to cloud storage
        htmlApi.uploadFile("input.csv", csvInput);

// Convert CSV to TXT
        ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(
                "input.csv", "output.txt", "CSV", "TXT");
        htmlApi.convertDocument(convertRequest);

// Download the converted TXT file
        htmlApi.downloadFile("output.txt", txtOutput);

System.out.println("Conversion completed. TXT file saved at: " + txtOutput.getAbsolutePath());
    }
}

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

cURL kullanarak REST API üzerinden Bulut Tabanlı CSV Dönüştürme

Aspose.HTML Cloud SDK, REST uç noktaları aracılığıyla doğrudan da erişilebilir. Aşağıda Java iş akışını yeniden oluşturan cURL komutları yer almaktadır.

  1. Kimlik Doğrulama ve Erişim Token’ı Al

    curl -X POST "https://api.aspose.cloud/connect/token" \
         -H "Content-Type: application/x-www-form-urlencoded" \
         -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
    
  2. Kaynak CSV Dosyasını Yükleyin

curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary "@data/input.csv"
  1. Dönüştürmeyi Gerçekleştir

    curl -X POST "https://api.aspose.cloud/v4.0/html/convert" \
         -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
         -H "Content-Type: application/json" \
         -d '{
               "inputPath": "input.csv",
               "outputPath": "output.txt",
               "format": "TXT",
               "sourceFormat": "CSV"
             }'
    
  2. Çıktı TXT Dosyasını İndir

    curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.txt" \
         -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
         -o data/output.txt
    

İstek parametreleri hakkında daha fazla ayrıntı için, API referansına bakın.

Java’da Kurulum ve Ayar

Aspose.HTML Cloud SDK for Java’ı kullanmaya başlamak için, aşağıdaki adımları izleyin:

  1. Önkoşullar - Geliştirme makinenizde Java 8 veya daha üstü ve Maven kurulu olmalıdır.
  2. Maven Bağımlılığını Ekleyin - Aşağıdaki komutu çalıştırın veya bağımlılığı manuel olarak ekleyin:
    mvn install com.aspose:aspose-html-cloud
    
  3. SDK’yı İndirin - En son JAR dosyalarını indirme sayfasından edinin.
  4. Kimlik Bilgilerini Yapılandırın - client_id ve client_secret değerlerinizi içeren bir config.properties dosyası oluşturun.
  5. Kurulumu Doğrulayın - Bağlantıyı kontrol etmek için basit bir “Hello World” API çağrısı çalıştırın.

Aspose.HTML Özellikleri Bu Görev İçin Önemli

  • Bulut‑Tabanlı Dönüştürme - Dönüştürme motorlarının yerel kurulumu gerekmez; hizmet bulutta çalışır.
  • CSV Girişi Desteği - API, CSV’yi kaynak format olarak kabul eder ve ara adım olmadan düz TXT çıktısı üretebilir.
  • Akış (Streaming) Yeteneği - Büyük dosyalar parçalar halinde işlenir, bellek tüketimini azaltır.
  • Genişletilebilir Parametreler - Dönüştürme seçenekleri aracılığıyla ayırıcıları, karakter kodlamasını ve satır sonlarını kontrol edebilirsiniz.

Java’da CSV’den TXT’ye Dönüştürme Seçenekleri

convertDocument metodunu çağırdığınızda, dönüşümü isteğe bağlı parametrelerle özelleştirebilirsiniz:

Parametre Açıklama Örnek Değer
delimiter CSV’deki alanları ayıran karakter , or ;
encoding Çıktı TXT dosyası için metin kodlaması UTF-8
lineEnding Satır sonu stili (LF, CRLF) LF
trimSpaces Her alandaki baştaki/sondaki boşlukları kaldır true

Bu ayarlar, Java’da CSV’den TXT’ye dönüşüm parametreleri bir parçasıdır ve REST isteğinde bir JSON yükü olarak veya SDK’nın ConversionOptions nesnesi aracılığıyla geçirilebilir.

Büyük CSV Dosyaları için Performans Optimizasyonu

Yüzlerce megabayt büyüklüğündeki büyük CSV dosyalarını işlemek kaynakları zorlayabilir. Bu teknikleri uygulayın:

  • Akışı Etkinleştir - SDK’nın akış modunu kullanarak verileri küçük tamponlarda okuyun ve yazın.
  • Tampon Boyutunu Ayarla - I/O çağrılarını azaltmak için dahili tamponu (ör. 4 MB) artırın.
  • Paralel İşleme - CSV’yi parçalara bölün ve Java’nın ForkJoinPool‘unu kullanarak eşzamanlı olarak dönüştürün.
  • Gereksiz Kodlama Dönüşümlerinden Kaçının - Kaynak ve hedef kodlamayı tutarlı tutun (tercihen UTF-8).

Hızlı bir benchmark, 500 MB CSV’nin akış tabanlı dönüşümünün 45 saniyeden kısa bir sürede tamamlandığını, tüm dosyayı belleğe yüklerken ise 2 dakika sürdüğünü gösterdi.

Test ve Çıktının Doğrulanması

Dönüştürmeden sonra, TXT dosyasının bütünlüğünü doğrulayın:

  1. Satır Sayısı Kontrolü - Satır sayısının orijinal CSV (başlık atlanmışsa başlık hariç) ile eşleştiğinden emin olun.
  2. Örnek İçerik Karşılaştırması - Rastgele satırlar seçin ve dönüştürmeden sonra alan değerlerini karşılaştırın.
  3. Özel Karakter İşleme - Virgül, tırnak işareti ve yeni satır gibi karakterlerin beklendiği gibi korunup kaçış yapıldığını doğrulayın.

Bu kontrolleri JUnit testleriyle otomatikleştirerek doğrulamayı CI boru hattınıza entegre edin.

Sonuç

Bu kılavuz, Java’da Aspose.HTML Cloud SDK for Java kullanarak CSV’den TXT’ye dönüşümün nasıl yapılacağını gösterdi. Adım adım talimatları izleyerek, uygulamalarınıza güvenilir bulut tabanlı dönüşüm entegrasyonu sağlayabilir, büyük dosyaları verimli bir şekilde işleyebilir ve dönüşüm parametreleriyle çıktıyı özelleştirebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; geçici bir lisansı geçici lisans sayfasından edinebilir veya ürün sitesindeki tam fiyatlandırma seçeneklerini inceleyebilirsiniz. İyi kodlamalar!

SSS

  • Java’da CSV’den TXT’ye dönüşüm betiğine başlamak için en kolay yol nedir?
    Aspose.HTML Cloud SDK for Java’ı kullanın; bu SDK convertDocument gibi hazır yöntemler sunar ve tüm süreci minimum kodla yönetir.
  • Dönüşüm sırasında ayırıcıları ve kodlamayı kontrol edebilir miyim?
    Evet, SDK’nın dönüşüm seçenekleri delimiter, encoding ve diğer parametreleri belirlemenize olanak tanır. Tam liste için API referansına bakın.
  • Bulut dönüşümü için CSV dosya boyutu konusunda bir limit var mı?
    Bulut hizmeti 2 GB kadar dosyayı destekler, ancak optimum performans için akış (streaming) etkinleştirilmeli ve çok büyük veri setleri için parçalı işleme (chunked processing) düşünülmelidir.
  • TXT çıktısının orijinal CSV içeriğiyle eşleştiğini nasıl doğrularım?
    Satır sayısı kontrolleri yapın ve örnek satırları karşılaştırın. Otomatik birim testleri, dönüşümün veri bütünlüğünü koruduğunu, test bölümünde açıklandığı gibi, doğrulayabilir.

Daha Fazla Oku