Converting HTML raporlarını Excel elektronik tablolarına dönüştürmek, kullanıcıların analizleri veya faturaları indirmesine izin vermesi gereken Java‑tabanlı web uygulamaları için sık bir gereksinimdir. GroupDocs.Conversion Cloud SDK for Java sağlam bir API sunar ve yerel Office kurulumları gerektirmeden format dönüşümünün ağır işini halleder. Bu kılavuzda SDK’yı nasıl kuracağınızı, dönüşüm kodunu nasıl yazacağınızı ve aynı hizmeti cURL ile bir REST arabirimi üzerinden nasıl çağıracağınızı göreceksiniz. Sonunda HTML‑to‑XLSX dönüşümünü bir sunucu, servlet, Spring Boot uygulaması veya herhangi bir çok iş parçacıklı Java hizmetine yerleştirmeye hazır olacaksınız.

Java’da HTML Raporlarını XLSX’e Dışa Aktarma - Gereksinimler

Birçok kurumsal portal, kullanıcıların çevrim dışı analiz için XLSX çalışma kitapları olarak dışa aktarmak istediği dinamik HTML panoları üretir. Tipik gereksinimler şunları içerir:

  • Bulut depolamada saklanan veya an‑anda oluşturulan HTML kaynağına erişim.
  • Dönüştürme sırasında tablo yapılarının, cell stillerinin ve sayısal biçimlerin korunması.
  • Microsoft Office kurmadan, dönüşümü bir arka uç sunucusunda, bir servlet konteynerinde veya bir mikro hizmet içinde çalıştırma yeteneği.

Manuel kopyala‑yapıştır veya istemci‑tarafı kütüphaneler, özellikle büyük raporlarla veya yüksek eşzamanlılık senaryolarıyla (örneğin Java’da bir HTML’den XLSX’e dönüşüm sunucusu) uğraşırken tutarlı biçimlendirmeyi garanti edemez.

GroupDocs.Conversion Cloud SDK for Java’ı Kullanarak Dışa Aktarma İhtiyaçlarını Karşılamak

SDK, giriş olarak HTML ve çıktı olarak XLSX destekleyen bulut tabanlı bir dönüştürme motoru sunar; bu sayede yerel Office bileşenlerine ihtiyaç kalmaz. Gereksinimlerle uyumlu temel yetenekler şunlardır:

  • Bulut işleme - ağır dönüşüm GroupDocs sunucularında çalışır, Java’da bir HTML’den XLSX’e dönüşüm servlet’i veya bir Spring Boot web uygulaması için idealdir.
  • Yapılandırılabilir seçenekler - orijinal biçimlendirmeyi koruyabilir, çalışma sayfası adlarını ayarlayabilir ve XlsxConvertOptions aracılığıyla hücre veri tiplerini kontrol edebilirsiniz.
  • İş parçacığı‑güvenli istemci - Java’da HTML’den XLSX’e dönüşüm çoklu iş parçacığı için uygundur, yüksek verimli toplu işler sağlar.

Daha fazla ayrıntı için resmi belgeler ve API referansı inceleyin.

Java’da HTML’den XLSX’e Dönüştürme: Uygulama

GroupDocs.Conversion Cloud SDK’yı Yükleyin

SDK’yı Maven projenize ekleyin:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion-cloud</artifactId>
    <version>23.12</version>
</dependency>

Veya kurulum komutunu çalıştırın:

mvn install com.groupdocs:groupdocs-conversion-cloud

API İstemcisini Başlat

Kimlik bilgilerinizle bir ApiClient oluşturun ve ConversionApi‘yi örnekleyin.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(apiClient);

Kaynak Dosya Bilgilerini Ayarla

Varsayılan bulut depolama alanında bulunan HTML dosyasını belirtin.

import com.groupdocs.conversion.cloud.model.FileInfo;

FileInfo sourceFile = new FileInfo();
sourceFile.setFilePath("input.html");          // path in the cloud storage
sourceFile.setStorageName("DefaultStorage");   // optional

XLSX Dönüştürme Seçeneklerini Yapılandırın

Orijinal biçimlendirmeyi koruma gibi seçenekleri ayarlayın.

import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
xlsxOptions.setPreserveOriginalFormatting(true);

Dönüşümü Gerçekleştir ve Sonucu Al

İsteği oluşturun, çalıştırın ve çıktı yolunu alın.

import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;

ConvertDocumentRequest request = new ConvertDocumentRequest();
request.setFileInfo(sourceFile);
request.setFormat("xlsx");                     // target format
request.setConvertOptions(xlsxOptions);
request.setOutputPath("output.xlsx");          // desired output path

try {
    ConvertDocumentResponse response = conversionApi.convertDocument(request);
    System.out.println("Conversion successful. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error during conversion: " + e.getMessage());
    e.printStackTrace();
}

HTML Belgelerini XLSX’e Java Kullanarak Dönüştürme - Tam Kod Örneği

