GroupDocs.Parser Kullanarak Java’da Elektronik Tablo Küçük Resmi Oluştur

Eğer Java’da elektronik tablo küçük resmi oluştur programları arıyorsanız, doğru yerdesiniz. Bu rehberde, GroupDocs.Parser for Java kullanarak .xlsx çalışma kitaplarından yüksek kaliteli PNG önizlemeleri oluşturmayı adım adım göstereceğiz—hızlı küçük resimler, anlık görüntüler paylaşmak veya uygulamanızda bir belge önizleme özelliği oluşturmak için mükemmeldir. Çözüm Microsoft Office kurulumu olmadan çalışır ve büyük çalışma kitaplarıyla ölçeklenebilir, bellek kullanımını düşük tutar.

Hızlı Yanıtlar

  • “preview Excel” ne anlama geliyor? Her çalışma sayfasını temsil eden görüntü dosyaları (ör. PNG) oluşturmak.
  • Hangi format önerilir? PNG, kayıpsız kalite sağlar ve web küçük resimleri için iyi çalışır.
  • Bir lisansa ihtiyacım var mı? Geliştirme için ücretsiz deneme sürümü çalışır; üretim için ticari lisans gereklidir.
  • Görüntü çözünürlüğünü değiştirebilir miyim? Evet—PreviewOptions içinde DPI’yi ayarlayın.
  • Diğer formatları önizlemek mümkün mü? GroupDocs.Parser ayrıca PDF, Word ve birçok görüntü türünü destekler.

GroupDocs.Parser ile “Excel önizleme” nasıl yapılır?

Excel çalışma kitabınızı yükleyin ve her sayfayı Microsoft Office gerektirmeden PNG görüntüsü olarak render edin. GroupDocs.Parser sayfaları tek tek akıtarak kayıpsız küçük resimler üretir; bu resimler diske kaydedilebilir veya HTTP üzerinden döndürülebilir, bu da web tabanlı önizleme hizmetleri için idealdir.

GroupDocs.Parser Excel çalışma kitaplarını okur, her sayfayı görsel bir sayfa olarak render eder ve bu sayfaları görüntü dosyalarına akıtmanıza olanak tanır. Bu, Office interop veya üçüncü taraf dönüştürücülere ihtiyaç duyulmasını ortadan kaldırır.

Excel önizlemeleri için GroupDocs.Parser neden kullanılmalı?

GroupDocs.Parser’ı kullanmalısınız çünkü herhangi bir Java sunucusunda çalışır, Office kurulumu gerektirmez, büyük çalışma kitaplarını düşük bellekle işler ve yapılandırılabilir DPI ile kayıpsız PNG görüntüleri üretir. SDK 100’den fazla giriş ve çıkış formatını destekler, 200 sayfalık bir çalışma kitabını 3 saniyeden kısa sürede işleyebilir ve sayfa başına bellek kullanımını 50 MB’nin altında tutar.

  • Office kurulumu gerekmez – herhangi bir sunucu‑tarafı Java ortamında çalışır.
  • Büyük dosyaları destekler – sayfaları tek tek akıtarak bellek kullanımını düşük tutar.
  • Yüksek kalite çıktı – DPI, format ve render seçenekleri üzerinde kontrol.
  • Çapraz format esnekliği – aynı API PDF’ler, Word belgeleri ve daha fazlası için çalışır.

Ön Koşullar

  • Java Development Kit (8 +).
  • IDE (IntelliJ IDEA veya Eclipse gibi).
  • GroupDocs.Parser for Java SDK – buradan indirin.
  • Dokümantasyon – resmi dokümantasyon sayfasına bakın.
  • Örnek Excel dosyası (.xlsx) önizlemek istediğiniz.
  • Maven veya Gradle (isteğe bağlı) bağımlılık yönetimi için.

Paketleri İçe Aktarma

Bu içe aktarmalar, parser, önizleme seçenekleri ve akış yönetimi yardımcı programlarına erişim sağlar.

import com.groupdocs.parser.Parser;
import com.groupdocs.parser.options.PreviewOptions;
import com.groupdocs.parser.options.PreviewFormats;
import com.groupdocs.parser.options.ICreatePageStream;
import com.groupdocs.parser.options.IPreviewPageRender;
import com.groupdocs.parser.results.PageRenderInfo;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.io.IOException;

Sayfa Önizlemeleri Oluşturmak için Adım‑Adım Kılavuz

Adım 1: Parser Örneğini Başlatma

Parser, GroupDocs.Parser’ın elektronik tablo dosyalarına okuma erişimi sağlayan ve sayfa‑sayfa render etmeyi mümkün kılan çekirdek sınıfıdır.
Excel çalışma kitabınızı gösteren bir Parser nesnesi oluşturun. try‑with‑resources bloğu parser’ın otomatik olarak kapanmasını sağlar.

try (Parser parser = new Parser("path/to/your/sample.xlsx")) {
    // Your subsequent code will go here
}

İpucu: FileNotFoundException hatasından kaçınmak için mutlak bir yol kullanın veya bir kaynak klasörü yapılandırın.

Adım 2: Önizleme Seçeneklerinizi Hazırlayın

PreviewOptions, çıktı formatı ve DPI gibi render parametrelerini yapılandırır.
ICreatePageStream, oluşturulan her sayfa için bir çıktı akışı sağlayan bir geri çağırma arayüzüdür. Her sayfanın nasıl kaydedileceğini tanımlayın. ICreatePageStream uygulaması, her çalışma sayfası için yeni bir FileOutputStream döndürür.

