iText - Tautan Anotasi

Pada bab ini, kita akan melihat bagaimana menambahkan anotasi tautan ke dokumen PDF menggunakan pustaka iText.

Membuat Anotasi Tautan dalam PDF

Anda dapat membuat Dokumen PDF kosong dengan membuat instance Documentkelas. Saat membuat instance kelas ini, Anda harus meneruskan aPdfDocument objek sebagai parameter untuk konstruktornya.

Untuk menggunakan anotasi teks dalam dokumen PDF Anda, Anda perlu membuat objek kelas PdfTextAnnotation dan menambahkannya ke PdfPage.

Berikut adalah langkah-langkah untuk menggunakan anotasi teks dalam dokumen PDF.

Langkah 1: Membuat objek PdfWriter

Itu PdfWriterkelas mewakili DocWriter untuk PDF. Kelas ini termasuk dalam paketcom.itextpdf.kernel.pdf. Konstruktor kelas ini menerima string, yang mewakili jalur file tempat PDF akan dibuat.

Instantiate PdfWriter kelas dengan meneruskan nilai string (mewakili jalur tempat Anda perlu membuat PDF) ke konstruktornya, seperti yang ditunjukkan di bawah ini.

// Creating a PdfWriter 
String dest = "C:/itextExamples/linkAnnotation.pdf"; 
PdfWriter writer = new PdfWriter(dest);

Saat objek jenis ini diteruskan ke PdfDocument (kelas), setiap elemen yang ditambahkan ke dokumen ini akan ditulis ke file yang ditentukan.

Langkah 2: Membuat objek PdfDocument

Itu PdfDocumentkelas adalah kelas yang mewakili Dokumen PDF di iText. Kelas ini termasuk dalam paketcom.itextpdf.kernel.pdf. Untuk membuat instance kelas ini (dalam mode menulis), Anda perlu meneruskan objek kelasPdfWriter ke konstruktornya.

Membuat instance kelas PdfDocument dengan meneruskan PdfWriter menolak konstruktornya, seperti yang ditunjukkan di bawah ini.

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

Setelah objek PdfDocument dibuat, Anda dapat menambahkan berbagai elemen seperti halaman, font, lampiran file, dan penanganan kejadian menggunakan metode masing-masing yang disediakan oleh kelasnya.

Langkah 3: Membuat objek Dokumen

Itu Document kelas paket com.itextpdf.layoutadalah elemen root saat membuat PDF mandiri. Salah satu konstruktor kelas ini menerima objek kelasPdfDocument.

Instantiate Document kelas dengan melewatkan objek kelas PdfDocument yang dibuat pada langkah sebelumnya, seperti yang ditunjukkan di bawah ini.

// Creating a Document  
Document document = new Document(pdfDoc);

Langkah 4: Membuat objek PdfAnnotation

Itu PdfAnnotation kelas paket com.itextpdf.kernel.pdf.annot mewakili superclass dari semua anotasi.

Di antara kelas turunannya, PdfLinkAnnotationkelas mewakili anotasi tautan. Buat objek kelas ini, seperti yang ditunjukkan di bawah ini.

// Creating a PdfLinkAnnotation object 
Rectangle rect = new Rectangle(0, 0); 
PdfLinkAnnotation annotation = new PdfLinkAnnotation(rect);

Langkah 5: Mengatur tindakan anotasi

Setel tindakan ke anotasi menggunakan setAction() metode dari PdfLinkAnnotation kelas, seperti yang ditunjukkan di bawah ini.

// Setting action of the annotation 
PdfAction action = PdfAction.createURI("http: // www.tutorialspoint.com/"); 
annotation.setAction(action);

Langkah 6: Membuat tautan

Buat link dengan membuat instance Link kelas paket com.itextpdf.layout.element, seperti yang ditunjukkan di bawah ini.

// Creating a link 
Link link = new Link("Click here", annotation);

Langkah 7: Menambahkan anotasi tautan ke paragraf

Buat paragraf baru dengan membuat instance Paragraph kelas dan tambahkan tautan yang dibuat pada langkah sebelumnya menggunakan add() metode kelas ini, seperti yang ditunjukkan di bawah ini.

// Creating a paragraph 
Paragraph paragraph = new Paragraph("Hi welcome to Tutorialspoint ");        

// Adding link to paragraph 
paragraph.add(link.setUnderline());

Langkah 8: Menambahkan paragraf ke dokumen

Tambahkan paragraf ke dokumen menggunakan add() metode dari Document kelas, seperti yang ditunjukkan di bawah ini.

// Adding paragraph to document 
document.add(paragraph);

Langkah 9: Menutup Dokumen

Tutup dokumen menggunakan close() metode dari Document kelas, seperti yang ditunjukkan di bawah ini.

// Closing the document 
document.close();

Contoh

Program Java berikut menunjukkan cara menambahkan anotasi tautan ke dokumen PDF menggunakan perpustakaan iText.

Ini membuat dokumen PDF dengan nama linkAnnotation.pdf, menambahkan anotasi tautan ke dalamnya, dan menyimpannya di jalur C:/itextExamples/

Simpan kode ini dalam file dengan nama LinkAnnotation.java.

import com.itextpdf.kernel.geom.Rectangle; 
import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfWriter; 
import com.itextpdf.kernel.pdf.action.PdfAction; 
import com.itextpdf.kernel.pdf.annot.PdfLinkAnnotation; 

import com.itextpdf.layout.Document; 
import com.itextpdf.layout.element.Link; 
import com.itextpdf.layout.element.Paragraph;  

public class LinkAnnotation {      
   public static void main(String args[]) throws Exception {             
      // Creating a PdfWriter       
      String dest = "C:/itextExamples/linkAnnotation.pdf";       
      
      PdfWriter writer = new 
      PdfWriter(dest);               
      
      // Creating a PdfDocument       
      PdfDocument pdf = new PdfDocument(writer);               
      
      // Creating a Document
      Document document = new Document(pdf);              
      
      // Creating a PdfLinkAnnotation object       
      Rectangle rect = new Rectangle(0, 0);       
      PdfLinkAnnotation annotation = new PdfLinkAnnotation(rect);              
      
      // Setting action of the annotation       
      PdfAction action = PdfAction.createURI("http:// www.tutorialspoint.com/");       
      annotation.setAction(action);             
      
      // Creating a link       
      Link link = new Link("Click here", annotation);              
      
      // Creating a paragraph       
      Paragraph paragraph = new Paragraph("Hi welcome to Tutorialspoint ");              
      
      // Adding link to paragraph       
      paragraph.add(link.setUnderline());              
      
      // Adding paragraph to document       
      document.add(paragraph);             

      // Closing the document       
      document.close();              
      
      System.out.println("Annotation added successfully");    
   } 
}

Kompilasi dan jalankan file Java yang disimpan dari Command prompt menggunakan perintah berikut -

javac LinkAnnotation.java 
java LinkAnnotation

Setelah dijalankan, program di atas membuat dokumen PDF yang menampilkan pesan berikut.

Annotation added successfully

Jika Anda memverifikasi jalur yang ditentukan, Anda dapat menemukan dokumen PDF yang dibuat, seperti yang ditunjukkan di bawah ini.