GroupDocs.Viewer for Java ile belirli pdf sayfalarını nasıl döndürürsünüz

PDF içinde belirli sayfaları döndürmek, belgeleri hizalamak, taranmış görüntüleri düzeltmek veya sunum slaytlarını ayarlamak için gerekli olabilir. Bu rehberde GroupDocs.Viewer ile programlı olarak belirli pdf sayfalarını nasıl döndüreceğinizi öğreneceksiniz, pdf’i 90 derece döndürmeniz, bir bölümü ters çevirmeniz veya tek bir çağrıda birden fazla sayfayı işlemeniz gerekse.

GroupDocs.Viewer for Java ile Belirli PDF Sayfalarını Döndürme

GroupDocs.Viewer for Java ile Belirli PDF Sayfalarını Döndürme

Neler öğreneceksiniz

  • Java projenizde GroupDocs.Viewer’ı kurma (Maven GroupDocs Viewer yapılandırması dahil)
  • Belirli PDF sayfalarını programlı olarak döndürme (pdf’i 90 derece, 180 derece vb. döndürme)
  • Optimum kullanım için ana yapılandırmalar
  • Uygulama sırasında yaygın sorunların giderilmesi

Hızlı cevaplar

  • Java’da PDF sayfalarını döndürebilen kütüphane hangisidir? GroupDocs.Viewer for Java, harici araçlar olmadan yerleşik döndürme desteği sağlar.
  • Tek bir sayfayı 90 derece döndürebilir miyim? Evet – görüntüleyici örneğinde rotatePage(pageNumber, Rotation.ON_90_DEGREE) metodunu çağırın.
  • Geliştirme için lisansa ihtiyacım var mı? Değerlendirme için geçici lisans ücretsizdir; üretim için tam lisans gereklidir.
  • Maven gerekli mi? Maven önerilen bağımlılık yöneticisidir, ancak Gradle veya manuel JAR eklemesi de kullanabilirsiniz.
  • Döndürülmüş sayfaları nasıl render ederim? HtmlViewOptions ile viewer.view(documentPath, viewOptions) kullanarak döndürmeyi yansıtan HTML çıktısı alın.

Belirli pdf sayfalarını döndürmek nedir?

rotate specific pdf pages ifadesi, bir PDF belgesindeki bireysel sayfaların yönünü değiştirirken dosyanın geri kalanını dokunulmaz bırakma yeteneğini ifade eder. Bu işlem render zamanında gerçekleşir, bu yüzden orijinal PDF dosyası değişmez.

Neden belirli pdf sayfalarını döndürmeliyiz?

Tipik bir sunucu‑sınıfı VM’de tek bir sayfayı 0.05 saniyenin altında döndürebilirsiniz, bu da taranmış sözleşmelerin, sunum slaytlarının veya yanlış yönlendirilmiş taramaları içeren çok sayfalı faturaların gerçek zamanlı önizlemesini sağlar. Bu ince kontrol, maliyetli son‑işlem araçlarına olan ihtiyacı ortadan kaldırır ve büyük ölçekli dijitalleştirme projelerinde manuel çabayı %70’e kadar azaltır.

Önkoşullar

Gerekli kütüphaneler ve bağımlılıklar

  • Java Development Kit (JDK) 8 ve üzeri.
  • IntelliJ IDEA veya Eclipse gibi bir IDE.
  • Bağımlılık yönetimi için Maven.

Ortam kurulum gereksinimleri

  1. Maven yapılandırması – pom.xml dosyanıza GroupDocs.Viewer ekleyin.
  2. Lisans edinimi – GroupDocs’tan geçici bir lisans alın. GroupDocs Free Trial adresini ziyaret edin veya GroupDocs Temporary License Page üzerinden geçici lisans başvurusunda bulunun.

GroupDocs.Viewer for Java’ı Kurma

Maven kullanarak GroupDocs.Viewer’ı Java projenize entegre etmek için pom.xml dosyanızı güncelleyin:

<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>

Temel başlatma ve kurulum

Viewer, bir belgeyi yükleyen ve render işlemlerini yöneten temel sınıftır. Bir örnek oluşturduktan sonra view veya rotatePage gibi metodları çağırabilirsiniz.

Path YOUR_DOCUMENT_DIRECTORY = Path.of("YOUR_DOCUMENT_DIRECTORY");
Path YOUR_OUTPUT_DIRECTORY = Path.of("YOUR_OUTPUT_DIRECTORY");

// Format for page file paths
Path pageFilePathFormat = YOUR_OUTPUT_DIRECTORY.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

GroupDocs.Viewer ile belirli PDF sayfalarını nasıl döndürürsünüz

GroupDocs.Viewer ile belirli PDF sayfalarını döndürmek iki ana eylemi içerir: ilk olarak, hedef sayfa için rotatePage metodunu kullanarak istenen döndürmeyi belirtmek; ikinci olarak, döndürmenin çıktıda yansıtılması için belgeyi HtmlViewOptions ile render etmek. Bu yaklaşım, orijinal PDF’i değiştirmeden doğru yönlendirilmiş HTML sağlar.

Adım 1: sayfa döndürmeyi yapılandırma

rotatePage, sıfır‑tabanlı bir sayfa indeksi ve bir Rotation enum değeri kabul eden bir metoddur. Enum üç seçenek sunar: ON_90_DEGREE, ON_180_DEGREE ve ON_270_DEGREE.

// Rotate the first page by 90 degrees clockwise.
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

