Spreadsheet verilerinin görsel ön izlemelerini oluşturmak, raporlama panoları veya e‑posta özetleri oluştururken sıkça ihtiyaç duyulan bir gereksinimdir. Conholdate.Total for Java sağlam bir SDK sağlayarak Java uygulamalarında Excel’i görüntüye dönüştürme sürecini basitleştirir. Bu kılavuzda, bir XLSX çalışma kitabını nasıl yükleyeceğinizi, PNG çıktısını nasıl yapılandıracağınızı ve tüm çalışma sayfaları, grafikler veya belirli aralıklar için görüntü dosyaları oluşturacağınızı göreceksiniz. Sonunda, kendi projelerinize uyarlayabileceğiniz hazır‑çalıştır bir kod örneğine sahip olacaksınız.

Excel Dosyalarını Görüntüye Dönüştürmenin Uygulamanızdan Gerektirdiği Şartlar

Geliştiriciler genellikle elektronik tablo içeriğini web ön izlemeleri, PDF raporları veya mobil küçük resimler için statik görüntülere dönüştürmeleri gerekir. Gereksinim genellikle hücre biçimlendirmesinin korunmasını, gömülü grafiklerin render edilmesini ve isteğe bağlı olarak dönüşümün tek bir aralığa sınırlanmasını içerir. Bu görevleri manuel olarak Excel’i açıp ekran görüntüsü alarak ve kaydederek yapmak ölçeklenemez ve tutarsız sonuçlara yol açabilir.

Güvenilir bir çözüm için teknik kısıtlamalar şunlardır: XLSX dosyalarını destekleme, grafikler ve formüller ekleme yeteneği, yapılandırılabilir görüntü çözünürlüğü ve birden fazla çalışma sayfasının toplu işlenmesi. Dönüştürme, Microsoft Office gerektirmeden bir sunucu veya masaüstü ortamında çalışmalıdır.

İşi İçin Conholdate.Total for Java Seçmek

Conholdate.Total for Java gerekli tüm yetenekleri kapsayan birleşik bir API sunar. ExcelLoadOptions grafik ve formülleri yüklemenizi sağlar, ImageConvertOptions ise format, kalite ve boyutlar üzerinde ayrıntılı kontrol sunar. SDK, herhangi bir Java çalışma zamanında çalışır, yalnızca Maven bağımlılığını gerektirir ve büyük çalışma kitaplarını verimli bir şekilde işler.

Detaylı API kullanımı için resmi belgeleri inceleyin. Conversion, ExcelLoadOptions ve ImageConvertOptions gibi sınıflar için tam referans, API referansında mevcuttur. En son kütüphaneyi sürüm sayfasından indirebilirsiniz.

Java’da Excel’i Görüntüye Dönüştürme Uygulaması

Dönüştürme süreci birkaç net adıma ayrılabilir. Aşağıdaki bölümler, tam örnekten doğrudan alınan kısa kod alıntılarıyla her bir kısmı size gösterir.

Conholdate.Total for Java via Maven’i Kur

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Grafik ve Formül Desteğiyle Excel Dosyasını Yükle

Bir ExcelLoadOptions örneği oluşturun, grafik ve formül yüklemeyi etkinleştirin ve bir dosya akışıyla Conversion nesnesini başlatın:

ExcelLoadOptions loadOptions = new ExcelLoadOptions();
loadOptions.setLoadCharts(true);
loadOptions.setLoadFormulas(true);

Conversion conversion = new Conversion(new FileInputStream("input.xlsx"), loadOptions);

PNG için Görüntü Çıktı Seçeneklerini Yapılandır

İstenen görüntü formatını, kalitesini ve boyutlarını ayarlayın. Genişlik sabitken yükseklik en boy oranını korur:

ImageConvertOptions imgOptions = new ImageConvertOptions();
imgOptions.setFormat(ImageConvertOptions.ImageFormat.PNG);
imgOptions.setQuality(90);
imgOptions.setWidth(1200);
imgOptions.setHeight(0); // preserve aspect ratio

Her Çalışma Sayfasını veya Aralığı PNG Görüntülerine Dönüştür

Çalışma kitabı sayfalarını (sayfalar) yineleyin ve her birini dönüştürün. pageNumber değerini ayarlayarak veya ek yükleme seçeneklerini kullanarak belirli bir aralığı da hedefleyebilirsiniz:

int pageCount = conversion.getPageCount();
for (int i = 1; i <= pageCount; i++) {
    imgOptions.setPageNumber(i);
    String outputPath = "output_images/sheet_" + i + ".png";
    conversion.convert(outputPath, imgOptions);
}

Çıktıyı Doğrula ve İstisnaları İşle

