GroupDocs.Watermark for Java ile PDF’ye su işareti ekleme

Bu rehberde GroupDocs.Watermark Java SDK’sını kullanarak PDF dosyalarına su işareti eklemeyi öğreneceksiniz. Belgeleri diskten, akışlardan veya şifre korumalı kaynaklardan yükleme, metin veya görüntü su işaretleri uygulama ve sonunda güncellenmiş PDF’yi kaydetme adımlarını göstereceğiz. İster toplu işlemci ister tek dosya servisi oluşturuyor olun, bu adımlar güvenilir, üretime hazır bir çözüm sunar.

Hızlı cevaplar

  • Şifre korumalı bir PDF’ye su işareti ekleyebilir miyim? Evet – belgeyi yüklerken şifreyi geçin, ardından su işaretini normal şekilde uygulayın.
  • Hangi formatlar su işareti eklenebilir? PDF, DOCX, PPTX ve görüntüler dahil olmak üzere 30’dan fazla format.
  • Geliştirme için lisansa ihtiyacım var mı? Test için geçici bir lisans yeterlidir; üretim için tam lisans gereklidir.
  • Hangi Java sürümü gereklidir? Java 8 veya üzeri desteklenir.
  • Akış (streaming) destekleniyor mu? Kesinlikle – InputStream‘den yükleyebilir ve OutputStream‘e kaydedebilirsiniz, dosya sistemine dokunmadan.

PDF’ye su işareti ekleme nedir?

Add watermark to pdf PDF belgesinin her sayfasına yarı saydam metin veya görüntü ekleyerek sahiplik, gizlilik veya marka göstermek için kullanılan bir işlemdir. GroupDocs.Watermark for Java, konumlandırma, opaklık ve sayfa aralığı seçimini otomatik olarak yöneten tek‑çağrı API’si sunar.

Neden GroupDocs.Watermark for Java kullanmalısınız?

GroupDocs.Watermark 35+ dosya formatını destekler ve tipik bir sunucu sınıfı CPU’da 500 sayfalık PDF’leri 2 saniyeden kısa sürede işleyebilir. Kütüphane tamamen bellek içinde çalışır, bu yüzden Microsoft Office veya Adobe Acrobat kurmanıza gerek yoktur. API’si çoklu iş parçacığı (thread‑safe) olduğundan yüksek verimli web servisleri için idealdir.

Önkoşullar

  • Java 8 veya daha yeni bir sürüm yüklü.
  • Maven veya Gradle projesi, groupdocs-watermark bağımlılığıyla yapılandırılmış.
  • Geçerli bir GroupDocs.Watermark lisansı (değerlendirme için geçici lisans).
  • Koruma altına almak istediğiniz PDF dosyaları, isteğe bağlı olarak şifreli.

PDF’ye su işareti ekleme – adım adım

Kaynak belgeyi yükleyin, su işareti uygulayın ve ardından sonucu kaydedin. Aşağıdaki bölümler her alt görevi doğrudan yanıtlar.

Bir belgeyi diskten nasıl yükleriz?

Watermarker, su işareti eklemek için belgeleri yüklemek ve manipüle etmekte kullanılan birincil sınıftır. Watermarker yapıcıya tam dosya yolunu verin; SDK dosya formatını otomatik olarak algılar, içeriği doğrular ve belgeyi bellek içine yükler, böylece herhangi bir su işareti işlemi için hazır olur. Bu yöntem PDF’ler, Word dosyaları, görüntüler ve diğer birçok desteklenen tip için çalışır.

Watermarker watermarker = new Watermarker("C:/files/input.pdf");

Bu satırdan sonra PDF tamamen bellek içinde yüklenir, herhangi bir su işareti işlemi için hazırdır.

Bir belgeyi akıştan (stream) nasıl yükleriz?

Watermarker, belgeleri doğrudan bellekten yüklemek için bir InputStream de kabul edebilir. HTTP üzerinden ya da bir mesaj kuyruğu aracılığıyla bir dosya aldığınızda, bayt dizisini bir ByteArrayInputStream içine sarın ve InputStream kabul eden Watermarker yapıcısına geçirin. SDK, akışı diske yazmadan okur, performans ve güvenliği korur ve verileri parçalara bölerek büyük dosyaları destekler. Bu yöntem web servisleri ve mikro‑servis mimarileri için idealdir.

InputStream pdfStream = new ByteArrayInputStream(pdfBytes);
Watermarker watermarker = new Watermarker(pdfStream);

SDK, akışı diske yazmadan okur, performans ve güvenliği korur.

Şifre korumalı bir belgeyi nasıl yüklersiniz?

Watermarker, şifre korumalı PDF’leri ikinci bir argüman olarak şifreyi sağlayarak yüklemeyi destekler. Şifreyi yapıcıya ikinci argüman olarak verin. SDK, PDF’yi anında çözer ve ardından belgeyi diğer belgeler gibi kullanabilirsiniz. Şifre doğruysa, tüm sayfalar su işareti eklemek için erişilebilir olur; aksi takdirde kütüphane, sorun giderme için yakalayıp kaydedebileceğiniz açık bir istisna fırlatır.

Watermarker watermarker = new Watermarker("C:/files/secure.pdf", "mySecretPwd");

Şifre yanlış ise, SDK yakalayıp kaydedebileceğiniz bilgilendirici bir istisna fırlatır.