// Rotate the second page by 180 degrees.
viewOptions.rotatePage(2, Rotation.ON_180_DEGREE);

Adım 2: görüntüleyiciyi başlatma ve render etme

HtmlViewOptions, PDF‑to‑HTML dönüşüm sürecini kontrol eder. Yapı, fontlar ve gömülü kaynakları korurken yapılandırdığınız döndürmeyi uygular.

Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SampleDocument.pdf"));

// Render the specified pages (1 and 2) using the configured options.
viewer.view(viewOptions, 1, 2);

// Always close the viewer to free resources.
viewer.close();

Parametreler ve yapılandırma

  • Rotation – rotatePage(pageNumber, Rotation.*) burada döndürme seçenekleri ON_90_DEGREE, ON_180_DEGREE, ON_270_DEGREE dir.
  • HtmlViewOptions – Layout ve gömülü kaynakları korurken pdf‑to‑html dönüşümünü yönetir.
  • pdf to html java – Sınıf aynı API’nin bir parçasıdır ve doğru bir görsel temsil sağlar.

Yaygın sorunlar ve çözümler (troubleshoot pdf rotation)

  • Yanlış yollar – YOUR_DOCUMENT_DIRECTORY ve YOUR_OUTPUT_DIRECTORY‘nin mevcut ve erişilebilir olduğunu doğrulayın.
  • Eksik bağımlılıklar – Maven koordinatlarının en son GroupDocs.Viewer sürümüyle (şu anda 25.2) eşleştiğinden emin olun.
  • Lisans kısıtlamaları – Geçici lisansı doğru şekilde uygulayın; aksi takdirde bazı özellikler devre dışı kalabilir.
  • Bellek dalgalanmaları – Büyük PDF’leri daha küçük partiler halinde render edin veya JVM yığın boyutunu artırın.

Pratik uygulamalar

Gerçek dünya kullanım durumları

  1. Belge hizalama – Tarama sözleşmelerini doğru dijital yönlendirme için döndürün.
  2. Sunum ayarlamaları – Paylaşmadan önce PDF içindeki sunum slaytlarını değiştirin.
  3. Arşiv iş akışları – Dijitalleştirme sırasında tarihsel belgelerin yönünü otomatik olarak ayarlayın.

Entegrasyon olasılıkları

GroupDocs.Viewer’ı Java tabanlı içerik yönetim sistemleri, kurumsal portallar veya PDF’lerin anlık görüntülenmesini gerektiren özel API’lerle birleştirin.

Performans değerlendirmeleri

  • Kaynak yönetimi – Dosya tutucularını ve belleği serbest bırakmak için her zaman Viewer örneğini kapatın.
  • Java bellek yönetimi – Büyük PDF’leri işlerken yığın kullanımını izleyin; tüm dosyayı yüklemek yerine sayfaları akış olarak işlemeyi düşünün.
  • En iyi uygulamalar – Sık erişilen belgeler için render edilmiş HTML’yi önbelleğe alarak işleme süresini %60’a kadar azaltın.

Sonuç

Bu öğreticide Java’da GroupDocs.Viewer kullanarak belirli pdf sayfalarını nasıl döndüreceğinizi Maven kurulumundan döndürülmüş sayfaların render edilmesine ve yaygın hataların ele alınmasına kadar ele aldık. Belge iş akışınızı daha da genişletmek için filigran ekleme, format dönüştürme veya toplu işleme gibi ek özelliklerle deneyler yapın.

Sonraki adımlar: PDF’leri PNG’ye dönüştürme, filigran ekleme veya bulut depolama sağlayıcılarıyla entegrasyon gibi diğer GroupDocs.Viewer yeteneklerine göz atın.

SSS bölümü

  • Döndürme sorunlarını giderme – Sayfa numaraları ve döndürme parametrelerinin doğru olduğunu doğrulayın.
  • Büyük PDF dosyalarını işleme – Sayfaları partiler halinde işleyin ve bellek kullanımını izleyin.
  • Lisans gereksinimleri – Geliştirme için geçici lisans kullanın; üretim için tam lisans satın alın.
  • Birden fazla sayfayı döndürme – Farklı sayfa numaraları ve açılarıyla rotatePage metodunu tekrarlayın.
  • Java kütüphaneleriyle entegrasyon – GroupDocs.Viewer, Spring Boot, Jakarta EE ve diğer Java çerçeveleriyle sorunsuz çalışır.

Sık Sorulan Sorular

S: Bir PDF’in tüm sayfalarını bir kerede döndürebilir miyim?
C: Evet. Sayfa numaraları üzerinden döngü kurarak her sayfa için rotatePage(page, Rotation.ON_90_DEGREE) metodunu çağırın.

S: Döndürme orijinal PDF dosyasını etkiler mi?
C: Hayır. Döndürme yalnızca render sürecinde uygulanır; kaynak PDF değişmez.

S: PDF bir şifreyle korumalıysa ne olur?
C: Viewer örneğini oluştururken şifreyi sağlayın: new Viewer(path, password).

S: HtmlViewOptions ayarlarken “null pointer” hatasını nasıl ayıklayabilirim?
C: Çıktı dizininin mevcut olduğundan ve pageFilePathFormat‘in doğru çözüldüğünden emin olun.

S: Sayfaları diğer formatlara (ör. PNG) dönüştürürken döndürmenin bir yolu var mı?
C: Evet. Hedef format için uygun view seçenekleriyle aynı rotatePage yapılandırmasını kullanın.

Kaynaklar

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

İlgili Eğitimler