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ı
- 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> - Create an API Client -
HtmlApiistemcisini 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); - Upload the CSV File -
uploadFileuç 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); - Invoke the Conversion -
convertDocumentmetodunu çağırın, kaynak format olarakCSVve hedef format olarakTXTbelirtin.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); - 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.
-
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" -
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"
-
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" }' -
Çı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:
- Önkoşullar - Geliştirme makinenizde Java 8 veya daha üstü ve Maven kurulu olmalıdır.
- 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 - SDK’yı İndirin - En son JAR dosyalarını indirme sayfasından edinin.
- Kimlik Bilgilerini Yapılandırın -
client_idveclient_secretdeğerlerinizi içeren birconfig.propertiesdosyası oluşturun. - 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:
- 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.
- Ö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.
- Ö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 SDKconvertDocumentgibi 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çenekleridelimiter,encodingve 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.