Menambahkan catatan khusus atau watermark sering kali memerlukan Anda menambahkan teks ke PDF dalam aplikasi Java. Conholdate.Total for Java adalah SDK yang kuat yang memungkinkan pengembang mengedit file PDF secara programatis. Panduan ini memandu Anda melalui prasyarat, penjelasan kode secara detail, dan contoh lengkap sehingga Anda dapat menambahkan teks khusus di atas PDF yang ada dengan mudah.

Prasyarat dan Penyiapan

Sebelum Anda memulai, pastikan Anda memiliki hal berikut:

  • Java 8 atau yang lebih tinggi terpasang.
  • Maven untuk manajemen dependensi.
  • IDE seperti IntelliJ IDEA atau Eclipse.
  • Lisensi Conholdate.Total for Java yang valid untuk penggunaan produksi (lihat bagian lisensi nanti).

Tambahkan repositori Maven Conholdate dan dependensi SDK ke pom.xml Anda:

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

Unduh binary SDK terbaru dari halaman unduhan. Setelah proses build Maven berhasil, Anda siap untuk mulai menulis kode. Bagian berikutnya menunjukkan secara tepat cara memuat PDF dan menyisipkan teks.

Menambahkan Teks ke PDF dalam Java: Panduan Langkah demi Langkah

Berikut adalah penjelasan singkat tentang setiap langkah logis. Kode sumber lengkap direproduksi nanti di bagian Contoh Kode Lengkap.

Langkah 1: Buka PDF dan Buat TextBuilder

Pertama, buka PDF sumber dengan kelas Document, kemudian buat TextBuilder yang mengarah ke halaman tempat Anda ingin menambahkan teks.

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

Kelas Document dan TextBuilder didokumentasikan di referensi API.

Langkah 2: Buat dan Konfigurasikan TextParagraph

Buat sebuah TextParagraph dan konfigurasikan tata letaknya: indent yang diterapkan pada baris berikutnya, persegi panjang yang membatasi area teks pada halaman, dan mode pembungkus kata.

// 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);

Langkah 3: Buat TextFragment dan Konfigurasikan Font

Buat TextFragment yang berisi teks yang ingin Anda overlay, lalu atur font dan ukuran font‑nya melalui getTextState().

// 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);

Langkah 4: Tambahkan Fragmen dan Paragraf

Tambahkan fragmen teks sebagai baris di dalam paragraf, lalu tambahkan paragraf ke halaman melalui TextBuilder.

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

Langkah 5: Simpan PDF yang Dimodifikasi

Akhirnya, buat jalur output dan simpan dokumen yang dihasilkan.

dataDir = dataDir + "AddText_out.pdf";

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

Dengan langkah‑langkah ini, Anda telah menyelesaikan alur kerja penyisipan teks PDF.

Contoh Kode Lengkap: Menyisipkan Teks ke PDF di Java

Contoh berikut menunjukkan seluruh proses mulai dari memuat file sumber hingga menyimpan PDF yang diperbarui.

Contoh ini menunjukkan cara menambahkan teks ke PDF yang sudah ada menggunakan Conholdate.Total for Java.

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);
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui dataDir agar mengarah ke direktori dokumen Anda yang sebenarnya (yang berisi Conholdate.pdf), verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Kesimpulan

Dalam tutorial ini kami menunjukkan cara menambahkan teks ke PDF di Java menggunakan fitur kuat dari Conholdate.Total for Java. Dengan mengikuti panduan langkah demi langkah, Anda dapat dengan andal membuat paragraf teks dengan TextBuilder dan TextParagraph, mengontrol gaya font melalui TextFragment, dan menyimpan dokumen yang telah dimodifikasi. SDK menangani koordinat halaman PDF dan rendering teks secara internal, sehingga Anda dapat fokus pada logika bisnis. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; Anda dapat mendapatkan lisensi sementara dari halaman lisensi sementara atau menjelajahi opsi harga pada halaman harga. Dengan alat-alat ini, meningkatkan PDF dengan teks khusus menjadi bagian yang mudah dalam aplikasi Java Anda.

FAQs

  • Bagaimana cara menambahkan teks ke PDF di Java tanpa menimpa konten yang ada?
    Gunakan builder.appendParagraph(paragraph) seperti yang ditunjukkan dalam contoh; TextBuilder menambahkan paragraf baru ke halaman target, mempertahankan semua konten yang ada.

  • Apakah memungkinkan menambahkan teks watermark khusus ke PDF dalam Java?
    Ya. Pendekatan yang sama berlaku untuk watermark — buat TextFragment dengan teks watermark yang diinginkan, konfigurasikan font dan ukuran yang sesuai (atau transparansi melalui state teks), dan tambahkan melalui TextParagraph pada setiap halaman.

  • Apa yang harus saya lakukan jika teks yang dimasukkan tidak muncul dengan benar untuk bahasa tertentu?
    Pilih font yang mendukung set karakter yang diperlukan dengan FontRepository.findFont(). SDK menghormati pengaturan font yang diterapkan melalui getTextState(), dan dokumentasi memberikan panduan tentang penanganan skrip yang berbeda.

  • Apakah saya dapat memproses batch beberapa PDF untuk menambahkan teks yang sama?
    Tentu saja. Bungkus kode di dalam loop yang mengiterasi daftar jalur file, menggunakan kembali logika Document/TextBuilder yang sama untuk setiap file.

Baca Selengkapnya