ZIP’i HTML’e dönüştür ve sayfa başına öğe sayısını GroupDocs.Viewer Java ile ayarla

Birçok web uygulamasında bir ZIP veya RAR arşivinin içeriğini doğrudan tarayıcıda göstermeniz gerekir. ZIP dosyalarını HTML’e dönüştürmek için GroupDocs.Viewer for Java kullanmak yaygın bir gereksinimdir ve kütüphane, görüntüleri, CSS’i ve yazı tiplerini gömmenize olanak tanır, böylece sonuç tek, taşınabilir bir sayfa olur. Bu öğretici, Maven kurulumundan çok sayfalı render’a kadar her şeyi adım adım anlatırken, her seçeneğin performans ve kullanılabilirlik açısından neden önemli olduğunu açıklar.

GroupDocs.Viewer for Java ile Arşivleri HTML’e Dönüştür

Hızlı cevaplar

  • “Sayfa başına öğe sayısı” kontrolü ne işe yarar? Bir arşivdeki kaç dosya veya klasörün her oluşturulan HTML sayfasında görüneceğini belirler.
  • Görüntüleri ve CSS’i doğrudan HTML içinde gömebilir miyim? Evet – kaynakları gömmek için forEmbeddedResources seçeneğini kullanın.
  • Toplu dönüşüm mümkün mü? Kesinlikle; bir arşiv koleksiyonunu döngüye alabilir ve aynı ayarlarla her birini render edebilirsiniz.
  • GroupDocs.Viewer kullanmak için Maven gerekli mi? Evet, aşağıda gösterildiği gibi groupdocs-viewer Maven bağımlılığını ekleyin.
  • Hangi çıktı formatları destekleniyor? Tek‑sayfa HTML ve çok‑sayfa HTML her ikisi de mevcuttur ve kütüphane 50+ giriş arşiv türünü destekler.

GroupDocs.Viewer’da “sayfa başına öğe sayısı” nedir?

Bu ayar, çok‑sayfalı bir belge oluştururken her HTML sayfasında kaç arşiv girdisinin (dosya veya klasör) gösterileceğini belirler. Bu değeri ayarlamak, özellikle büyük arşivlerde sayfa boyutunu ve gezinme hızını dengelemeye yardımcı olur; sayfa başına yüklenen veri miktarını sınırlayarak son kullanıcıların render süresini azaltır.

Neden kaynakları HTML içinde gömülür?

Kaynakları (görüntüler, CSS, yazı tipleri) doğrudan HTML dosyasına gömmek, harici dosyalar olmadan açılabilen tek bir taşınabilir belge oluşturur. Bu, e‑posta ekleri, çevrim dışı görüntüleme veya çıktıyı diğer web sayfalarına gömme senaryoları için idealdir. Ayrıca harici varlık yollarını yönetme ihtiyacını ortadan kaldırır.

Önkoşullar

  • Gerekli kütüphaneler: GroupDocs.Viewer sürüm 25.2 veya daha yenisi.
  • Ortam: Java Development Kit (JDK) kurulu ve yapılandırılmış.
  • Bilgi: Temel Java ve Maven bağımlılık yönetimi bilgisi.

Maven GroupDocs Viewer kurulumu

pom.xml dosyanıza GroupDocs deposunu ve görüntüleyici bağımlılığını ekleyin:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Lisans edinimi

GroupDocs.Viewer bir ücretsiz deneme bağlantısı, geçici lisans veya tam satın alma seçeneği sunar. Proje zaman çizelgenize uygun olanı seçin.

Temel başlatma

Viewer sınıfı, belgeleri ve arşivleri render etmek için giriş noktasıdır. Maven kurulumu tamamlandıktan sonra görüntüleyiciyi kodunuza dahil edin:

import com.groupdocs.viewer.Viewer;
// Your initialization code here

Arşivleri tek sayfalı HTML’e nasıl render ederiz

HtmlViewOptions sınıfı, HTML çıktısı için gömme kaynaklar gibi ayarları tanımlar. Arşivi yükleyin, HTML seçeneklerini kaynakları gömmek üzere yapılandırın ve her şeyi tek bir kendi içinde barındıran sayfaya render edin. Bu, tüm dosyaları, görüntüleri, CSS’i ve yazı tiplerini içeren tek bir HTML dosyası üretir; çevrim dışı kullanım veya e‑posta eki için hazırdır.

Doğrudan cevap: ZIP dosyası için bir Viewer örneği oluşturun, HtmlViewOptions.forEmbeddedResources() çağırın ve viewer.view(documentPath, options) metodunu çalıştırın. Bu, tüm dosyaları, görüntüleri, CSS’i ve yazı tiplerini içeren tek bir HTML dosyası üretir; çevrim dışı kullanım veya e‑posta eki için hazırdır.

Adım 1: Çıktı dizinini tanımla

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Adım 2: Tek sayfalı çıktı için dosya adını ayarla

Path pageFilePathFormat = outputDirectory.resolve("RAR_result.html");

