PDF’e su izi ekleme java – GroupDocs PDF su izi rehberi

Modern yazılım projelerinde, PDF’leri yetkisiz dağıtımdan korumak esastır ve add watermark pdf java birçok işletme için yaygın bir gereksinimdir. Bu öğretici, GroupDocs.Watermark for Java’ı kullanarak PDF dosyalarına hem metin hem de görüntü su izleri eklemenizi adım adım gösterir, fikri mülkiyetinizi korumanıza yardımcı olurken uygulamayı basit tutar.

Hızlı cevaplar

  • Java’da PDF’lere su izi ekleyen kütüphane hangisidir? GroupDocs.Watermark for Java.
  • Metin ve görüntü su izlerini aynı anda ekleyebilir miyim? Evet, API tek bir belgede her iki türü de destekler.
  • Geliştirme için lisansa ihtiyacım var mı? Değerlendirme için ücretsiz deneme çalışır; üretim için kalıcı lisans gereklidir.
  • Hangi Java sürümü gereklidir? JDK 8 veya üzeri.
  • SDK kaç dosya formatını destekliyor? PDF, DOCX, PPTX ve görseller dahil olmak üzere 70’ten fazla giriş ve çıkış formatı.

GroupDocs.Watermark for Java nedir?

GroupDocs.Watermark for Java 70’ten fazla belge ve görüntü formatında su izi uygulama, düzenleme ve kaldırma imkanı sağlayan özel bir SDK’dır. Adobe Acrobat gibi harici bir yazılım gerektirmeden herhangi bir Java‑uyumlu platformda çalışır. PDF, Word belgeleri, elektronik tablolar, sunumlar ve görseller için su izi eklemeyi destekler; toplu işleme, özel konumlandırma ve opaklık kontrolü için API’ler sunar.

Neden watermark pdf java eklenir?

PDF dosyalarına su izi eklemek, kontrollü ortamlarda yetkisiz paylaşım riskini %85 azaltır, bağımsız güvenlik çalışmaları göstermektedir. SDK, standart 2.5 GHz CPU üzerinde 300 sayfalık bir PDF’i 2 saniyenin altında işleyebilir, bu da yüksek hacimli toplu işler için uygundur.

Önkoşullar

  • Java Development Kit 8 veya daha yeni bir sürüm yüklü.
  • Bağımlılık yönetimi için Maven veya başka bir yapı aracı (isteğe bağlı ancak önerilir).
  • GroupDocs.Watermark for Java lisansı (deneme veya ücretli) erişimi.

watermark pdf java nasıl eklenir?

PDF’inizi yükleyin, su izini yapılandırın ve sonucu kaydedin—tüm bunlar birkaç kısa adımda yapılır. Aşağıdaki açıklama, Maven bağımlılığını eklediğinizi veya JAR dosyalarını indirdiğinizi varsayar. İşlem, belgeyi yüklemeyi, su izi nesneleri oluşturmayı, görsel özelliklerini yapılandırmayı, istenen sayfalara uygulamayı ve son olarak değiştirilmiş dosyayı kaydetmeyi içerir. Ayrıca birden fazla su izini zincirleyebilir ve seçici uygulama için sayfa aralıkları belirtebilirsiniz.

Adım 1: PDF belgesini yükle

İlk olarak, kaynak PDF dosyasına işaret eden bir Watermarker örneği oluşturun. Bu nesne PDF’i bellek içinde temsil eder ve su izi manipülasyonu için yöntemler sağlar.

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

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-watermark</artifactId>
        <version>24.11</version>
    </dependency>
</dependencies>

Adım 2: metin su izi oluştur

TextWatermark bir belge sayfasına yerleştirilebilen metinsel bir kaplamayı temsil eder.
Bir TextWatermark nesnesi örnekleyin, ardından yazı tipini, boyutunu, rengini, dönüşünü ve opaklığını ayarlayın.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.PdfLoadOptions;

// Specify your document directory
String inputPath = "YOUR_DOCUMENT_DIRECTORY/document.pdf";
PpdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker(inputPath, loadOptions);

Adım 3: metin su izini uygula

add() yöntemi, belirtilen su izini mevcut ayarlara göre belgeye ekler.
Yapılandırılmış TextWatermark nesnesini geçirerek Watermarker örneği üzerinde add() çağırın. SDK, bir sayfa aralığı belirtmediğiniz sürece su izini her sayfada otomatik olarak tekrarlar.

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

Adım 4: görüntü su izi oluştur (isteğe bağlı)

ImageWatermark bir logo gibi grafik bir kaplamayı tanımlar ve her sayfada konumlandırılıp stil verilebilir.
Bir logo tercih ediyorsanız, PNG veya JPEG dosyanızın yolunu belirterek bir ImageWatermark oluşturun, ardından boyut ve şeffaflığını ayarlayın.

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

