Özel notlar veya filigranlar eklemek genellikle Java uygulamalarında PDF dosyalarına metin eklemenizi gerektirir. Conholdate.Total for Java güçlü bir SDK’dır ve geliştiricilerin PDF dosyalarını programlı olarak düzenlemesini sağlar. Bu kılavuz, önkoşulları, ayrıntılı kod incelemesini ve tam bir örneği adım adım gösterir, böylece mevcut PDF’lerin üzerine kolayca özel metin yerleştirebilirsiniz.

Önkoşullar ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Java 8 veya daha yeni bir sürüm yüklü.
  • Bağımlılık yönetimi için Maven.
  • IntelliJ IDEA veya Eclipse gibi bir IDE.
  • Üretim kullanımı için geçerli bir Conholdate.Total for Java lisansı (daha sonra lisans bölümü bakınız).

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

En son SDK ikili dosyalarını indirme sayfasından indirin. Maven derlemesi başarılı olduğunda, kodlamaya başlamaya hazırsınız. Sonraki bölüm, bir PDF’yi nasıl yükleyeceğinizi ve metin ekleyeceğinizi tam olarak gösterir.

Java’da PDF’ye Metin Ekleme: Adım Adım Kılavuz

Aşağıda her mantıksal adımın kısa bir yürütmesi yer almaktadır. Tam kaynak kodu daha sonra Tam Kod Örneği bölümünde yeniden sunulmaktadır.

Adım 1: PDF’yi Açın ve TextBuilder Oluşturun

İlk olarak, kaynak PDF’yi Document sınıfı ile açın, ardından metin eklemek istediğiniz sayfayı işaret eden bir TextBuilder oluşturun.

String dataDir = "path/to/your/document/directory/";

// Open document
Document doc = new Document(dataDir + "Conholdate.pdf");
TextBuilder builder = new TextBuilder(doc.getPages().get_Item(1));

Document ve TextBuilder sınıfları, API referansı içinde belgelenmiştir.

Adım 2: TextParagraph Oluşturun ve Yapılandırın

Bir TextParagraph oluşturun ve düzenini yapılandırın: sonraki satırlara uygulanan girinti, sayfadaki metin alanını sınırlayan dikdörtgen ve kelime kaydırma modu.

// Create text paragraph
TextParagraph paragraph = new TextParagraph();
// Set subsequent lines indent
paragraph.setSubsequentLinesIndent(20);
// Specify the location to add TextParagraph
paragraph.setRectangle(new Rectangle(100, 300, 200, 700));
// Specify word wrapping mode
paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);

Adım 3: TextFragment oluşturun ve Yazı tipini yapılandırın

Üstüne yerleştirmek istediğiniz metni içeren bir TextFragment oluşturun, ardından getTextState() aracılığıyla yazı tipini ve yazı tipi boyutunu ayarlayın.

// Create text fragment
TextFragment fragment1 = new TextFragment("the quick brown fox jumps over the lazy dog");
fragment1.getTextState().setFont(FontRepository.findFont("Times New Roman"));
fragment1.getTextState().setFontSize(12);

Adım 4: Parçayı ve Paragrafı Ekleyin

Metin parçacığını paragraf içinde bir satır olarak ekleyin, ardından paragrafı TextBuilder aracılığıyla sayfaya ekleyin.

// Add fragment to paragraph
paragraph.appendLine(fragment1);
// Add paragraph
builder.appendParagraph(paragraph);

Adım 5: Değiştirilmiş PDF’yi Kaydedin

Son olarak, çıktı yolunu oluşturun ve oluşan belgeyi kaydedin.

dataDir = dataDir + "AddText_out.pdf";

// Save resulting PDF document.
doc.save(dataDir);

Bu adımlarla PDF metin ekleme iş akışını tamamladınız.

Tam Kod Örneği: Java’da PDF’ye Metin Ekleme

Aşağıdaki örnek, kaynak dosyanın yüklenmesinden güncellenmiş PDF’nin kaydedilmesine kadar olan tüm süreci gösterir.

Bu örnek, Conholdate.Total for Java kullanarak mevcut bir PDF’ye metin eklemeyi gösterir.

