Java'da XLSX'ten JPG'ye Dönüştürme Eğitimi

Fri, 17 Jul 2026 09:43:13 +0000

Java’da XLSX to JPG dönüşümü, elektronik tablo verilerini görüntü olarak göstermek istediğinizde yaygın bir ihtiyaçtır. GroupDocs.Conversion Cloud SDK for Java basit bir REST‑tabanlı kütüphane sunar ve Excel çalışma sayfalarını doğrudan JPG dosyalarına render etmenizi sağlar. Bu kılavuz, gerekli kurulumu adım adım gösterir, tam bir kod örneği sunar, cURL ile eşzamanlı işleme örnek verir ve büyük çalışma kitaplarıyla başa çıkmak için performans ipuçları sağlar.

Java’da XLSX’ten JPG’ye Dönüştürme Adımları

Maven Bağımlılığı Ekle: pom.xml dosyanıza SDK’yı ekleyin, böylece kütüphane derleme zamanında kullanılabilir.


    com.groupdocs
    groupdocs-conversion-cloud
    23.12

Dönüştürme İstemcisini Başlatın: ConversionApi sınıfının bir örneğini istemci kimlik bilgilerinizle oluşturun.

import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;

Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

ConversionApi conversionApi = new ConversionApi(new ApiClient(config));

Dönüşüm Seçeneklerini Yapılandır: Çıktı formatını JPG olarak ayarlayın, bir çözünürlük seçin ve istenirse async işleme etkinleştirin.

import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;

JpgConvertOptions jpgOptions = new JpgConvertOptions();
jpgOptions.setResolution(300);          // 300 DPI for high quality
jpgOptions.setQuality(90);              // JPEG quality 0‑100
jpgOptions.setAsync(true);              // Enable async conversion

ConvertOptions options = new ConvertOptions();
options.setOutputFormat("JPG");
options.setJpgOptions(jpgOptions);

Execute the Conversion: Kaynak XLSX dosyası ve seçeneklerle bir ConvertDocumentRequest oluşturun, ardından API’yi çağırın.

import java.io.File;

File sourceFile = new File("sample.xlsx");
ConvertDocumentRequest request = new ConvertDocumentRequest(sourceFile, options);
String jobId = conversionApi.convertDocument(request);
System.out.println("Conversion started, job ID: " + jobId);

Sonucu İndir: İş durumunu tamamlanana kadar sorgulayın, ardından oluşturulan her JPG’yi indirin.

import com.groupdocs.conversion.cloud.model.JobStatus;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;

while (true) {
    JobStatusResponse statusResponse = conversionApi.getJobStatus(jobId);
    JobStatus status = statusResponse.getStatus();
    if (status == JobStatus.COMPLETED) break;
    Thread.sleep(2000); // wait 2 seconds before next poll
}
conversionApi.downloadResult(jobId, new File("output/"));
System.out.println("JPG files saved to output folder.");

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

Java’da XLSX’den JPG Oluşturma - Tam Kod Örneği

Bu örnek, bir XLSX çalışma kitabını yükleyen, her çalışma sayfasını ayrı bir JPG’ye dönüştüren ve görüntüleri yerel olarak kaydeden tam uçtan uca bir dönüşümü göstermektedir.

package com.example.conversion;

import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;
import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;
import com.groupdocs.conversion.cloud.model.JobStatus;

import java.io.File;

public class XlsxToJpgDemo {
    public static void main(String[] args) throws Exception {
        // 1. Configure client
        Configuration config = new Configuration();
        config.setClientId("YOUR_CLIENT_ID");
        config.setClientSecret("YOUR_CLIENT_SECRET");
        ConversionApi api = new ConversionApi(new ApiClient(config));

// 2. Prepare conversion options
        JpgConvertOptions jpgOpts = new JpgConvertOptions();
        jpgOpts.setResolution(300);
        jpgOpts.setQuality(90);
        jpgOpts.setAsync(true); // async conversion

ConvertOptions convOpts = new ConvertOptions();
        convOpts.setOutputFormat("JPG");
        convOpts.setJpgOptions(jpgOpts);

// 3. Create request
        File source = new File("input/sample.xlsx");
        ConvertDocumentRequest request = new ConvertDocumentRequest(source, convOpts);

// 4. Start conversion
        String jobId = api.convertDocument(request);
        System.out.println("Job started, ID: " + jobId);

// 5. Wait for completion
        while (true) {
            JobStatusResponse statusResp = api.getJobStatus(jobId);
            if (statusResp.getStatus() == JobStatus.COMPLETED) break;
            Thread.sleep(2000);
        }

// 6. Download JPG files
        api.downloadResult(jobId, new File("output/"));
        System.out.println("Conversion finished. JPG files are in the output folder.");
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input/sample.xlsx, output/) gerçek 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 Excel’i Görüntüye Dönüştür

Aşağıdaki cURL komutları, aynı XLSX’ten JPG’ye dönüşümü REST API kullanarak nasıl gerçekleştireceğinizi gösterir. Yer tutucu değerleri gerçek kimlik bilgileriniz ve dosya adlarınızla değiştirin.

Erişim Token’ını Al

curl -X POST "https://api.groupdocs.cloud/v1.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

XLSX Dosyasını Yükleyin

curl -X POST "https://api.groupdocs.cloud/v1.0/storage/file/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.xlsx"

Asenkron Dönüşümü Başlat

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "sourceFilePath": "sample.xlsx",
           "outputFormat": "JPG",
           "options": {
               "resolution": 300,
               "quality": 90,
               "async": true
           }
         }'

