Java REST API'yi kullanarak PDF'ye Üstbilgi ve Altbilgi Ekleme

Başlık, bir sayfanın en üstündeki kenar boşluğu alanına yerleştirilen bir metindir, alt bilgi ise sayfanın altına veya ayağına yerleştirilir. Genellikle bu alanlar, belge adı, bölüm başlığı, sayfa numaraları, oluşturma tarihi vb. gibi belge bilgilerini eklemek için kullanılır. Bu bilgiler her sayfada tekrarlanır ve böylece okuyucunun belgede kolayca gezinmesini sağlar.

Ayrıca, Başlıklar ve altbilgilerin belgeniz hakkında öngörülebilir bir biçimde hızlı bilgi sağlamada yararlı olduğunu ve ayrıca bir belgenin farklı bölümlerini belirlemede yardımcı olduğunu lütfen unutmayın. Bu makalede, Aspose.PDF Cloud SDK for Java kullanarak PDF dosyalarının Başlık ve altbilgi alanlarına metin ve resim eklemeyi öğreneceğiz.

cURL kullanarak Başlığa Metin Ekleme
Java kullanarak PDF’ye Metin Başlığı Ekleme
cURL’yi kullanarak PDF Başlığındaki Görüntü
Java kullanarak Başlığa resim ekleme

cURL kullanarak Başlığa Metin Ekleme

cURL komutları, komut satırı terminali aracılığıyla RESTFul API’lerine erişmenin heyecan verici bir yoludur. Aspose.PDF Cloud SDK, REST prensiplerine göre geliştirildiğinden, komut istemi aracılığıyla kolayca erişilebilir. Ancak, kullanıcı gizliliğini ve veri bütünlüğünü sağlamak için tüm API’lerimize yalnızca yetkili kişilerin erişebildiğini lütfen unutmayın. Bu nedenle, önce Aspose.Cloud panosunu ziyaret etmeniz ve GitHub veya Google hesabınız varsa, basitçe Kaydolmanız gerekir. Aksi takdirde, Yeni Hesap Oluştur düğmesine tıklayın ve gerekli bilgileri sağlayın. Şimdi kimlik bilgilerini kullanarak panoya giriş yapın ve panodan Uygulamalar bölümünü genişletin ve İstemci Kimliği ve İstemci Gizli Bilgisi ayrıntılarını görmek için İstemci Kimlik Bilgileri bölümüne doğru aşağı kaydırın.

Aşağıdaki komut, PDF belgesinin Başlık alanına metin eklemek için kullanılacak bir JWT erişim belirtecinin nasıl oluşturulacağını gösterir.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

PDF belgesinin başlık bölümüne Metin eklemek için aşağıdaki cURL komutunu kullanın.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/text?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"CENTER\",  \"Opacity\": 0.8,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 0,  \"YIndent\": 0,  \"Zoom\": 1,  \"TextAlignment\": \"CENTER\",  \"Value\": \"Aspose.PDF Cloud SDK for Java via cURL\",  \"TextState\": {    \"FontSize\": 16,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 0xDA,      \"G\": 0xA5,      \"B\": 0x20    },    \"BackgroundColor\": {      \"A\": 0,      \"R\": 0xFA,      \"G\": 0xEB,      \"B\": 0xD7    },  },  \"LeftMargin\": 1,  \"TopMargin\": 20,  \"RightMargin\": 200}"

PDF'de Metin Başlığı — Resim 1:- cURL komutuyla eklenen Metin Başlığı.

Bu örnekte kullanılan örnek dosyalar şu adresten indirilebilir:

Java kullanarak PDF’ye Metin Başlığı Ekleme

SDK’yı kullanmak için önce onu Maven veya GitHub‘dan yüklemeniz gerekir. Aşağıda Maven build projesinde Aspose.Pdf.jar’ın nasıl indirileceği ve kullanılacağına dair ayrıntılar verilmiştir.

Pom.xml dosyanıza aşağıdaki bağımlılıkları ekleyin.

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

Bu gereksinimin nasıl karşılanacağına ilişkin adımlar aşağıda verilmiştir.