Dönüştürme mantığını bir try‑catch bloğuna sarın ve başlatmadan önce çıktı dizininin mevcut olduğundan emin olun:

try {
    Files.createDirectories(Paths.get("output_images"));
    // conversion code here
    System.out.println("Excel to image conversion completed successfully.");
} catch (Exception ex) {
    System.err.println("Conversion failed: " + ex.getMessage());
    ex.printStackTrace();
}

Yukarıdaki adımlar, Conholdate.Total SDK’sını kullanarak Excel’i görüntüye dönüştürme işlemini gösterir ve grafikler, aralıklar ve tam çalışma sayfalarını yönetme esnekliği sağlar.

Tam Kod Örneği: Excel’i Görüntüye Dönüştürme ve Tam Sayfa Desteği

Aşağıdaki kod, yukarıdaki adımlarda açıklanan tam, çalıştırmaya hazır uygulamayı gösterir.

import java.io.FileInputStream;
import java.nio.file.Files;
import java.nio.file.Paths;

import com.groupdocs.conversion.Conversion;
import com.groupdocs.conversion.options.load.ExcelLoadOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageConvertOptions.ImageFormat;

public class ExcelToImageConverter {
    public static void main(String[] args) {
        String inputFile = "input.xlsx";
        String outputFolder = "output_images";

try {
            // Create output directory if it does not exist
            Files.createDirectories(Paths.get(outputFolder));

// Load options: include charts and formulas during conversion
            ExcelLoadOptions loadOptions = new ExcelLoadOptions();
            loadOptions.setLoadCharts(true);
            loadOptions.setLoadFormulas(true);

// Initialize conversion with the Excel file and load options
            try (Conversion conversion = new Conversion(new FileInputStream(inputFile), loadOptions)) {

// Determine how many pages (sheets) the workbook has
                int pageCount = conversion.getPageCount();

// Configure image output options
                ImageConvertOptions imgOptions = new ImageConvertOptions();
                imgOptions.setFormat(ImageFormat.PNG);   // Output format
                imgOptions.setQuality(90);               // Quality (relevant for JPEG)
                imgOptions.setWidth(1200);               // Desired width, height will keep aspect ratio
                imgOptions.setHeight(0);                 // 0 means preserve original aspect ratio

// Convert each sheet to a separate image file
                for (int i = 1; i <= pageCount; i++) {
                    imgOptions.setPageNumber(i);
                    String outputPath = outputFolder + "/sheet_" + i + ".png";
                    conversion.convert(outputPath, imgOptions);
                }
            }

System.out.println("Excel to image conversion completed successfully.");
        } catch (Exception ex) {
            System.err.println("Conversion failed: " + ex.getMessage());
            ex.printStackTrace();
        }
    }
}

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

Sonuç

Java’da Excel’i görüntüye dönüştürmek, Conholdate.Total for Java kullanıldığında oldukça basit hale gelir. SDK, grafik render’ını, formül değerlendirmesini ve yüksek kaliteli PNG çıktısını minimum kodla yönetir. Adım adım kılavuzu izleyerek bu yeteneği raporlama araçlarına, e-posta oluşturucularına veya görsel tablo temsillerine ihtiyaç duyan herhangi bir uygulamaya entegre edebilirsiniz. Üretim dağıtımlarının ticari bir lisans gerektirdiğini unutmayın; fiyatlandırma seçeneklerini Conholdate.Total fiyatlandırması sayfasında inceleyebilir ve değerlendirme sırasında geçici lisans sayfası üzerinden geçici bir lisans alabilirsiniz.

FAQs

  • Java’da Excel’i görüntüye nasıl dönüştürebilirim?
    Conversion sınıfını Conholdate.Total for Java üzerinden kullanın, ExcelLoadOptions ve ImageConvertOptions yapılandırın ve ardından her çalışma sayfası için convert metodunu çağırın.

  • Excel grafiğini bir görüntüye dönüştürebilir miyim?
    Evet. loadOptions.setLoadCharts(true) ile grafik yüklemeyi etkinleştirin ve imgOptions.setPageNumber ayarlarken grafiğin sayfa numarasını belirtin.

  • Belirli bir hücre aralığını yalnızca dönüştürmek mümkün mü?
    Dönüştürmeden önce yükleme seçeneklerinde bir aralık tanımlayabilir veya istenen aralığa karşılık gelen uygun sayfa numarasını seçebilirsiniz.

  • Üretim kullanımı için hangi lisans gereklidir?
    Ticari bir lisans gereklidir. Maliyetleri Conholdate.Total fiyatlandırması sayfasında inceleyin ve geçici bir lisans için geçici lisans sayfası alın.

Daha Fazla Oku