PreviewOptions previewOptions = new PreviewOptions(new ICreatePageStream() {
    @Override
    public OutputStream createPageStream(int pageNumber) {
        try {
            String outputPath = getOutputPath(pageNumber); // define this method later
            return new FileOutputStream(outputPath);
        } catch (IOException ex) {
            throw new RuntimeException("Error creating output stream", ex);
        }
    }
});

Bu adım, xlsx’i png’ye dönüştürdüğünüz yerdir—akış PNG verisini diske yazar.

Adım 3: Render Bilgilerini Yakalamak İçin Bir Delegasyon Ekleyin

Render edilen her sayfa hakkında (ör. boyutlar, sayfa adı) detaylara ihtiyacınız varsa, bir geri çağırma kaydedin.

final PageRenderInfo[] renderInfoHolder = {null}; // to store info

previewOptions.setPreviewPageRender(new IPreviewPageRender() {
    @Override
    public void previewPageRender(PageRenderInfo pageRenderInfo) {
        renderInfoHolder[0] = pageRenderInfo;
    }
});

Adım 4: Çıktı Formatını ve DPI’yi Belirleyin

Görüntü formatı olarak PNG’yi seçin ve kalite ile dosya boyutunu dengeleyen bir DPI ayarlayın.

previewOptions.setPreviewFormat(PreviewFormats.Png); // PNG images
previewOptions.setDpi(150); // Higher DPI for better clarity

Daha küçük küçük resimler (ör. 96) veya yüksek çözünürlüklü baskılar (ör. 300) için DPI’yi ayarlayın.

Adım 5: Önizlemeleri Oluşturun

Her şey yapılandırıldıktan sonra generatePreview metodunu çağırın. SDK, her çalışma sayfası üzerinde dönecek ve sağladığınız akışı çağıracaktır.

parser.generatePreview(previewOptions);

Adım 6: getOutputPath() Yardımcısını Tanımlayın

getOutputPath(), sayfa (çalışma sayfası) numarasına dayalı bir dosya adı oluşturur ve çıktı görüntüsü için tam yolu döndürür. Klasör yapısını istediğiniz gibi özelleştirebilirsiniz.

private static String getOutputPath(int pageNumber) {
    return "output/preview_page_" + pageNumber + ".png"; // Custom path
}

Yaygın tuzak: output dizinini önceden oluşturmayı unutmak bir IOException hatasına yol açar. Dizini programlı olarak oluşturun veya var olduğundan emin olun.

Tam Çalışan Örnek (Basitleştirilmiş)

Aşağıda, tüm parçaları bir araya getiren kompakt bir sürüm bulunmaktadır. Java’da elektronik tablo küçük resmi oluşturma iş akışını baştan sona gösterir.

try (Parser parser = new Parser("path/to/your/sample.xlsx")) {
    final PageRenderInfo[] renderInfoHolder = {null};

    PreviewOptions options = new PreviewOptions(new ICreatePageStream() {
        @Override
        public OutputStream createPageStream(int pageNumber) {
            try {
                return new FileOutputStream(getOutputPath(pageNumber));
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    });

    options.setPreviewPageRender(pageRenderInfo -> {
        renderInfoHolder[0] = pageRenderInfo;
    });
    options.setPreviewFormat(PreviewFormats.Png);
    options.setDpi(150);

    parser.generatePreview(options);
} catch (Exception e) {
    e.printStackTrace();
}

Bu kodu çalıştırdığınızda, output klasöründe preview_page_1.png, preview_page_2.png, … gibi bir dizi dosya bulacaksınız—her biri orijinal Excel çalışma kitabının bir sayfasını temsil eder.

Yaygın Sorunlar ve Çözümler

SorunNedenÇözüm
Görüntü oluşturulmadıgetOutputPath geçersiz bir dizin döndürüyorHedef klasörün var olduğundan emin olun veya new File("output").mkdirs(); ile oluşturun
Büyük dosyalarda bellek yetersizliği hatasıTüm çalışma kitabını bir kerede yüklemekAkış yaklaşımını (gösterildiği gibi) kullanın ve sayfaları tek tek işleyin
Yanlış DPIsetDpi çağrılmadı veya varsayılan (96) olarak ayarlandıgeneratePreview‘den önce previewOptions.setDpi(istenenDeğer); çağırın
Desteklenmeyen formatBozuk bir .xlsx dosyasını önizlemeye çalışmakDosyayı Excel ile doğrulayın veya işlemden önce Parser.isSupported kullanın

Sıkça Sorulan Sorular

S: GroupDocs.Parser kullanarak PDF ve görüntü önizlemeleri oluşturabilir miyim?
A: Evet, aynı API PDF’ler, Word belgeleri ve birçok görüntü formatı için çalışır.

S: Çıktı görüntü formatını nasıl değiştiririm?
A: previewOptions.setPreviewFormat(PreviewFormats.Jpeg) (veya Gif, Bmp, vb.) metodunu çağırın.

S: Çok büyük çalışma kitaplarında performans bir sorun mu?
A: SDK sayfaları akıtarak bellek kullanımını düşük tutar. Çok büyük dosyalar için paralel toplu işlemeyi düşünün.

S: Önizleme oluşturma sırasında hataları nasıl yönetebilirim?
A: Kodları (gösterildiği gibi) try‑catch bloklarıyla sarın ve istisna detaylarını kaydedin. try‑with‑resources kullanmıyorsanız akışların finally bloğunda kapatıldığından emin olun.

S: Kütüphane Microsoft Office kurulumunu gerektiriyor mu?
A: Hayır. GroupDocs.Parser saf bir Java çözümüdür ve Java 8+ destekleyen herhangi bir platformda çalışır.

Son Güncelleme: 2026-07-16
Test Edilen Versiyon: GroupDocs.Parser 23.11 (yazım zamanı en son sürüm)
Yazar: GroupDocs

İlgili Öğreticiler