JAVA ile PDF Yaratma ve Düzenleme

ALLIANZ TÜRKIYE
ITEXT - JAVA ile PDF
Yaratma ve Düzenleme
Dokümantasyon
Sedat Çelik
9/4/2012
Bu dokümanın yapılmasındaki amaç iText kütüphanesini kullanarak Java üzerinden basit PDF dosyalırı
yaratmak ve düzenlemek konusunda kaynak sağlamaktır. Genel anlamda bir çeviri olduğu söylenebilir
Doküma’ın hazırlık aşamasında, eklemeler ve düzenlemeler yapılırken çok ayrıntıya girilmemeye
çalışıldı ve okuyucunun temel Java bilgisi olduğu varsayıldı.

Contents
Giriş .......................................................................................................................................................... 2
Kurulum ................................................................................................................................................... 3
İçerik ve Kullanım .................................................................................................................................... 4
Örnek Doküman .................................................................................................................................. 4
iText nesneleri ..................................................................................................................................... 6
Document ........................................................................................................................................ 6
Chunk ............................................................................................................................................... 7
Phrase .............................................................................................................................................. 8
Paragraph ...................................................................................................................................... 11
Bölüm ve Kısım (alt bölüm) ........................................................................................................... 14
Link ................................................................................................................................................ 15
List ................................................................................................................................................. 18
Table .............................................................................................................................................. 21
Imajlar ............................................................................................................................................ 28
Alt ve Üst yazılar ............................................................................................................................ 34
Alt ve Üst Çizgiler ........................................................................................................................... 35
Font ................................................................................................................................................ 36
Faydalanılan kaynaklar: ......................................................................................................................... 40
1

Giriş
Bu dokümanın amacı Java programlama dili ile, iText açık kaynak kodlu kütüphanesini kullanarak
nasıl PDF dosyası yaratılacağını göstermektir. iText web sitesinden kütüphane incelenebilir ve
buradan indirilebilir. Ancak ticari sürümü de mevcuttur ve ticari sürümüyle, özel bir araç kullanılarak,
burada anlatılacak işlemleri yapmak çok daha kolaydır.
Bu dokümanda iText’in en ince ayrıntısına kadar girilip bütün detaylarıyla anlatılmayacak, genel
anlamda bir doküman hazırlamak için gerekli bilgi verilecektir.
Daha fazla ayrıntı için iText geliştiricileri tarafından yazılmış iText in Action (Manning) adlı kitaptan
faydalanılabilir.
2

Kurulum
IText PDF API’sini kullanmak için öncelikle iText web sitesinden IText Jar dosyaları indirilmeli ve
kullanacağınız projenin class path’ine eklenmelidir. Başka bir kütüphane eklemeye gerek yoktur, yani
her hangi bir bağımlılık söz konusu değildir.
3

İçerik ve Kullanım
Örnek Doküman
Aşağıda iText kullanılarak basitçe bir PDF dosyasını nasıl yaratacağımıza dair kod parçası ve açıklaması
verilmiştir:
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
import java.io.FileNotFoundException;
public class HelloWorldExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document,new FileOutputStream("HelloWorld.pdf"));
document.open();
document.add(new Paragraph("Hello World iText."));
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Yukarıdaki kod parçasında olanları şu şekilde açıklayabiliriz:
İlk olarak bir Document instance’ı yaratılmıştır. Yaratılan bu Document objesi bizim için PDF
dokümanıdır. Bu obje üstündeki çeşitli prosedür ve metodları çağırarak PDF dokümanımıza
çeşitli yetenekler ve özellikler katabiliriz.
4

İkinci olarak constructor olarak, biraz önce yarattığımız ve açıklamasını verdiğimiz Document
objesini ve OutputStream alan bir PDFWriter objesi yaratıldı. Buradaki OutputStream
objesini, yaratılan PDF dokümanını yazmak için kullanacağız ki bu örnekte PDF dokümanını bir
dosyaya yazmak için FileOutputStream kullanıldı.
Üçüncü olarak, yarattığımız Document objesini, document.open() metodunu kullanarak içine
paragraf, resim, v.s. eklemek için hazır hale getiriyoruz. Bu aşamadan sonra Document
objesinin içine PDF dokümanımızı şekillendirmek için gerekli her şeyi ekleyebiliriz.
Dördüncü olarak Dokümanımızın içine bir Paragraph nesnesi ekleyerek onu şekllendirmeye
başlıyoruz.
Beşinci ve son olarak document.close() metodu kullanılarak dokümanımızın içeriği diske
yazılarak kapatılıyor ve kullanıma hazır hale getiriliyor.
5