import com.aspose.pdf.Document;
import com.aspose.pdf.TextBuilder;
import com.aspose.pdf.TextParagraph;
import com.aspose.pdf.Rectangle;
import com.aspose.pdf.TextFormattingOptions;
import com.aspose.pdf.TextFragment;
import com.aspose.pdf.FontRepository;

public class AddTextToPdf {
    public static void main(String[] args) {
        String dataDir = "path/to/your/document/directory/";

// Open document
        Document doc = new Document(dataDir + "Conholdate.pdf");
        TextBuilder builder = new TextBuilder(doc.getPages().get_Item(1));

// Create text paragraph
        TextParagraph paragraph = new TextParagraph();
        // Set subsequent lines indent
        paragraph.setSubsequentLinesIndent(20);
        // Specify the location to add TextParagraph
        paragraph.setRectangle(new Rectangle(100, 300, 200, 700));
        // Specify word wrapping mode
        paragraph.getFormattingOptions().setWrapMode(TextFormattingOptions.WordWrapMode.ByWords);

// Create text fragment
        TextFragment fragment1 = new TextFragment("the quick brown fox jumps over the lazy dog");
        fragment1.getTextState().setFont(FontRepository.findFont("Times New Roman"));
        fragment1.getTextState().setFontSize(12);

// Add fragment to paragraph
        paragraph.appendLine(fragment1);
        // Add paragraph
        builder.appendParagraph(paragraph);

dataDir = dataDir + "AddText_out.pdf";

// Save resulting PDF document.
        doc.save(dataDir);
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dataDir değişkenini gerçek belge dizininize (içinde Conholdate.pdf bulunan) işaret edecek şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler bölümüne bakın veya destek ekibi ile iletişime geçin.

Sonuç

Bu öğreticide, Java’da PDF’ye metin eklemeyi, Conholdate.Total for Java robust özelliklerini kullanarak gösterdik. Adım adım kılavuzu izleyerek, TextBuilder ve TextParagraph ile metin paragraflarını güvenilir bir şekilde oluşturabilir, TextFragment aracılığıyla yazı tipi stilini kontrol edebilir ve değiştirilmiş belgeyi kaydedebilirsiniz. SDK, PDF sayfa koordinatlarını ve metin render’ını dahili olarak yönetir, böylece iş mantığına odaklanabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; geçici bir lisansı geçici lisans sayfası üzerinden edinebilir veya fiyatlandırma sayfası adresindeki fiyat seçeneklerini inceleyebilirsiniz. Bu araçlarla, PDF’leri özel metinle zenginleştirmek Java uygulamanızın basit bir parçası haline gelir.

SSS

  • Java’da mevcut içeriği üzerine yazmadan PDF’ye metin nasıl eklenir?
    Örnekte gösterildiği gibi builder.appendParagraph(paragraph) kullanın; TextBuilder yeni paragrafı hedef sayfaya ekler ve mevcut içeriği korur.

  • Java’da PDF’ye özel bir filigran metni eklemek mümkün mü?
    Evet. Aynı yaklaşım filigranlar için de çalışır — istenen filigran metniyle bir TextFragment oluşturun, uygun bir yazı tipi ve boyut (ya da metin durumu aracılığıyla şeffaflık) yapılandırın ve her sayfada bir TextParagraph aracılığıyla ekleyin.

  • Belirli diller için eklenen metin doğru görünmüyorsa ne yapmalıyım?
    Gerekli karakter kümesini destekleyen bir yazı tipini FontRepository.findFont() ile seçin. SDK, getTextState() aracılığıyla uygulanan yazı tipi ayarlarına saygı gösterir ve belgeleme farklı betiklerin nasıl ele alınacağına dair rehberlik sağlar.

  • Birden fazla PDF’yi aynı metni eklemek için toplu işleyebilir miyim?
    Kesinlikle. Kodunuzu, dosya yolları listesini yineleyen bir döngü içinde sarın ve her dosya için aynı Document/TextBuilder mantığını yeniden kullanın.

Daha Fazla Oku