Aşağıdaki örnek, tüm parçaları tek bir çalıştırılabilir sınıfta bir araya getirir.

import com.groupdocs.conversion.cloud.ApiClient;
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.model.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertDocumentResponse;
import com.groupdocs.conversion.cloud.model.FileInfo;
import com.groupdocs.conversion.cloud.model.XlsxConvertOptions;

public class HtmlToXlsxConversionExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        ConversionApi conversionApi = new ConversionApi(apiClient);

// Define source HTML file information
        FileInfo sourceFile = new FileInfo();
        sourceFile.setFilePath("input.html");          // path in the cloud storage
        sourceFile.setStorageName("DefaultStorage");   // optional, use default if omitted

// Set conversion options specific to XLSX output
        XlsxConvertOptions xlsxOptions = new XlsxConvertOptions();
        // Example option: preserve original formatting (if needed)
        xlsxOptions.setPreserveOriginalFormatting(true);

// Build conversion request
        ConvertDocumentRequest request = new ConvertDocumentRequest();
        request.setFileInfo(sourceFile);
        request.setFormat("xlsx");                     // target format
        request.setConvertOptions(xlsxOptions);
        request.setOutputPath("output.xlsx");          // desired output path in cloud storage

try {
            // Perform conversion
            ConvertDocumentResponse response = conversionApi.convertDocument(request);
            System.out.println("Conversion successful. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error during conversion: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

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

HTML’den REST ve cURL ile XLSX Dışa Aktarımını Çalıştırma

Java kodu yazmadan doğrudan REST API’yi çağırarak aynı dönüşümü gerçekleştirebilirsiniz. Akış, SDK adımlarını yansıtır: bir token alın, HTML dosyasını yükleyin, dönüşüm isteğinde bulunun ve XLSX sonucunu indirin.

Erişim Token’ını Al

curl -X POST "https://api.groupdocs.cloud/v2.0/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 HTML’yi Yükle

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary @input.html

Dönüştürme İsteği

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": {
               "filePath": "input.html",
               "storageName": "DefaultStorage"
           },
           "outputPath": "output.xlsx",
           "format": "xlsx",
           "convertOptions": {
               "preserveOriginalFormatting": true
           }
         }'

XLSX Sonucunu İndir

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Parametrelerin tam listesi ve ek örnekler için, resmi API belgeleri adresine bakın.

Sonuç

Java’da HTML’den XLSX’e dönüşüm, GroupDocs.Conversion Cloud SDK for Java bulut tabanlı işleme yararlandığınızda oldukça basit hale gelir. SDK, HTML tablolarını ayrıştırma, stilleri işleme ve standartlara uygun bir XLSX dosyası oluşturma karmaşıklıklarını ortadan kaldırır ve sunucu tarafı, servlet tabanlı veya Spring Boot web uygulamaları için ideal hâle getirir. İster özel bir dönüşüm sunucusu, bir mikro hizmet ya da çok iş parçacıklı bir toplu işlemci oluşturuyor olun, aynı API yükü karşılayacak şekilde ölçeklenir. Değerlendirme için geçici lisans sayfası adresinden geçici bir lisans almayı ve üretim kullanımı için fiyatlandırma detaylarını incelemeyi unutmayın. Bu kılavuzdaki kod ve cURL örnekleriyle artık herhangi bir Java çözümüne HTML’den XLSX’e dışa aktarma entegrasyonu yapabilirsiniz.

FAQs

Java servlet içinde HTML’den XLSX dönüşümünü nasıl gerçekleştirebilirim?
Yüklenen HTML dosyasını alan bir servlet oluşturun, GroupDocs.Conversion Cloud SDK for Java’yı kullanarak convertDocument metodunu çağırın ve oluşan XLSX akışını HTTP yanıtına geri yazın. SDK’nın iş parçacığı‑güvenli istemcisi servlet konteynerleri içinde sorunsuz çalışır.

HTML’den XLSX dönüşümünü Java’da bir mikro hizmet olarak çalıştırmak mümkün mü?
Evet. Dönüşüm mantığını hafif bir Spring Boot uygulamasına paketleyin, bir REST uç noktasını ortaya çıkarın ve SDK’nın gerçek format dönüşümünü yönetmesine izin verin. Bu yaklaşım, Java’da HTML’den XLSX dönüşüm mikro hizmeti modeline uyar.

Çok iş parçacıklı bir Java uygulamasında HTML’yi XLSX’e dönüştürebilir miyim?
SDK, iş parçacığı güvenli olacak şekilde tasarlanmıştır, bu nedenle birden fazla dönüşüm görevini paralel olarak başlatabilirsiniz; bu, Java senaryolarında yüksek hacimli HTML’den XLSX’e dönüşüm sunucusu için faydalıdır.

GroupDocs.Conversion Cloud SDK for Java lisanslaması hakkında daha fazla detayı nereden bulabilirim?
Visit the temporary license page to obtain a trial key and check the pricing page for full‑license options. Both links are provided on the product’s main page.

Daha Fazla Oku