Metin su işareti nasıl uygulanır?

TextWatermark, özelleştirilebilir stil ile sayfalara uygulanabilen metinsel bir su işaretini temsil eder. İstediğiniz metin, yazı tipi, boyut ve renk ile bir TextWatermark nesnesi oluşturun. Ardından Watermarker örneğinde add metodunu çağırın, isteğe bağlı olarak sayfa aralıklarını belirtebilirsiniz. Su işareti belirtilen opaklık ve döndürme ile işlenir ve önceden tanımlı konumlar ya da özel koordinatlar kullanılarak konumlandırılabilir, böylece tüm sayfalarda tutarlı bir görünüm sağlanır.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 36));
watermark.setColor(Color.RED);
watermark.setTransparency(0.5);
watermarker.add(watermark);

Bu çağrı, varsayılan olarak su işaretini her sayfaya yerleştirir; gerekirse new PageRange(1, 5) ile sınırlayabilirsiniz.

Görsel su işareti nasıl uygulanır?

ImageWatermark, bir logo veya mühür gibi görüntü tabanlı bir su işaretini temsil eder. Logonuzun yolu ya da akışı ile bir ImageWatermark örneği oluşturun, ardından metin su işareti gibi ekleyin. SDK, görüntüyü sayfaya sığacak şekilde otomatik olarak ölçeklendirir ve en boy oranını korur; opaklık, döndürme ve yerleşimi ayarlayarak orijinal içeriği bozmadan istenen görsel etkiyi elde edebilirsiniz.

ImageWatermark imgWatermark = new ImageWatermark("C:/images/logo.png");
imgWatermark.setTransparency(0.3);
watermarker.add(imgWatermark);

SDK, görüntüyü sayfaya sığacak şekilde ölçeklendirir ve en boy oranını korur.

Su işaretli belgeyi nasıl kaydederiz?

save, değiştirilmiş belgeyi seçilen formatta belirtilen konuma yazar. Çıktı yolunu ve istenen formatı belirterek save metodunu çağırın. Format parametresini atladığınızda kaynakla aynı format kullanılır. Metod, yeni eklenen su işareti katmanları dışındaki tüm orijinal içeriği koruyarak değiştirilmiş PDF’yi diske yazar ve daha fazla işleme için akışa kaydetmeyi de destekler.

watermarker.save("C:/files/output.pdf");

Metod, yeni eklenen su işareti katmanları dışındaki tüm orijinal içeriği koruyarak değiştirilmiş PDF’yi diske yazar.

Mevcut öğreticiler

Java’da GroupDocs.Watermark Kullanarak Şifre Koruması Olan Belgeleri Nasıl Yüklenir

GroupDocs.Watermark for Java kullanarak şifre korumalı belgelerde su işaretlerini nasıl yükleyeceğinizi ve yöneteceğinizi öğrenin. Bu kılavuz adım adım talimatlar, pratik örnekler ve sorun giderme ipuçları sunar.

Java’da GroupDocs.Watermark Kullanarak Şifre Koruması Olan Word Belgelerini Yükleme ve Su İşareti Ekleme

GroupDocs.Watermark’i Java ile kullanarak şifre korumalı Word belgelerini verimli bir şekilde yüklemeyi, yönetmeyi ve su işareti eklemeyi öğrenin.

Ek kaynaklar

Yaygın sorunlar ve çözümler

  • Geçersiz şifre hatası – şifre dizesini iki kez kontrol edin; UTF‑8 olarak kodlanmış olmalı.
  • Büyük PDF’lerde bellek yetersizliği – InputStream ve OutputStream kabul eden Watermarker yapıcılarını kullanarak akış (streaming) modunu etkinleştirin.
  • Su işareti görünmüyor – su işaretinin opaklığının 0.1’in üzerinde olduğundan ve rengin sayfa arka planıyla kontrast oluşturduğundan emin olun.

Sıkça Sorulan Sorular

S: Aynı PDF’ye birden fazla su işareti ekleyebilir miyim?
C: Evet. Farklı TextWatermark veya ImageWatermark nesneleriyle watermarker.add() metodunu tekrar tekrar çağırın; her biri eklenme sırasına göre katmanlanır.

S: Kütüphane mevcut açıklamaları (annotations) korur mu?
C: Kesinlikle. Açıklamalar, form alanları ve meta veriler dahil olmak üzere tüm orijinal PDF nesneleri, açıkça değiştirilmedikçe dokunulmaz kalır.

S: Sadece seçili sayfalara su işareti eklemek mümkün mü?
C: Evet. add metoduna bir PageRange (ör. new PageRange(2, 4)) geçirerek su işaretini belirli sayfalara sınırlayabilirsiniz.

S: Desteklenen maksimum dosya boyutu nedir?
C: SDK, akış mimarisi sayesinde belgeyi tamamen belleğe yüklemeden 2 GB‘a kadar dosyaları işleyebilir.

S: Eklenmiş bir su işaretini nasıl kaldırırım?
C: İlk su işaretini eklediğinizde dönen kimlik (watermarkId) ile watermarker.remove(watermarkId) metodunu kullanın.

Son Güncelleme: 2026-09-16
Test edilen sürüm: GroupDocs.Watermark 23.9 for Java
Yazar: GroupDocs

İlgili Öğreticiler