İş Durumunu Kontrol Et (önceki adımdan dönen değeri JOB_ID ile değiştirin)

curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/status" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Sonuçta Oluşan JPG Dosyalarını İndir

curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/result" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.zip

Tam parametre listesi için, resmi API belgelerine bakın.

Kurulum ve Yapılandırma GroupDocs.Conversion Cloud SDK for Java

SDK’yı Maven ile projenize ekleyin, ardından istemci kimlik bilgilerinizi yapılandırın.

# Add the dependency (already shown in the Steps section)
mvn install com.groupdocs:groupdocs-conversion-cloud

// Example configuration (same as in the Steps section)
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");

En son JAR dosyalarını indirme sayfasından indirebilirsiniz.

XLSX’den JPG’ye Dönüştürme Seçenekleri

Oluşturulan görüntüleri ince ayar yapmanızı sağlayan birkaç seçenek mevcuttur.

Seçenek	Açıklama	Örnek
Çözünürlük	Çıktı görüntüsünün DPI’si. Daha yüksek değerler kaliteyi artırır ancak dosya boyutunu büyütür.	`jpgOpts.setResolution(300);`
Kalite	JPEG sıkıştırma seviyesi (0‑100).	`jpgOpts.setQuality(90);`
Sayfa Aralığı	Yalnızca belirli çalışma sayfalarını dönüştür.	`jpgOpts.setPageRange("1-3");`
Async	Dönüştürmeyi arka planda çalıştır ve tamamlanmayı periyodik olarak kontrol et.	`jpgOpts.setAsync(true);`

Her özellik SDK’daki JpgConvertOptions parçasıdır. Tam liste için API referansına bakın.

Dönüştürme Hızını ve Bellek Kullanımını İyileştirme

Stream Worksheets - Bir çalışma sayfasını bir seferde işleyin, async modu etkinleştirerek; bu, tüm çalışma kitabının belleğe yüklenmesini önler.
Adjust Resolution - Kullanım durumunuz için kabul edilebilir en düşük DPI’yi kullanın; 150‑200 DPI genellikle web ön izlemeleri için yeterlidir.
Batch Requests - Birçok dosyayı dönüştürürken, sunucunuzun CPU ve ağ kapasitesiyle sınırlı paralel toplu istekler gönderin.
Reuse ApiClient - ConversionApi örneğini tek bir kez oluşturun ve birden fazla dönüşümde tekrar kullanarak tekrarlanan kimlik doğrulama yükünden kaçının.

Bu ipuçlarını uygulamak, büyük Excel dosyaları için dönüşüm süresini %40’a kadar azaltabilir.

Sonuç

Java’da XLSX’ten JPG’ye dönüşüm, GroupDocs.Conversion Cloud SDK for Java ile oldukça basit hale gelir. Yukarıdaki adımları izleyerek her çalışma sayfasını yüksek kaliteli bir JPG olarak render edebilir, daha iyi ölçeklenebilirlik için async işleme yararlanabilir ve büyük çalışma kitapları için performans iyileştirmeleri uygulayabilirsiniz. Üretim dağıtımları için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve kütüphaneyi değerlendirmek için bir temporary license ile başlayabilirsiniz. Bu yeteneği uygulamalarınıza entegre ederek, istemci tarafı Office kurulumlarına ihtiyaç duymadan Excel verilerinin hızlı görsel önizlemelerini sağlayabilirsiniz.

FAQs

Java kullanarak GroupDocs ile XLSX’ten JPG dönüşümünü nasıl gerçekleştiririm?
ConversionApi sınıfını kullanarak bir XLSX dosyasını yükleyin, JpgConvertOptions (çözünürlük, kalite, async) ayarlayın ve convertDocument metodunu çağırın. SDK, JPG dosyaları hazır olana kadar sorgulayabileceğiniz bir iş kimliği (job ID) döndürür.

Büyük Excel çalışma kitaplarını belleği tükenmeden dönüştürebilir miyim?
Evet. Asenkron dönüştürmeyi etkinleştirin ve makul bir çözünürlük ayarlayın. SDK, çalışma sayfalarını sıralı olarak işler ve bellek kullanımını düşük tutar.

XLSX’ten JPG’ye asenkron dönüşüm destekleniyor mu?
SDK, JpgConvertOptions içinde bir async bayrağı sağlar. true olarak ayarlandığında, API bir iş kimliği döndürür, böylece durumu kontrol edip sonuçları daha sonra indirebilirsiniz.

Üretimde dönüşüm özelliklerini kullanmak için özel bir lisansa ihtiyacım var mı?
Üretim kullanımında geçerli bir GroupDocs.Conversion Cloud lisansı gereklidir. Tam bir abonelik satın almadan önce geçici lisans sayfasından geçici bir lisansla başlayabilirsiniz.

excel image conversion on Document Processing REST APIs | GroupDocs Cloud