CSV to XLSX dönüşümü Java’da, uygulamaların Excel kullanıcılarıyla veri alışverişi yapması gerektiğinde sıkça ihtiyaç duyulan bir gereksinimdir. Aspose.HTML Cloud SDK for Java bu dönüşümü verimli bir şekilde yöneten güçlü bir bulut‑tabanlı API sağlar. Bu rehberde Maven bağımlılığını nasıl ayarlayacağınızı, akışlarla CSV verisini nasıl okuyacağınızı, bir XLSX çalışma kitabı oluşturmayı ve dönüşümü REST API üzerinden nasıl çağıracağınızı göreceksiniz. Sonunda, kendi projelerinize uyarlayabileceğiniz eksiksiz, üretim‑hazır bir örnek elde edeceksiniz.

Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Java 17 veya daha yeni bir sürüm yüklü.
  • Bir Aspose Cloud hesabı ve istemci kimliği ile istemci gizli anahtarı.
  • Bağımlılık yönetimi için Maven yüklü.

Aspose.HTML Cloud SDK for Java’ı projenize ekleyin:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-html-cloud</artifactId>
    <version>23.12</version>
</dependency>

Alternatif olarak, paketi doğrudan komut satırından kurabilirsiniz:

mvn install com.aspose:aspose-html-cloud

En son SDK ikili dosyalarını indirme sayfasından indirin. Bağımlılık çözüldükten sonra kodlamaya başlayabilirsiniz. Sonraki bölüm, uygulamayı adım adım nasıl yapacağınızı gösterir.

Java’da CSV’den XLSX’e Dönüştürme: Adım Adım Kılavuz

Adım 1: Java Akışlarını Kullanarak Kaynak CSV’yi Yükleyin

CSV’yi satır satır okumak, bellek kullanımını düşük tutar; bu, büyük dosyalar için çok önemlidir.

Path csvPath = Paths.get("input.csv");
List<String> csvLines = Files.readAllLines(csvPath, StandardCharsets.UTF_8);

Adım 2: Aspose.HTML Bulut İstemcisini Başlatın

Kimlik bilgilerinizle bir istemci örneği oluşturun. İstemci sınıfı, API referansı içinde belgelenmiştir.

HtmlApi htmlApi = new HtmlApi();
htmlApi.getConfiguration().setClientId("YOUR_CLIENT_ID");
htmlApi.getConfiguration().setClientSecret("YOUR_CLIENT_SECRET");

Adım 3: CSV İçeriğini XLSX’e Dönüştür

SDK, CSV verilerini bir dize olarak kabul eder ve ikili bir XLSX akışı döndürür.

String csvContent = String.join("\n", csvLines);
ConvertDocumentRequest request = new ConvertDocumentRequest()
        .outputFormat("xlsx")
        .inputFileContent(csvContent.getBytes(StandardCharsets.UTF_8));
byte[] xlsxBytes = htmlApi.convertDocument(request);

Adım 4: Oluşturulan XLSX Dosyasını Kaydedin

Dönen bayt dizisini diskte bir dosyaya yazın.

Path xlsxPath = Paths.get("output.xlsx");
Files.write(xlsxPath, xlsxBytes);

Adım 5: Dönüşümü Doğrula (İsteğe Bağlı)

Oluşturulan dosyayı Apache POI veya herhangi bir elektronik tablo görüntüleyicisi ile hızlıca açarak verilerin doğru biçimlendirildiğinden emin olabilirsiniz.

Tam Kod Örneği: CSV’den XLSX’e Dönüştürme Aspose.HTML Cloud SDK ile

Aşağıdaki program tüm adımları tek bir çalıştırılabilir sınıfa birleştirir.

import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.util.List;
import com.aspose.html.cloud.api.HtmlApi;
import com.aspose.html.cloud.model.ConvertDocumentRequest;

public class CsvToXlsxConverter {
    public static void main(String[] args) throws Exception {
        // 1. Load CSV file
        Path csvPath = Paths.get("input.csv");
        List<String> csvLines = Files.readAllLines(csvPath, StandardCharsets.UTF_8);
        String csvContent = String.join("\n", csvLines);

// 2. Initialise Aspose.HTML Cloud client
        HtmlApi htmlApi = new HtmlApi();
        htmlApi.getConfiguration().setClientId("YOUR_CLIENT_ID");
        htmlApi.getConfiguration().setClientSecret("YOUR_CLIENT_SECRET");

// 3. Convert CSV to XLSX
        ConvertDocumentRequest request = new ConvertDocumentRequest()
                .outputFormat("xlsx")
                .inputFileContent(csvContent.getBytes(StandardCharsets.UTF_8));
        byte[] xlsxBytes = htmlApi.convertDocument(request);

// 4. Save XLSX file
        Path xlsxPath = Paths.get("output.xlsx");
        Files.write(xlsxPath, xlsxBytes);

System.out.println("Conversion completed. XLSX saved to " + xlsxPath.toAbsolutePath());
    }
}

