Sayfayı 90 derece döndürme GroupDocs Viewer for Java ile

Eğer bir belgede sayfayı 90 derece döndürmeniz gerekiyorsa—PDF, Word dosyası ya da elektronik tablo olsun—Java’da programatik olarak yapmak zamanı tasarruf ettirir, manuel hataları ortadan kaldırır ve işlemi otomatikleştirilmiş akışlara entegre etmenizi sağlar. Bu ileri düzey rehberde, GroupDocs Viewer for Java kullanarak herhangi bir desteklenen belgenin ilk sayfasını nasıl döndüreceğinizi, bu yeteneğin gerçek dünya projelerinde neden önemli olduğunu ve süreci nasıl hafif ve bellek‑verimli tutacağınızı öğreneceksiniz.

Rotate the First Page of a Document with GroupDocs.Viewer for Java

Hızlı yanıtlar

  • “Sayfayı 90 derece döndürmek” ne anlama geliyor? Seçilen sayfayı saat yönünde çeyrek tur döndürür.
  • Döndürmeyi hangi kütüphane gerçekleştiriyor? GroupDocs Viewer for Java rotatePage metodunu sağlar.
  • PDF sayfalarını Java ile döndürebilir miyim? Evet—aynı rotatePage çağrısını kullanın; PDF, DOCX, XLSX ve daha fazlası için çalışır.
  • Lisans gerekli mi? Geliştirme için ücretsiz deneme yeterlidir; üretim için ücretli lisans gerekir.
  • İşlem bellek‑ağır mı? Viewer örneğini hemen kapatırsanız değil; aşağıdaki performans ipuçlarına bakın.

“Sayfayı 90 derece döndürmek” nedir?

Bir sayfayı 90 derece döndürmek, sayfayı portre konumundan manzara konumuna (veya tersine) yeniden yönlendirir, içerik değişmeden kalır. Sunumlar, yalnızca manzara grafiklerinin yazdırılması veya yan yatmış taranmış belgelerin düzeltilmesi için kullanışlıdır. Döndürme, render zamanında uygulanır ve orijinal dosya değişmez.

Neden GroupDocs Viewer for Java ile programatik olarak sayfaları döndürmeliyiz?

GroupDocs Viewer 50+ giriş ve çıkış formatını destekler—PDF, DOCX, PPTX, XLSX ve birçok görüntü türü dahil—bu sayede dış dönüştürücülere ihtiyaç duymadan herhangi bir belgeyi render edebilirsiniz. API akıcı, çok‑thread‑güvenli ve Java 8+ ortamında çalışır, bu da kurumsal‑düzey otomasyon için tutarlı dosya tipi işleme imkanı verir.

Önkoşullar

  • GroupDocs Viewer for Java (en son sürüm)
  • JDK 8 veya üzeri
  • Maven (veya Gradle) bağımlılık yönetimi için
  • IntelliJ IDEA veya Eclipse gibi bir IDE
  • Java I/O konusunda temel bilgi

GroupDocs.Viewer for Java kurulumu

pom.xml dosyanıza GroupDocs deposunu ve bağımlılığı ekleyin. Bu snippet orijinal öğreticideki gibi değişmeden kalır:

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

  • Ücretsiz deneme – GroupDocs sitesinden indirin.
  • Geçici lisans – daha uzun bir değerlendirme süresi gerekiyorsa talep edin.
  • Tam lisans – üretim dağıtımları için satın alın.

Temel Viewer başlatma

Viewer sınıfı, bir belgeyi yükleyen ve render ve dönüşüm metodlarını sunan giriş noktasıdır. Kodu tam olarak gösterildiği gibi tutun:

import com.groupdocs.viewer.Viewer;

// Initialize Viewer with your document path
try (Viewer viewer = new Viewer("path/to/your/document.docx")) {
    // Perform operations...
}

PDF sayfasını Java ile nasıl döndürürüz

Hedef dosyayı Viewer ile yükleyin, sayfa numarasını belirtin ve rotatePage metodunu çağırın. Metod PDF, DOCX, PPTX, XLSX ve kütüphanenin desteklediği diğer formatlar için çalışır. Döndürmeden sonra belgeyi yeni bir PDF olarak render edebilir ya da doğrudan istemciye akıtabilirsiniz; böylece orijinal dosya dokunulmaz kalır.

Adım‑adım uygulama: ilk sayfayı 90 derece döndürme

1. Gerekli paketleri içe aktarın

PdfViewOptions Viewer’ın PDF dosyası üretmesini söyler, Rotation enum’u ise açıyı tanımlar. Her iki sınıf da com.groupdocs.viewer.options paketindedir.

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
import com.groupdocs.viewer.options.Rotation;

2. Çıktı konumlarını tanımlayın ve Viewer’ı oluşturun

Yer tutucu yolları gerçek dizinlerinizle değiştirin. Viewer yapıcı, kaynak belgeye işaret eden bir File nesnesi alır.