Öncelikle ClientSecret ve ClientId ayrıntılarını sağlayarak PdfApi örneğini oluşturun
İkinci olarak, Ön Plan ve Arka Plan renk ayrıntılarını tanımlamak için bir Renk nesnesi oluşturun.
İkinci olarak TextState sınıfından bir nesne yaratın.
Font boyutu ayrıntılarını ayarlamak için fontSize(..) yöntemini kullanın. Font yüzünü tanımlamak için font(..) yöntemi. ÖnplanRenk(…) yöntemi metin ön plan ayrıntılarını tanımlar ve arka plan bilgilerini tanımlamak için backgroundColor(…) yöntemi.
Şimdi TextHeader nesnesini oluşturun ve kenar boşluğu ayrıntılarını tanımlayın.
Text Header nesnesinin içeriğini belirtmek için value(..) yöntemlerini kullanın.
Şimdi textState(…) metodunu çağırın ve yukarıda oluşturulan TextState örneğini argüman olarak geçirin.
Başlığı sayfa içeriğinin arkasında görüntülemek için, true değerini TextHeader sınıfının background(…) metoduna argüman olarak geçirin.
Şimdi sol taraftaki resmi render edebilmek için horizontalAlignment(…) metoduna HorizontalAlignment.CENTER değerini verelim.
opacity(…) yöntemi damga opaklığını belirtir. Varsayılan değer 1.0’dır.
Yakınlaştırma değerini ayarladıktan sonra AsposeResponse nesnesini oluşturalım.
Son olarak, PdfApi .postDocumentTextHeader(…) metodunu çağırın ve kaynak PDF dosya adını, TextHeader nesnesini, başlangıç ve bitiş sayfalarını (damganın eklenmesi gereken yer) argüman olarak geçirin.

// ClientID ve ClientSecret'ı https://dashboard.aspose.cloud/ adresinden edinin
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi örneği
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF belgesini girin
String sourcePDF = "PdfWithAnnotations.pdf";

// PDF'nin başlangıç sayfasına Başlık Resmini yerleştirin
int startPage = 2;

// PDF'nin son sayfasına Başlık Resmini yerleştirin
int endPage = 3;
		        
// ön plan rengini Hex kodunda SlateBlue olarak belirtin
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// Arkaplan rengini Hex kodunda AntiqueWhite olarak belirtin
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// Yazı tipi boyutunu, yüzünü ve renk ayrıntılarını tanımlamak için TextState nesnesi oluşturun
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// TextHeader nesnesinin bir örneğini oluşturun
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // İşlenecek Metin başlığının içeriği
  .value("Aspose.PDF Cloud SDK For Java")
	
  // hizalamayı merkeze ayarla
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // Başlık Metnini sayfa içeriğinin arkasına ayarla
  headerObject.background(true)
	
  // Metin başlığı hizalamasını Orta olarak ayarla
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // Metin Başlığının opaklığını 0,8 olarak ayarlayın
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// PDF'ye Metin Başlığı eklemek için API yöntemini çağırın
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

Java'da Metin Başlığı eklendi — Resim 2:- Java ile eklenen Metin Başlığının önizlemesi.

Altbilgi alanına metin eklemek için lütfen TextFooter sınıfının bir örneğini oluşturun ve PdfApi sınıfının postDocumentTextFooter(…) metodunu çağırın. Kalan adımlar ve ayrıntılar, Metin Başlığı eklemek için yukarıda belirtilenlerle aynı kalacaktır.

cURL’yi kullanarak PDF Başlığındaki Görüntü

PDF dosyasının başlık bölümünde cURL komutunu kullanarak PostDocumentImageHeader API’sini kullanarak resim dosyalarını kolayca ekleyebiliriz. Bir resim damgası eklerken, resmin Yatay Hizalama, Opaklık, Döndürme Açısı, Yakınlaştırma faktörü, Genişlik, Yükseklik, Sol Kenar, Üst Kenar, Sağ Kenar vb. ayrıntılarını belirtme seçeneği elde ederiz.

name parametresi giriş/kaynak PDF belgesini tanımlar, imageHeader damgalanacak resim dosyasını belirtir, startPageNumber özelliği resim damgalarını içerecek PDF belgesinin başlangıç sayfasını ve endPageNumber bitiş sayfasını tanımlar. Aşağıdaki cURL komutunda, resmin görünür olması için Background özelliği false olarak ayarlanır. Yatay Hizalama Sol olarak belirtilir, Opaklık değeri 0,8 olarak tanımlanır, Yakınlaştırma faktörü 1 olarak ayarlanır, Genişlik 250 olarak tanımlanır, Yükseklik 80 nokta olarak tanımlanır ve RightMargin 500 nokta olarak belirtilir.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/image?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"  \
-H  "Content-Type: application/json" \
-d "{"Background":false,"HorizontalAlignment":'Left',"Opacity": .8,"Rotate":'None',"RotateAngle": 0,"XIndent": 2,"YIndent": 5,"Zoom": 1,"FileName": 'asposetoolsnew.png',"Width": 250,"Height": 80,"LeftMargin": 1,"TopMargin": 10,"RightMargin": 500}"