Not: Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (input.csv, output.xlsx) 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 dokümantasyona başvurun veya destek ekibi ile iletişime geçin.

cURL kullanarak Aspose.HTML Cloud’ı XLSX Oluşturma için Çağırma

Aynı dönüşüm REST API’si aracılığıyla gerçekleştirilebilir. Aşağıda gerekli 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"

Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.

  1. CSV Dosyasını Yükle
curl -X POST "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.csv"
  1. Dönüşümü Gerçekleştir
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?outputFormat=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"input.csv"}' \
     -o output.xlsx
  1. XLSX Dosyasını İndir (farklı bir çıktı konumu seçtiyseniz)
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Parametrelerin tam listesi için, resmi API belgelerine bakın.

Büyük CSV’den XLSX Dönüşümlerinde Performans Düşünceleri

  • CSV Girişini Akıtın - Files.lines veya tamponlu bir okuyucu kullanarak satırları tek tek işleyin, tüm dosyayı belleğe yüklemek yerine.
  • Toplu Yüklemeler - 100 MB’den büyük dosyalarla çalışırken CSV’yi daha küçük parçalara bölün ve her parçayı ayrı ayrı dönüştürün, ardından gerekirse oluşan XLSX parçalarını birleştirin.
  • Asenkron Dönüşümü Etkinleştirin - Dönüşüm isteğine async=true sorgu parametresini ekleyerek bulut hizmetinin dosyayı arka planda işlemesini sağlayın, istemci tarafı bekleme süresini azaltın.
  • Çıktı Ayarlarını Ayarlayın - preserveFormatting bayrağını false olarak ayarlayın, eğer tam hücre stillerine ihtiyacınız yoksa; bu, yük veri boyutunu azaltır ve dönüşümü hızlandırır.

Sonuç

Bu kılavuz, Java’da Aspose.HTML Cloud SDK for Java kullanarak CSV’den XLSX’e dönüşümün nasıl yapılacağını gösterdi. Maven’i nasıl yapılandıracağınızı, akışlarla CSV verilerini nasıl okuyacağınızı, bulut API’sını nasıl çağıracağınızı ve büyük dosyaları verimli bir şekilde nasıl yöneteceğinizi öğrendiniz. Üretim kullanımında ticari bir lisansın gerekli olduğunu unutmayın; geçici bir lisansı geçici lisans sayfasından alabilir ve ürün sayfasında tam fiyatlandırma seçeneklerini inceleyebilirsiniz. Bu araçlarla, herhangi bir Java uygulamasına sorunsuz CSV‑to‑XLSX işlevselliği entegre edebilirsiniz.

SSS

  • İçinde tırnak içinde virgül bulunan CSV dosyalarını en iyi nasıl işleyebilirsiniz?
    Dönüştürme API’sine verileri göndermeden önce Apache Commons CSV gibi sağlam bir CSV ayrıştırıcı kullanın. Ayrıştırıcı, tırnak içinde olan ayırıcıları dikkate alır ve doğru satır çıkarımını sağlar.

  • Aspose.HTML Cloud SDK, ara bir HTML adımı olmadan XLSX çıktısını destekliyor mu?
    Evet. convertDocument yöntemi ham CSV içeriğini kabul edebilir ve kod örneklerinde gösterildiği gibi doğrudan bir XLSX dosyası üretebilir.

  • Bulutu kullanmadan dönüşümü yerel olarak çalıştırabilir miyim?
    Aspose.HTML Cloud SDK bir bulut tabanlı hizmettir, bu nedenle bir internet bağlantısı ve geçerli kimlik bilgileri gereklidir. Yerel senaryolar için ayrı bir ürün olan Aspose.Cells’i göz önünde bulundurun.

  • Asenkron bir dönüşüm isteğinin durumunu nasıl izleyebilirim?
    async=true kullanıldığında API bir iş kimliği döndürür. Durumu kontrol etmek için /jobs/{jobId} uç noktasını periyodik olarak sorgulayın, ardından iş tamamlandığında sonucu indirin.

Daha Fazla