import java.nio.file.Path;

public class RotateSpecificPage {
    public static void run() {
        Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RotateSpecificPage");
        Path outputFilePath = outputDirectory.resolve("output.pdf");

        try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("Sample.docx"))) {
            // Proceed with the rotation steps below...
        }
    }
}

3. PDF görüntü seçeneklerini yapılandırın ve döndürmeyi uygulayın

rotatePage(int, Rotation) metodu 1‑tabanlı sayfa indeksi ve bir Rotation enum değeri alır. Bu örnekte ilk sayfayı saat yönünde döndürmek için Rotation.ON_90_DEGREE kullanıyoruz.

PdfViewOptions viewOptions = new PdfViewOptions(outputFilePath);

// Specify which page to rotate (1 for first page) and the rotation angle
viewOptions.rotatePage(1, Rotation.ON_90_DEGREE);

4. Belgeyi render edin

Yapılandırılmış seçeneklerle view metodunu çağırmak, döndürülmüş PDF’i çıktı klasörüne yazar.

viewer.view(viewOptions);

Nasıl çalışır

  • PdfViewOptions Viewer’ın PDF çıktı dosyası üretmesini sağlar.
  • rotatePage(int, Rotation) yalnızca belirtilen sayfayı döndürür, diğer sayfalar değişmez.
  • Metod üç döndürme sabitini destekler: ON_90_DEGREE, ON_180_DEGREE ve ON_270_DEGREE.

Yaygın sorunlar ve çözümler

BelirtiMuhtemel nedenÇözüm
FileNotFoundExceptionYanlış yol veya eksik klasörYOUR_OUTPUT_DIRECTORY ve YOUR_DOCUMENT_DIRECTORY var ve okunabilir olduğundan emin olun.
Unsupported file formatViewer’ın desteklemediği bir formatı döndürmeye çalışmak[GroupDocs Viewer supported formats] sayfasını kontrol edin.
No rotation visibleYanlış sayfa numarası (0‑tabanlı) kullanmakrotatePage metodunun 1‑tabanlı indeksleme kullandığını unutmayın.
Out‑of‑memory errors on large docsTek bir iş parçacığında çok sayıda büyük dosya render edilmesiBelgeleri sıralı işleyin veya sınırlı eşzamanlılıkla bir iş parçacığı havuzu kullanın.

Pratik uygulamalar

  1. Sunum ayarlamaları – Portre slaytı, görsel etkiyi artırmak için anında manzaraya çevirin.
  2. Toplu belge düzeltmesi – Yan yatmış taranmış PDF’leri otomatik olarak düzeltin, saatlerce süren manuel işi ortadan kaldırın.
  3. Baskıya hazır çıktı – Manzara grafikleri, portre yönündeki kağıda manuel sürükleme yapmadan doğru şekilde basılsın.

Performans ipuçları

  • Kaynakları hemen kapatın – try‑with‑resources bloğu Viewer’ı otomatik olarak serbest bırakır, belleği boşaltır.
  • Toplu işleme – Her iş parçacığı için tek bir Viewer örneği yeniden kullanarak başlatma maliyetini azaltın.
  • Belleği izleyin – 100 MB’dan büyük belgeler için çıktıyı bellekte tutmak yerine diske akıtın; GroupDocs Viewer 200 MB dosyaları 250 MB’dan az RAM kullanarak işleyebilir.

Sıkça sorulan sorular

S: Birden fazla sayfayı aynı anda döndürebilir miyim?
C: Evet—döndürmek istediğiniz her sayfa için rotatePage() metodunu bir döngü içinde ya da zincirleme çağırabilirsiniz.

S: Render sonrası döndürmeyi geri almanın bir yolu var mı?
C: Doğrudan yok. Döndürme seçenekleri olmadan belgeyi yeniden render etmeniz gerekir.

S: GroupDocs Viewer’da hangi dosya formatları sayfa döndürmeyi destekliyor?
C: DOCX, PDF, PPTX, XLSX ve resmi dokümantasyonda listelenen birçok diğer format.

S: Belgeler topluluğunda sayfaları otomatik olarak nasıl döndürürüm?
C: Dosya yolu koleksiyonunu dolaşan bir döngüye döndürme mantığını yerleştirerek aynı rotatePage yapılandırmasını her dosyaya uygulayın.

S: Döndürme sırasında hataları yönetmenin en iyi yolu nedir?
C: Viewer kullanımını bir try‑catch bloğuna alın, istisna detaylarını kaydedin ve isteğe bağlı olarak sonraki dosyaya geçerek tek bir hatanın tüm toplu işlemi durdurmasını önleyin.

Kaynaklar

Son Güncelleme: 2026-09-30
Test Edilen Versiyon: GroupDocs Viewer 25.2 for Java
Yazar: GroupDocs

İlgili Öğreticiler