iText nesneleri
Bir PDF dokümanı yaratmak için kullanacağımız bazı iText nesneleri şuınlardır:
Document
Chunk
Phrase
Paragraph
Chapter + Section
Anchor
List
Tables
Images
Superscript + Subscript
Underline + Strikethrough
Fonts
Document
com.itextpdf.text.Document sınıfı iText için bir PDF dokümanını gösterir. iText içindeki en önemli
sınıflardan birisidir. Eğer sıfırdan bir PDF dokümanı yaratılacaksa mutlaka Document sınıfı
kullanılmalıdır.
Öncelikle Document nesnesi yaratılmalı ve ardından açılmalıdır. Ancak bu aşamalardan sonra
dokümanın içine çeşitli bileşenler atılabilir. Son olarak da dokümanın hazır hale gelmesi için yaratılan
doküman kapatılmalıdır. Kısaca bir Document nesnesinin yaşam döngüsünü bu şekilde sıralayabiliriz.
Bu obje için örnek kod yukarıda verilmiştir.
6

Chunk
com.itextpdf.text.Chunk sınıfı iText için mümkün olan en küçük sözcük parçasını gösterir. Bir Chunk
objesi tek bir karakterden bir kaç cümlelik yazılara kadar sözcük öbeklerini kapsar.
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
public class DocumentExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Chunk.pdf"));
document.open();
document.add(new Chunk("Örnek cümle 1. "));
document.add(new Chunk("örnek cümle 2. "));
document.add(new Chunk("örnek cümle 3. "));
document.add(new Chunk("Örnek cümle 4. "));
document.add(new Chunk("Uzuuuuunun bir örnek cümle 5. "));
document.add(new Chunk("Son örnek cümle."));
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Dikkat edilirse “Örnek cümle 1.” ile “Son örnek cümle.” yazılarının birbirlerinin üstüne bindiği görülebilir. Bunun
sebebi Chank nesnesinin satırbaşı, paragraf boşluğu gibi birtakım özel boşlukları yapamamasından kaynaklanır.
7

Sadece yazılan text’i bir sonraki uygun yere soldan sağa doğru ekler. Sağ köşeye erişildiğinde ise sol baştan,
aynı Y lokasyonunda tekrar başlar. Sonuçta yukardaki resimde görülen şekilde karakterler birbirlerinin üstüne
biner.
Phrase
com.itextpdf.text.Phrase sınıfı iText için cümle olarak kullanılır. Chunk’dan farklı olarak Phrase
nesnesi paragraflar arasına nasıl boşluk ekleneceğini bilir ve sözcükleri üstüste bindirmez.
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
public class DocumentExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Chunk.pdf"));
document.open();
document.add(new Phrase("Örnek cümle 1. "));
document.add(new Phrase("örnek cümle 2. "));
document.add(new Phrase("örnek cümle 3. "));
document.add(new Phrase("Örnek cümle 4. "));
document.add(new Phrase("Uzuuuuunun bir örnek cümle 5. "));
document.add(new Phrase("Son örnek cümle."));
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
8

Dikkat edilirse “Son örnek cümle” kendi satırına düzgün bir şekilde yerleşmiştir.
Satır aralığı
Phrase nesnesi satır sonuna ulaşılıp yeni satıra geçerken, yeni satırla eski satırın arasında ne kadar
boşluk olması gerektiğini bilir ancak fazladan boşluk ekleyemez. Bunun için Paragraph nesnesi
kullanılmalıdır.
Satır aralıkları kullanıcı birimleri cinsinden ölçülür. İnç başına 72 birimdir. Varsayılan olarak yazı
yüksekliğinin 1.5 katıdır. Satır aralıkları, Phrase nesnesinin constructor’ına bir parametre olarak
verilerek, aşağıdaki örnekteki gibi değiştirilebilir:
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
public class DocumentExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Chunk.pdf"));
document.open();
Chunk chunk = new Chunk("Bu, örnek bir cümledir.");
Phrase phrase = new Phrase(50);
phrase.add(chunk);
phrase.add(chunk);
phrase.add(chunk);
phrase.add(chunk);
phrase.add(chunk);
phrase.add(chunk);
document.add(phrase);
document.close();
9

} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Aşağıdaki ekran görüntüsü, yukarıdaki kodun çıktısını göstermektedir. İki satır arasına eklediğimiz 50 birimlik
fazladan boşluk açıkça görülmektedir.
10