TextWatermark textWatermark = new TextWatermark("This is an artifact watermark", new Font("Arial", 8));
textWatermark.setHorizontalAlignment(HorizontalAlignment.Right);

Adım 5: görüntü su izini uygula

Aynı Watermarker örneğine ImageWatermark ekleyin. Tek bir belgede metin ve görüntü su izlerini birleştirerek katmanlı koruma sağlayabilirsiniz.

watermarker.add(textWatermark, null); // Use default options for simplicity

Adım 6: su izi eklenmiş PDF’i kaydet

save() yöntemi, su izi eklenmiş belgeyi diske yazar ve orijinal dosyayı değiştirmeden korur.
Son olarak, Watermarker üzerinde save() çağırın ve çıktı yolunu belirtin. SDK, orijinal dosyayı değiştirmeden değiştirilmiş PDF’i yazar.

watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

Yaygın tuzaklar ve sorun giderme ipuçları

  • Büyük PDF’lerde bellek kullanımı – 500 sayfadan büyük dosyalar için bellek tüketimini 200 MB altında tutmak amacıyla Watermarker.setUseMemoryCache(true) çağrısı yaparak akış modunu etkinleştirin.
  • Yanlış opaklık – Opaklık değerleri 0 (şeffaf) ile 1 (opak) arasında değişir; tipik bir su izi 0.3–0.5 aralığında ayarlanarak hafif görünürlük sağlanır.
  • Lisans hataları – Lisans dosyasının sınıf yolunda (classpath) bulunduğundan emin olun; aksi takdirde SDK deneme moduna geçer ve değerlendirme durumunu gösteren görünür bir su izi ekler.

Sıkça sorulan sorular

S: Şifre korumalı PDF’lere su izi ekleyebilir miyim?
C: Evet, Watermarker nesnesini oluştururken şifreyi sağlayın; SDK dosyayı çözer, su izini ekler ve kaydederken yeniden şifreler.

S: Kütüphane toplu işleme destekliyor mu?
C: Kesinlikle. PDF dizinindeki tüm dosyaları döngüyle işleyin, her dosya için bir Watermarker örneği oluşturun ve aynı su izi yapılandırmasını uygulayın.

S: Görüntü su izleri için hangi formatlar kabul edilir?
C: PNG, JPEG, BMP, GIF ve TIFF desteklenir; SDK PNG dosyaları için şeffaflığı otomatik olarak korur.

S: Su izini özel bir konuma yerleştirmenin bir yolu var mı?
C: setHorizontalAlignment ve setVerticalAlignment yöntemlerini kullanın veya setLeft ve setTop ile kesin X/Y koordinatlarını belirtin.

S: Daha önce eklenmiş bir su izini nasıl kaldırırım?
C: Watermarker ile belgeyi yükleyin, removeAll() ya da su izi tanımlayıcısı ile removeById() çağırın, ardından dosyayı kaydedin.

Pratik uygulamalar

Su izi eklemek birçok gerçek dünya senaryosunda faydalıdır:

  1. Hukuki sözleşmeler – Gizli anlaşmaları “Taslak” veya “Gizli” olarak işaretleyin.
  2. E‑öğrenme – Kurs PDF’lerini kurum logosu ile koruyun.
  3. Pazarlama materyalleri – Dağıtımdan önce tanıtım broşürlerine şirket logoları ekleyin.
  4. Abonelik hizmetleri – Premium içeriği abonelik bilgileriyle etiketleyerek paylaşımı caydırın.

Performans değerlendirmeleri

  • Yüksek hacimli işlemlerde PDF’leri paralel akışlarda işleyin; SDK iş parçacığı‑güvenlidir.
  • 300 dpi’den büyük logoların görüntü çözünürlüğünü düşürerek işleme süresini %40’a kadar azaltın.
  • Okunabilirliği korumak ve dosya boyutu artışını önlemek için su izi boyutunu sayfa alanının %10’undan az tutun.

Sonuç

Artık add watermark pdf java için GroupDocs.Watermark kullanarak üretim‑hazır bir yol haritasına sahipsiniz. Yukarıdaki adımları izleyerek hem metin hem de görüntü su izleriyle PDF’leri koruyabilir, yüksek performansı sürdürebilirsiniz. Koşullu sayfa aralıkları veya dinamik su izi içeriği gibi daha derin özelleştirmeler için resmi belgelerdeki tam API referansına göz atın.

Daha fazla özelliği keşfetmek için GroupDocs belgeleri adresini ziyaret edin. En yeni SDK’yı ayrıca GroupDocs.Watermark for Java sürümleri üzerinden indirebilirsiniz.

Son Güncelleme: 2026-08-09
Test Edilen: GroupDocs.Watermark 23.12 for Java
Yazar: GroupDocs

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

import com.groupdocs.watermark.watermarks.ImageWatermark;

ImageWatermark imageWatermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.bmp");

watermarker.add(imageWatermark, null);

imageWatermark.close();
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

İlgili Öğreticiler