Adım 3: Görüntüleyiciyi başlat

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Further configuration steps follow
}

Adım 4: Render seçeneklerini yapılandır (kaynakları HTML içinde göm)

HtmlViewOptions sınıfı, HTML çıktısı için gömme kaynaklar gibi ayarları tanımlar. Her şeyi tek bir dosyada birleştirmek için forEmbeddedResources() kullanın.

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Adım 5: Tek sayfa olarak render et

options.setRenderToSinglePage(true);
viewer.view(options);

Arşivleri çok sayfalı HTML’e nasıl render eder ve sayfa başına öğe sayısını ayarlar

HtmlViewOptions sınıfı aynı zamanda sayfalama desteği sunar. options.setItemsPerPage(N) çağrısıyla, arşivi birkaç HTML dosyasına bölerek her birinin N girişe kadar göstermesini sağlarsınız. Bu yaklaşım, büyük arşivlerde gezinme hızını artırırken her sayfayı hafif tutar.

Doğrudan cevap: HtmlViewOptions.forEmbeddedResources() kullanın, options.setItemsPerPage(N) çağırın ve arşivi render edin. Görüntüleyici, her biri N girişe kadar içeren ayrı HTML dosyaları (sayfa başına bir dosya) oluşturur; bu da büyük arşivlerde gezinmeyi hızlandırır.

Adım 1: Çıktı dizinini yeniden kullan

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Adım 2: Çoklu sayfalar için dosya adı formatını tanımla

Path pageFilePathFormat = outputDirectory.resolve("RAR_result_page_{0}.html");

Adım 3: Görüntüleyiciyi tekrar başlat

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Continue with multi‑page configuration
}

Adım 4: Çok sayfalı seçenekleri yapılandır (kaynakları HTML içinde göm)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Adım 5: Sayfa başına öğe sayısını ayarla (eylemdeki anahtar kelime)

options.setItemsPerPage(20); // how to convert zip archives with 20 entries per page

options.getArchiveOptions().setItemsPerPage(10); // Default is 16
viewer.view(options);

Pratik uygulamalar

  • Belge yönetim sistemleri: Ek görüntüleyiciler kurmadan arşiv önizleme işlevi ekleyin.
  • Web portalları: Kullanıcılara paketlenmiş belgeleri indirmeden hızlı bir şekilde keşfetme imkanı sunun.
  • İş birliği araçları: Takımların paylaşılan arşivleri doğrudan tarayıcıda incelemesini sağlayın.

Performans değerlendirmeleri

  • Kaynak yönetimi: Arşivleri akış olarak işleyerek bellek kullanımını düşük tutun; görüntüleyici, tüm dosyayı belleğe yüklemeden 500 MB’a kadar arşivleri işleyebilir.
  • Toplu arşiv dönüştürme: Bir dizi arşiv dosyasını döngüye alıp aynı render mantığını çağırarak verimliliği maksimize edin.
  • Önbellek stratejisi: Aynı arşiv sık erişiliyorsa render edilmiş HTML’i önbellekte saklayın; bu, tekrar işleme süresini %70’e kadar azaltabilir.

Sıkça sorulan sorular

S: GroupDocs.Viewer Java nedir?
C: GroupDocs.Viewer Java, ZIP ve RAR dahil 50’den fazla belge ve arşiv formatını HTML, PDF veya görüntü dosyalarına dış uygulamalara ihtiyaç duymadan render eden bir sunucu‑tarafı kütüphanedir.

S: GroupDocs.Viewer’ın ücretsiz deneme sürümünü nasıl elde edebilirim?
C: ücretsiz deneme bağlantısı üzerinden indirip test edin.

S: Arşivlerin dışında başka belge türlerini dönüştürebilir miyim?
C: Evet, görüntüleyici PDF, Word, Excel, PowerPoint ve 35+ ek formatı destekler.

S: Render yavaşsa ne yapmalıyım?
C: Sayfa başına öğe sayısını azaltın, akışı etkinleştirin veya arşivleri daha küçük partiler halinde işleyerek hızı artırın.

S: Yardım veya destek nereden alınabilir?
C: destek forumu üzerinden iletişime geçin.

S: CSS ve görüntüleri doğrudan HTML içinde gömmek mümkün mü?
C: Kesinlikle—örneklerde gösterildiği gibi HtmlViewOptions.forEmbeddedResources kullanın.

S: Bir klasördeki arşivleri toplu olarak nasıl dönüştürebilirim?
C: for döngüsüyle her dosyayı yineleyin, aynı Viewer ve HtmlViewOptions yapılandırmasını her yinelemede uygulayın.

S: Diğer kullanıcılarla sorunları nerede tartışabilirim?
C: GroupDocs forumu üzerinden topluluk tartışmalarına katılın.

Kaynaklar

Son Güncelleme: 2026-10-10
Test Edilen Versiyon: GroupDocs.Viewer 25.2
Yazar: GroupDocs

İlgili öğreticiler