Paragraph
com.itextpdf.text.Paragraph sınıfı iText içinde paragraf olarak kullanılır. Bir paragrafta hizalama,
girinti ve paragraftan önceki ve sonraki boşluklar değiştirilebilir.
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
public class DocumentExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Paragraph.pdf"));
document.open();
Paragraph paragraph = new Paragraph();
for(int i=0; i

Kod çıktısı aşağıdaki şekilde olmalıdır:
Satır aralığı
Paragraph nesnesi, eğer yazı satır sonuna gelmişse, yeni satıra geçerken ne kadar satır aralığı
bırakılacağını bilir. Satır aralıkları kullanıcı birimleri cinsinden ölçülür. İnç başına 72 birimdir.
Varsayılan olarak yazı yüksekliğinin 1.5 katıdır. Satır aralıkları, Paragraph nesnesinin constructor’ına
bir parametre olarak verilerek, aşağıdaki gibi değiştirilebilir:
Paragraph paragraph = new Paragraph(50);
Paragraftan Önceki ve Sonraki Boşluk
Aşağıdaki şekilde paragraftan önce ve sonra boşluk bırakılabilir:
paragraph.setSpacingAfter(50);
paragraph.setSpacingBefore(50);
Hizalama (Alignment)
Paragraf hizalaması setAlignment() metodu ile yapılabilir. Buradaki metod ile hangi tarafa doğru bir
hizalama olacağı belirtilir.
paragraph.setAlignment(Element.ALIGN_LEFT);
paragraph.setAlignment(Element.ALIGN_CENTER);
paragraph.setAlignment(Element.ALIGN_RIGHT);
Satırbaşı (Indentation)
Paragrafın sağ ya da sol girintileri belirlenebilir. Bu şekilde paragraf bulunduğu konumdan daha ileriye
ötelenebilir.
paragraph.setIndentationLeft(50);
paragraph.setIndentationRight(50);
12

Genel Pragraf Örneği
Aşağıda iki paragrafı bir dokümana ekleyen yukardakilerden daha büyük bir kod örneği
bulunmaktadır. İlk paragraf varsayılan sol hizalama ve girintiyi kullanıyor. İkinci paragraf ise
ortalanmış ve hem sol hem de sağ satırbaşları için 50 birimlik girintiye sahiptir.
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class Paragraph2Example {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document,new FileOutputStream("Paragraph2.pdf"));
document.open();
Paragraph paragraph1 = new Paragraph();
Paragraph paragraph2 = new Paragraph();
paragraph2.setSpacingAfter(25);
paragraph2.setSpacingBefore(25);
paragraph2.setAlignment(Element.ALIGN_CENTER);
paragraph2.setIndentationLeft(50);
paragraph2.setIndentationRight(50);
for(int i=0; i

}
Yaratılan dokümanın çıktısı aşağıdaki şekildedir:
Bölüm ve Kısım (alt bölüm)
IText kullanarak PDF dokümanına bölümler ve kısımlar ekleyebiliriz. Bölümler
com.itextpdf.text.Chapter sınıfı ile tanımlanırken Kısımlar class com.itextpdf.text.Section sınıfı ile
tanımlanır.
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class ChapterSectionExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("ChapterSection.pdf"));
document.open();
Paragraph paragraph = new Paragraph();
paragraph.add(new Phrase("Bu bir bölüm."));
14