Başlıktaki resim damgası — Resim 3:- PDF’in Başlık bölümündeki resim damgası.

Yukarıdaki örnekte kullanılan örnek dosyalar aşağıdaki bağlantıdan indirilebilir:

Java kullanarak Başlığa resim ekleme

Aspose.PDF Cloud SDK for Java, daha az kod satırı içeren bir PDF dosyasına Resim Başlığı eklemek için dikkat çekici bir özellik sunar.

Aşağıda PDF belgesine Resim Başlığının nasıl ekleneceği ile ilgili adımlar verilmiştir

ClientSecret ve ClientId ayrıntılarını sağlayarak PdfApi nesnesini oluşturun.
İkinci olarak ImageHeader sınıfından bir nesne oluşturun.
Görüntünün genişlik ve yükseklik ayrıntılarını ayarlamak için ImageHeader sınıfının width(..) ve height(…) metotlarını kullanın.
Şimdi fileName(…) metodunu kullanarak başlık resminin yol ayrıntılarını ayarlayın.
Sayfa içeriğinin arkasındaki resmi görüntülemek için background(…) metoduna false argümanını geçirin.
Şimdi sol taraftaki resmi render edebilmek için horizontalAlignment(…) metoduna HorizontalAlignment.LEFT değerini verelim.
opacity(…) yöntemi damga opaklığını belirtir. Varsayılan değer 1.0’dır.
Yakınlaştırma değerini ayarladıktan sonra AsposeResponse nesnesini oluşturalım.
Son olarak, kaynak PDF dosya adını, ImageHeader nesnesini, başlangıç ve bitiş sayfalarını (damganın eklenmesi gereken yer) bu yönteme argüman olarak geçirirken PdfApi.postDocumentImageHeader(…) yöntemini çağırın.

// ClientID ve ClientSecret'ı https://dashboard.aspose.cloud/ adresinden edinin
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi örneği
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF belgesini girin
String sourcePDF = "PdfWithAnnotations.pdf";

// PDF'nin başlangıç sayfasına Başlık Resmini yerleştirin
int startPage = 2;

// PDF'nin son sayfasını Başlık Görseli'ne yerleştirin
int endPage = 3;
		        
// ImageHeader nesnesinin bir örneğini oluşturun
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// Başlık Görselini ön plana/görünür hale getir
	headerObject.background(false)
	
	// resim başlığı hizalamasını Sol olarak ayarla
	.horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.LEFT)
	.opacity(0.8)
	.rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
	.rotateAngle(0.)
	.xindent(2.0)
	.yindent(5.0)
	.zoom(1.0);

// PDF'ye Başlık Görseli eklemek için API yöntemini çağırın
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

Altbilgi alanına bir resim eklemek için, ImageFooter sınıfının bir nesnesini oluşturun ve pdfApi sınıfının postDocumentImageFooter(…) metodunu çağırın. Adımların geri kalanı, yukarıdaki Başlık bölümündeki Resim için yukarıda açıklandığı gibi aynı kalacaktır.

Çözüm

Bu makalede, PDF belgelerinin Başlık/Altbilgi alanlarına Metin ve Resim eklemek için cURL komutları aracılığıyla Aspose.PDF Cloud’a nasıl erişileceğine ilişkin adımları ele aldık. Ayrıca, Aspose.PDF Cloud SDK for Java‘yı yükleme ve PDF dosyasının başlık veya altbilgi bölümüne Metin ve Resim eklemek için Java dilinde kullanma adımlarını da inceledik. API’nin diğer heyecan verici özellikleri hakkında daha fazla ayrıntı için lütfen ürün belgelerini inceleyin.

Tüm Cloud SDK’larımız Açık Kaynaklıdır, dolayısıyla tam kaynak kodu GitHub adresinden indirilebilir.

cURL kullanarak Başlığa Metin Ekleme#

Java kullanarak PDF’ye Metin Başlığı Ekleme#

cURL’yi kullanarak PDF Başlığındaki Görüntü#

Java kullanarak Başlığa resim ekleme#

Çözüm#

cURL kullanarak Başlığa Metin Ekleme

Java kullanarak PDF’ye Metin Başlığı Ekleme

cURL’yi kullanarak PDF Başlığındaki Görüntü

Java kullanarak Başlığa resim ekleme

Çözüm