Chapter chapter = new Chapter(paragraph, 1);
chapter.addSection("Bu da kisim 1", 2); // Section objesi
chapter.addSection("Bu da kisim 2", 2); // Section objesi
document.add(chapter);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Oluşan çıktı aşağıdaki gibidir:
Link
com.itextpdf.text.Anchor sınıfı iText içinde external ya da internal link yaratmak için kullanılır.
Oluşturulan link, web sitelerindeki gibi tıklanabilir.
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class AnchorExample {
public static void main(String[] args) {
Document document = new Document();
15

try {
PdfWriter.getInstance(document, new FileOutputStream("Anchor.pdf"));
document.open();
Paragraph paragraph = new Paragraph();
paragraph.add(new Phrase("Web’de arama yapmak için gideceginiz adres: "));
Anchor anchor = new Anchor("Google");
anchor.setReference("http://www.google.com");
paragraph.add(anchor);
document.add(paragraph);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Oluşan çıktı:
Resime dikkat edilirse adres üstündeki pointer’ın el şeklinde olduğu görülür. Ancak varsayılan olarak
bunun için özel bir stil tanımlanmamıştır. Yani kendi pointer’ımızı tanımlayabiliriz.
16

Internal Link
PDF dokümanı içinde HTML sayfalarındaki gibi yerel link’ler de oluşturulabilir. Bunun için gereken
koşul link’in yanında link isminin de yazılmasından ibarettir.
import com.itextpdf.text.Anchor;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class Anchor2Example {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Anchor2.pdf"));
document.open();
Anchor anchor = new Anchor("Bir sonraki paragrafa git");
anchor.setReference("#target");
Paragraph paragraph = new Paragraph();
paragraph.add(anchor);
document.add(paragraph);
Anchor anchorTarget = new Anchor("Hedef link!");
anchor.setName("target");
Paragraph targetParagraph = new Paragraph();
targetParagraph.setSpacingBefore(50);
targetParagraph.add(anchorTarget);
document.add(targetParagraph);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
17

}
}
Oluşan çıktı aşağıdaki gibidir. Burada tahmin edilebileceği gibi link olarak “target” kullanılmıştır. Bu
arada mouse pointer’a dikkat edilirse yerel link olduğu için el şeklindedir ve internal link’ten bu
haliyle de ayrılır. Eğer internal bir lik olsaydı el işareti bir önceki örnekteki gibi olacaktı.
List
IText kullanılarak PDF dokümanına sıralı ya da sırasız listeler eklenebilir. Liste com.itextpdf.text.List
sınıfıyla tanımlanır, liste elemanları ise com.itextpdf.text.ListItem sınıfıyla. IText içinde Ordered
(sıralı), Unordered (sırasız - düz), Roman (roma rakamları), Greek (yunan rakamları), Zapfdingbats
(özel karakterli) gibi isimler verilen bir çok liste çeşidi kullanılabilir. Örneğin roma rakamları kullanmak
için com.itextpdf.text.RomanList sınıfı, yunan harfleri kullanmak için ise com.itextpdf.text.GreekList
sınıfını kullanılabilir. Bunun yanında liste imi olarak özel karakterler de kullanılabilir. Bu karakterler
Dingbat font sınıfına ayit windows içinde wingdings olarak bilinen font ailesinin elemanlarından
oluşur ve ZapfDingbats sınıfıyla yaratılır. Bu sınıfın constructor’u iki parametre alır; birincisi font’un
karakter kodu , ikincisi ise liste imi ve yazı arasındaki boşluktur.
Tüm bunları içeren örnek aşağıda verilmiştir:
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class List3Example {
public static void main(String[] args) {
18

Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("List3.pdf"));
document.open();
List orderedList = new List(List.ORDERED);
orderedList.add(new ListItem("Sirali Liste 1"));
orderedList.add(new ListItem("Sirali Liste 2"));
orderedList.add(new ListItem("Sirali Liste 3"));
document.add(orderedList);
List unorderedList = new List(List.UNORDERED);
unorderedList.add(new ListItem("Sirasiz Liste 1"));
unorderedList.add(new ListItem("Sirasiz Liste 2"));
unorderedList.add(new ListItem("Sirasiz Liste 3"));
document.add(unorderedList);
RomanList romanList = new RomanList();
romanList.add(new ListItem("Roma Liste 1"));
romanList.add(new ListItem("Roma Liste 2"));
romanList.add(new ListItem("Roma Liste 3"));
document.add(romanList);
GreekList greekList = new GreekList();
greekList.add(new ListItem("Greek Liste 1"));
greekList.add(new ListItem("Greek Liste 2"));
greekList.add(new ListItem("Greek Liste 3"));
document.add(greekList);
ZapfDingbatsList zapfDingbatsList1 = new ZapfDingbatsList(110, 15);
zapfDingbatsList1.add(new ListItem("Dingbat Liste 1"));
zapfDingbatsList1.add(new ListItem("Dingbat Liste 2"));
zapfDingbatsList1.add(new ListItem("Dingbat Liste 3"));
document.add(zapfDingbatsList1);
ZapfDingbatsList zapfDingbatsList2 = new ZapfDingbatsList(43, 30);
zapfDingbatsList2.add(new ListItem("Dingbat2 Liste 1"));
zapfDingbatsList2.add(new ListItem("Dingbat2 Liste 2"));
zapfDingbatsList2.add(new ListItem("Dingbat2 Liste 3"));
document.add(zapfDingbatsList2);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
19

}
Yukarıdaki kod çalıştırıldığında aşağıdaki gibi bir çıktı verir:
20

Table
com.itextpdf.text.PdfPTable class sınıfı kullanılarak PDF dokümanlarına table’lar eklenebilir. Tablolar
iText içindeki en karışık nesnelerden biridir. Aşağıda tablolarla beraber kullanacağımız işlemlerin ve
özelliklerin listesi yer almaktadır:
1. Tablo yaratma
2. Tablo genişlik
3. Tablodan önce ve sonra boşluk bırakma
4. Kolon genişlikleri
5. Kolon birleştirme
6. Cell Text Mode ve Composite Mode
7. Text Mode içindeki varsayılan hücre ayarları
8. Hücre Alignment
9. Hücre Indentation
10. Hücre Leading
11. Hücre Padding
12. Hücre Borders and Colors
13. Hücre Rotation
14. Tablo ve imajlar
15. İç tablolar
1. Tablo yaratma
Bir PdfTable nesnesi yaratılırken kaç kolona sahip olması gerektiği önceden belirtilmelidir, bu da
PdfPTable objesinin construction’una parametreyle verilir.
Tabloya hücre eklemek için addCell() metodu çağrılıp PdfPCell ya da Paragraph objesi parametre
olarak verilebilir. PdfPCell ya da Paragraph objesinin verilmesine göre tablo hücresinin davranışı
değişiklik gösterir. Daha geniş bilgi için Cell Text Mode ve Composite Mode bölümlerine bakılabilir.
Örnek kod ve çıktısı aşağıda verilmiştir:
import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfPCell;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
public class TableExample {
public static void main(String[] args) {
Document document = new Document();
try {
21

PdfWriter.getInstance(document, new FileOutputStream("Table.pdf"));
document.open();
PdfPTable table = new PdfPTable(2); // 2 kolonlu tablo
PdfPCell cell1 = new PdfPCell(new Paragraph("Hücre 1"));
PdfPCell cell2 = new PdfPCell(new Paragraph("Hücre 2"));
table.addCell(cell1);
table.addCell(cell2);
document.add(table);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
2. Tablo Genişliği
Tablo genişliğini ayarlamak için setWidthPercentage() metodu kullanılabilir. Buradaki değer tablo
genişliğinin sayfa genişliği üzerinden yüzdesi olarak kabul edilir. Varsayılan değer sayfa genişliğinin
yüzde sekseni şeklindedir. Aşağıdaki kod ile tablo genişliği ile sayfa genişliği eşitlenebilir:
table.setWidthPercentage(100);
3. Tablodan önce ya da sonra boşluk bırakma
Aşağıdaki örnekte tablodan önce ve sonra nasıl boşluk bırakılacağı gösterilmiştir:
22

table.setSpacingBefore(10f);
table.setSpacingAfter(10f);
4. Kolon genişlikleri
setWidth() metodu kullanılarak aşağıdaki şekilde kolon genişlikleri ayarlanabilir:
float[] columnWidths = {2f, 1f};
table.setWidths(columnWidths);
Tahmin edilebileceği gibi float değerlerinin her biri sırasıyla tablo genişliklerini verir.
5. Kolon birleştirme
Eğere birden fazla kolon birleştirilmek isteniyorsa setColspan() metodu aşağıdaki şekilde kullanılabilir:
cell.setColspan(2);
6. Cell Text Mode ve Composite Mode
Hücreler hem Text modunda hem de Composite modda tabloya eklenebilirler.
Text mode’da eklenen elemanların (Phrase, Paragraph vb.) özellikleri yok sayılır. Sadece hücrenin
özellikleri korunur
Composite mode’da eklenen elemanların özellikleri korunur. Boşluk girinti vs. gibi özellikler eklenen
hücreye aynen yansır.
Eklenen içerik PdfCell nesnesinin constructor’ı ile eklenmişse PdfPTable objesi tarafından Text mode
içeriği, PdfCell.addElement() metodu yardımıyla eklenmişse Composite mode içeriği şeklinde algılanır.
PdfCell textModeCell = new PdfCell(new Paragraph("Text Mode"));
PdfCell compositeModeCell = new PdfCell();
compositeModeCell.addElement(new Paragraph("Composite Mode"));
table.addCell(new Paragraph("Text Mode"));
7. Text Mode içindeki varsayılan hücre ayarları
table.addCell() metodu kullanılarak text mode olarak eklenen hücreler için varsayılan hücre ayarları
yapılabilir.
PdfCell defaultCell = table.getDefaultCell();
defaultCell.setBorder(PdfCell.NO_BORDER);
23

daha fazla default ayar yapılabilir.
//eklenecek hücreler yukarda verilen özelliğe sahip olacaktır:
table.addCell(new Paragraph("default text mode hücresi");
table.addCell(new Phrase("default text mode hücresi ");
8. Hücre Alignment
Hücre hizalaması setHorizontalAlignment() ve setVerticalAlignment() metodları kullanılarak aşağıdaki
şekilde yapılabilir:
cell.setHorizontalAlignment(Element.ALIGN_LEFT);
cell.setHorizontalAlignment(Element.ALIGN_CENTER);
cell.setHorizontalAlignment(Element.ALIGN_RIGHT);
cell.setVerticalAlignment(Element.ALIGN_TOP);
cell.setVerticalAlignment(Element.ALIGN_MIDDLE);
cell.setVerticalAlignment(Element.ALIGN_BOTTOM);
Composite mode’da Paragraph objelerinin alignment ayarları değiştirilerek her paragraf için özel
hizalama yapılabilir.
9. Hücre Indentation
Hücre içeriğinin girintisi ayarlanabilir.
setIndent() metoduyla hücre içindeki ilk paragrafın girintisi ayarlanabilir.
setFollowingIndent() metoduyla hücre içindeki takip eden paragrafların girintisi ayarlanabilir.
setRightIndent() metoduyla hücre içeriğinin sağ girintisi ayarlanabilir.
10. Hücre Leading
Hücredeki elemanların paragraf boşlukları değiştirilebilir.
Composite mode’a eklenen objenin leading özelliği ayarlanıp o şekilde eklenebilir, örneğin bir
paragrafın leading özelliği hücreye eklemeden değiştirilmelidir.
Text mode’da leading özelliği tüm hücreler için değiştirilmelidir, bunu yapmak için setLeading()
metodu kullanılır. Bu metod iki parametre alır. Sabit boşluk ve font yüksekliği üstünden hesaplanan
boşluk.
cell.setLeading(15f, 0f);
cell.setLeading(0f, 1.5f);
İlk metod paragraf aralığını 15 points + 0 x font yüksekliği şeklikde ayarlar.
İkinci metod paragraf aralığını 0 points + 1,5 x font yüksekliği şeklikde ayarlar.
11. Hücre Padding
Aşağıdaki örnekte verilen metodlarla hücre sınırı ve içerik arasındaki mesafe (Padding) ayarlanabilir:
24

cell.setPadding(5);
cell.setPaddingLeft(8);
cell.setPaddingRight(8);
cell.setPaddingTop(8);
cell.setPaddingBottom(8);
12. Hücre Borders and Colors
Aşağıdaki metodlar kullanılarak hücre çerçeve ve renkleri değiştirilebilir:
cell.setBackgroundColor(BaseColor.RED);
//arkaplan rengini kırmızı yap.
cell.setBorder(Rectangle.NO_BORDER);
// çerçeveleri kaldır
cell.setBorderWidth (3f); // çerçeve genişliğini 3 birim olarak ayarla
cell.setBorderWidthLeft (1f);
cell.setBorderWidthRight (1f);
cell.setBorderWidthTop (1f);
cell.setBorderWidthBottom(1f);
cell.setBorderColor (BaseColor.BLUE); // çerçeve rengini mavi yap
cell.setBorderColorLeft (BaseColor.GREEN);
cell.setBorderColorRight (BaseColor.GREEN);
cell.setBorderColorTop (BaseColor.GREEN);
cell.setBorderColorBottom(BaseColor.GREEN);
Hücre çerçe tipi kalın olarak ayarlanmışsa, çerçeveler ile içeriğin çakışmaması için aşağıdaki örnekteki
gibi setUserBorderPadding(true) şeklinde bir ayar yapılmalıdır:
cell.setUserBorderPadding(true);
13. Hücre Rotation
setRotation() metoduyla aşağıdaki gibi, hücre içeriği döndürülebilir:
cell.setRotation(90);
14. Tablo ve imajlar
IText ile bir imaj tablo hücresine eklenebilir. Bu yapılırken hücre imajın boyutunu ya da imaj hücrenin
boyutunu alabilir. Bunu yapmak için sökonusu imaj, imajın mı hücre boyutunu alacağı yoksa hücrenin
mi imaj boyutunu alacağına ilişkin boolean bir değerle birlikte PdfPCell sınıfının constructor’ına
parametreyle verilmelidir. Eğer imajın hücrenin boyutunu alması isteniyorsa boolean parametre true,
tersine, hücrenin imajın boyutunu alması isteniyorsa false set edilmelidir.
import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
25

import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfPCell;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
import java.net.URL;
public class Table3Example {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Table.pdf"));
document.open();
PdfPTable table = new PdfPTable(2); // 2 kolon.
Image image = Image.getInstance("C:/tmp/allianz.jpg");
PdfPCell cell1 = new PdfPCell(new Paragraph("1. Hücre"));
PdfPCell cell2 = new PdfPCell(image, true);
table.addCell(cell1);
table.addCell(cell2);
PdfPCell cell3 = new PdfPCell(new Paragraph("3. Hücre "));
PdfPCell cell4 = new PdfPCell(new Paragraph("2. Hücre "));
table.addCell(cell3);
table.addCell(cell4);
document.add(table);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
26

15. İç tablolar
PdfTable nesnesi PdfCell nesnesinin içine eklenebilir, bu şekilde tablo içinde tablo yaratılmış olur.
İlgili kod ve görsel aşağıda verilmiştir:
import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfPCell;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
public class Table2Example {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Table.pdf"));
document.open();
PdfPTable table = new PdfPTable(3);
27

PdfPCell cell1 = new PdfPCell(new Paragraph("1. Hücre "));
PdfPCell cell2 = new PdfPCell(new Paragraph("2. Hücre "));
PdfPCell cell3 = new PdfPCell(new Paragraph("3. Hücre "));
PdfPTable nestedTable = new PdfPTable(2);
nestedTable.addCell(new Paragraph("1. iç Hücre "));
nestedTable.addCell(new Paragraph("2. İç Hücre "));
cell3.addElement(nestedTable);
table.addCell(cell1);
table.addCell(cell2);
table.addCell(cell3);
document.add(table);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
Imajlar
IText içinde imajlarla ilgili ölçeklendirme, döndürme, maskeleme, belirli bir noktaya yerleştirme,
çerçeve ekleme, hizalama vb. bir çok işlem yapılabilir, ancak burada sadece aşağıdaki gib bir kaç basit
işleme yer vereceğiz, bunlar:
1. İmaj yaratma
2. Belirli bir noktaya yerleştirme
3. Ölçekleme
4. Döndürme
1. İmaj yaratma
PDF dokümanlarına imaj eklemek için iText içinde com.itextpdf.text.Image sınıfı kullanılır. Bunun
yanında aşağıdaki gibi bir dosyadan ya da URL adresinden de PDF dokümanına imaj eklenebilir:
28

import com.itextpdf.text.Document;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
public class ImageExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Image.pdf"));
document.open();
String imageUrl = "http://www.allianz.com.tr/HomePage/_img/logo.png";
Image image1 = Image.getInstance(new URL(imageUrl));
document.add(image1);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
Kod çıktısı aşağıdaki gibidir:
29

2. Belirli bir noktaya yerleştirme
Bir imajı belirli bir pozisyona yerleştirmek için X ve Y noktalarını parametre olarak alan
setAbsolutePosition() metodu kullanılabilir. Ancak bu işlem imaj dokümana eklenmeden önce
yapılmalıdır. Dikkat edilmesi gereken nokta X ve Y kordinatlarının sol alt köşeden başladığıdır.
image.setAbsolutePosition(500f, 650f);
3. Ölçekleme
Aşağıdaki imaj metodları kullanılarak bir imajın boyutları değiştirilebilir:
scaleAbsolute()
scaleAbsoluteWidth()
scaleAbsoluteHeight()
scalePercentage()
scaleToFit()
Bu metodlarla ilgili aşağıdaki gibi bir örnek verilebilir:
import com.itextpdf.text.Document;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
public class ImageExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Image.pdf"));
document.open();
String imageUrl = " http://www.allianz.com.tr/HomePage/_img/logo.png";
Image image1 = Image.getInstance(new URL(imageUrl));
image1.scaleAbsolute(150f, 150f);
document.add(image1);
Image image2 = Image.getInstance(new URL(imageUrl));
30

image2.scalePercent(300f);
document.add(image2);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
Yukarıdaki kodun çıktısı şu şekildedir:
4. Döndürme
Aşağıdaki metodlar kullanılarak iText ile hazırlanan PDF dokümanları içindeki imajlar döndürülebilir:
setRotationDegrees()
setRotation()
31

Sırasıyla örnek kod ve çıktısı aşağıdaki gibidir:
import com.itextpdf.text.Document;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
public class ImageExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Image.pdf"));
document.open();
String imageUrl = " http://www.allianz.com.tr/HomePage/_img/logo.png";
Image image = Image.getInstance(new URL(imageUrl));
document.add(image1);
Image image2 = Image.getInstance(new URL(imageUrl));
image.setRotationDegrees(45f);
document.add(image2);
document.close();
} catch(Exception e){
e.printStackTrace();
}
}
}
32

33

Alt ve Üst yazılar
IText içindeki Chunk sınıfı ile setTextRise() metodu kullanılarak yazılar üste (superscript) ya da alta
(subscript) gelecek şekilde yazılabilir. Yazıları üste yazmak için setTextRise() metoduna pozitif
rakamlar, alta yazmak için ise negatif rakamlar yazmak gerekir.
import com.itextpdf.text.Chunk;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class SuperSubScriptExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("SuperSubScript.pdf"));
document.open();
Chunk normalText = new Chunk("Normal text normal y-pozisyonunda. ");
document.add(normalText);
Chunk superScript = new Chunk("Üstyazi");
superScript.setTextRise(5f);
document.add(superScript);
Chunk moreNormalText = new Chunk(". Diger normal y-pozisyonundaki yazi. ");
document.add(moreNormalText);
Chunk subScript = new Chunk("Altyazi");
subScript.setTextRise(-5f);
document.add(subScript);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
34
}

}
Kod çıktısı aşağıdaki gibidir:
Alt ve Üst Çizgiler
IText içindeki Chunk sınıfı ile setUnderline () metodu kullanılarak yazılar üst çizgili ya da alt çizgili
şekilde yazılabilir. Yazının varsayılandan daha da altını çizmek için setUnderline () metoduna negatif
rakamlar, üstünü çizmek için ise pozitif rakamlar yazmak gerekir.
import com.itextpdf.text.Chunk;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
public class UnderlineStrikethroughExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("AltUstCizgi.pdf"));
document.open();
Chunk underline = new Chunk("Underline. ");
underline.setUnderline(0.1f, -2f); //0.1 kalınlık, -2 y-location
document.add(underline);
document.add(new Paragraph(" "));
35

Chunk strikethrough = new Chunk("Strikethrough.");
strikethrough.setUnderline(0.1f, 3f); //0.1 kalınlık, 2 y-location
document.add(strikethrough);
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Kod, aşağıdaki gibi bir çıktı üretir:
Font
Text ile ilgili bir çok objede Font kullanılır (Chunk, Phrase, Paragraph vb.) ve burada anlatılamayacak
kadar çok işlem yapılabilir. Burada sadece basitçe değinilecektir.
Font kullanabilmek için öncelikle Font objesini yaratmak gerekir. Ardından yaratılan font objesi
kullanılacak text objesine, onun constructor’ı yoluyla set edilmelidir.
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
import java.io.FileNotFoundException;
public class FontExample {
public static void main(String[] args) {
Document document = new Document();
36

try {
PdfWriter.getInstance(document, new FileOutputStream("Font.pdf"));
Font ft1 = new Font(Font.FontFamily.HELVETICA, 25, Font.BOLD);
Font ft2 = new Font(Font.FontFamily.COURIER,18,Font.ITALIC | Font.UNDERLINE);
Font ft3 = new Font(Font.FontFamily.TIMES_ROMAN, 27);
document.open();
document.add(new Chunk( "Örnek cümle 1. ", ft1));
document.add(new Phrase( "İkinci örnek cümle 2. ", ft2));
document.add(new Paragraph("Başka bir örnek cümle 3. ", ft3));
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
Kodun çıktısı aşağıdaki gibidir:
BaseFont
Dikkat edilirse İ ya da ş gibi sadece Türkçe’ye özgü karakterler çıktıda görülmemektedir. Bunun sebebi
iText’in text için biz belirtmedikçe her zaman standart font’u tercih etmesinden kaynaklanır. Bunu
engellemek için BaseFont objesini kullanarak kendi fontumuzu (tercihe göre Türkçe desteği olan)
yaratmalıyız.
BaseFont.createFont(fontIsmi, kod, gomuluMu);
37

BaseFont objesinin aldığı parametrelere dikkat edecek olursak fontIsmi parametresi ile font’u
seçiyoruz, istersek font objesini (örn. arial.ttf) classpath’e tanımlayıp oradaki adresi de verebiliriz. Kod
parametresi ile kullandığımız font’un hangi dil kodlamasını kullanması gerektiğini seçiyoruz,
gomuluMu parametresiyle de fontun yaratılacak PDF dosyasına gömülüp gömülmeyeceğine karar
veriyoruz. Yukardaki kodun değiştirilmiş örnek kullanımı ve çıktısı aşağıdaki gibidir:
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.PdfWriter;
import java.io.FileOutputStream;
import java.io.FileNotFoundException;
public class FontExample {
public static void main(String[] args) {
Document document = new Document();
try {
PdfWriter.getInstance(document, new FileOutputStream("Font.pdf"));
BaseFont arialTR = BaseFont.createFont("C:/tmp/arial.ttf", "CP1254",
BaseFont.EMBEDDED); // Türkçe’nin dil kodu CP1254
Font ft1 = new Font(arialTR, 25, Font.BOLD);
Font ft2 = new Font(Font.FontFamily.COURIER,18,Font.ITALIC | Font.UNDERLINE);
Font ft3 = new Font(arialTR, 27);
document.open();
document.add(new Chunk( "Örnek cümle 1. ", ft1));
document.add(new Phrase( "İkinci örnek cümle 2. ", ft2));
document.add(new Paragraph("Başka bir örnek cümle 3. ", ft3));
document.close();
} catch (DocumentException e) {
e.printStackTrace();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
}
38

Dikkat edilirse Courrier font’uyla yazılmış yazıdaki Türkçe’ye özgü İ harfi görünmezken kendi
yarattığımız font’la yazılmış ş gibi Türkçe karakterler görülmektedir.
39

Faydalanılan kaynaklar:
http://itextpdf.com
http://tutorials.jenkov.com/java-itext
http://www.vogella.com/articles/JavaPDF/
40