დაამატეთ Header და Footer PDF-ში Java REST API-ის გამოყენებით

სათაური არის ტექსტი, რომელიც მოთავსებულია გვერდის ზედა ნაწილში მდებარე მინდვრის არეში, ხოლო ქვედა კოლონტიტული მოთავსებულია გვერდის ქვედა ნაწილში. როგორც წესი, ეს ზონები გამოიყენება დოკუმენტის ინფორმაციის ჩასართავად, როგორიცაა დოკუმენტის სახელი, თავის სათაური, გვერდის ნომრები, შექმნის თარიღი და ა.შ.

გარდა ამისა, გთხოვთ გაითვალისწინოთ, რომ სათაურები და ქვედა კოლონტიტულები სასარგებლოა თქვენი დოკუმენტის შესახებ სწრაფი ინფორმაციის მოსაწოდებლად პროგნოზირებად ფორმატში და ასევე დაგეხმარებათ დოკუმენტის სხვადასხვა ნაწილების ჩამოყალიბებაში. ამ სტატიაში ჩვენ ვაპირებთ გავიგოთ ტექსტისა და სურათების დამატების შესახებ PDF ფაილების ზედა და ქვედა ზონებში Aspose.PDF Cloud SDK for Java-ის გამოყენებით.

დაამატეთ ტექსტი Header-ში cURL-ის გამოყენებით
ტექსტის სათაურის დამატება PDF-ში Java-ს გამოყენებით
სურათი PDF Header-ში cURL-ის გამოყენებით
დაამატეთ სურათი Header-ში ჯავის გამოყენებით

დაამატეთ ტექსტი Header-ში cURL-ის გამოყენებით

cURL ბრძანებები არის საინტერესო გზა RESTFul API-ებზე წვდომისთვის ბრძანების ხაზის ტერმინალის მეშვეობით. ვინაიდან Aspose.PDF Cloud SDK შემუშავებულია REST პრინციპების შესაბამისად, ასე რომ, მასზე წვდომა მარტივად შეიძლება ბრძანების ხაზის საშუალებით. თუმცა, გთხოვთ, გაითვალისწინოთ, რომ მომხმარებლის კონფიდენციალურობისა და მონაცემთა მთლიანობის უზრუნველსაყოფად, ჩვენი ყველა API ხელმისაწვდომია მხოლოდ ავტორიზებული პირებისთვის. ამიტომ, ჯერ უნდა ეწვიოთ Aspose.Cloud dashboard-ს და თუ გაქვთ GitHub ან Google ანგარიში, უბრალოდ დარეგისტრირდით. წინააღმდეგ შემთხვევაში, დააწკაპუნეთ ღილაკზე Create a new Account და მიაწოდეთ საჭირო ინფორმაცია. ახლა შედით საინფორმაციო დაფაზე რწმუნებათა სიგელების გამოყენებით და გააფართოვეთ აპლიკაციების განყოფილება დაფიდან და გადადით ქვემოთ კლიენტის სერთიფიკატების განყოფილებისკენ, რომ ნახოთ კლიენტის ID და კლიენტის საიდუმლო დეტალები.

შემდეგი ბრძანება გვიჩვენებს, თუ როგორ უნდა შექმნათ JWT წვდომის ნიშანი, რომელიც გამოყენებული იქნება ტექსტის დასამატებლად PDF დოკუმენტის Header ზონაში.

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"

გამოიყენეთ შემდეგი cURL ბრძანება არის ტექსტის დამატება PDF დოკუმენტის სათაურში.

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-ში — სურათი 1: - ტექსტის სათაური დაემატა cURL ბრძანების მეშვეობით.

ამ მაგალითში გამოყენებული ფაილების ნიმუშის ჩამოტვირთვა შესაძლებელია:

ტექსტის სათაურის დამატება PDF-ში Java-ს გამოყენებით

იმისათვის, რომ გამოიყენოთ SDK, ჯერ უნდა დააინსტალიროთ იგი Maven ან GitHub-დან. ქვემოთ მოცემულია დეტალები იმის შესახებ, თუ როგორ უნდა ჩამოტვირთოთ და გამოიყენოთ Aspose.Pdf.jar Maven build პროექტში.

დაამატეთ შემდეგი დამოკიდებულებები თქვენს pom.xml ფაილში.

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

ქვემოთ მოცემულია ნაბიჯები, თუ როგორ უნდა შეასრულოთ ეს მოთხოვნა.

უპირველეს ყოვლისა, შექმენით PdfApi-ის ეგზემპლარი ClientSecret და ClientId დეტალების მიწოდებისას
მეორეც, შექმენით Color ობიექტი ForeGround და BackGround ფერის დეტალების დასადგენად.
მეორეც, შექმენით TextState კლასის ობიექტი.
გამოიყენეთ fontSize(..) მეთოდი შრიფტის ზომის დეტალების დასაყენებლად. შრიფტის (..) მეთოდი შრიფტის სახის განსაზღვრისთვის. foregroundColor(…) მეთოდი განსაზღვრავს ტექსტის წინა პლანზე დეტალებს, ხოლო backgroundColor(…) მეთოდი ფონის ინფორმაციის განსაზღვრისთვის.
ახლა შექმენით TextHeader ობიექტი და განსაზღვრეთ მინდვრის დეტალები.
გამოიყენეთ value(..) მეთოდები Text Header ობიექტის შინაარსის დასაზუსტებლად.
ახლა გამოიძახეთ textState(…) მეთოდი და გადაიტანეთ ზემოთ შექმნილი TextState მაგალითი, როგორც არგუმენტი.
გვერდის შინაარსის უკან Header-ის ჩვენების მიზნით, არგუმენტის სახით გადაიტანეთ ჭეშმარიტი მნიშვნელობა TextHeader კლასის ფონურ(…) მეთოდზე.
ახლა სურათის მარცხენა მხარეს გამოსახულების გამოსატანად, გადაიტანეთ HorizontalAlignment.CENTER მნიშვნელობა horizontalAlignment(…) მეთოდზე.
გამჭვირვალობის(…) მეთოდი მიუთითებს შტამპის გამჭვირვალობაზე. ნაგულისხმევი მნიშვნელობა არის 1.0.
მას შემდეგ რაც დავაყენებთ მასშტაბის მნიშვნელობას, შექმენით AsposeResponse ობიექტი.
დაბოლოს, გამოიძახეთ PdfApi .postDocumentTextHeader(…) მეთოდი და არგუმენტებად გადაიტანეთ წყარო PDF ფაილის სახელი, TextHeader ობიექტი, საწყისი და დასასრული გვერდები (სადაც შტამპი უნდა დაემატოს).

// მიიღეთ ClientID და ClientSecret https://dashboard.aspose.cloud/-დან
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi მაგალითი
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF დოკუმენტის შეყვანა
String sourcePDF = "PdfWithAnnotations.pdf";

// სათაურის გამოსახულების განთავსებისთვის PDF-ის საწყისი გვერდი
int startPage = 2;

// PDF-ის ბოლო გვერდი სათაურის გამოსახულების განთავსებისთვის
int endPage = 3;
		        
// მიუთითეთ წინა პლანის ფერი, როგორც SlateBlue Hex კოდში
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// მიუთითეთ ფონის ფერი, როგორც AntiqueWhite Hex კოდში
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// შექმენით TextState ობიექტი შრიფტის ზომის, სახის და ფერის დეტალების დასადგენად
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// შექმენით TextHeader ობიექტის მაგალითი
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // შესასრულებელი ტექსტის სათაურის შინაარსი
  .value("Aspose.PDF Cloud SDK For Java")
	
  // დააყენეთ გასწორება ცენტრში
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // დააყენეთ სათაურის ტექსტი გვერდის შინაარსის უკან
  headerObject.background(true)
	
  // დააყენეთ ტექსტის სათაურის გასწორება ცენტრში
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // დააყენეთ ტექსტის სათაურის გამჭვირვალობა 0.8-ად
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// გამოიძახეთ API მეთოდი PDF-ში ტექსტის სათაურის დასამატებლად
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

ტექსტის სათაური დაემატა Java-ში — სურათი 2: - ტექსტის სათაურის გადახედვა, რომელიც დაემატა Java-ს.

ქვედა კოლონტიტულის არეში ტექსტის დასამატებლად, გთხოვთ, შექმნათ TextFooter კლასის მაგალითი და გამოიძახოთ PdfApi კლასის postDocumentTextFooter(…) მეთოდი. დარჩენილი ნაბიჯები და დეტალები იგივე დარჩება, როგორც ზემოთ აღინიშნა ტექსტის სათაურის დასამატებლად.

სურათი PDF Header-ში cURL-ის გამოყენებით

ჩვენ შეგვიძლია მარტივად დავამატოთ გამოსახულების ფაილები PostDocumentImageHeader API-ის გამოყენებით PDF ფაილის სათაურის განყოფილებაში cURL ბრძანების გამოყენებით. სურათის შტამპის დამატებისას, ჩვენ ვიღებთ შესაძლებლობას მივუთითოთ HorizontalAlignment, Opacity, RotateAngle, სურათის მასშტაბირების ფაქტორი, სიგანე, სიმაღლე, მარცხენა მარგი, TopMargin, RightMargin და ა.შ.

სახელის პარამეტრი განსაზღვრავს შეყვანის/წყაროს PDF დოკუმენტს, imageHeader განსაზღვრავს გამოსახულების ფაილს, რომელიც უნდა იყოს დაბეჭდილი, startPageNumber თვისება განსაზღვრავს PDF დოკუმენტის საწყის გვერდს და endPageNumber საბოლოო გვერდს, რომ შეიცავდეს გამოსახულების შტამპებს. შემდეგ cURL ბრძანებაში Background თვისება დაყენებულია როგორც false, რათა გამოსახულება იყოს ხილული. HorizontalAlignment მითითებულია როგორც Left, Opacity მნიშვნელობა განისაზღვრება როგორც 0.8, Zoom ფაქტორი დაყენებულია როგორც 1, Width განისაზღვრება როგორც 250, Height განისაზღვრება როგორც 80 ქულა და RightMargin მითითებულია როგორც 500 ქულა.

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

გამოსახულების შტამპი Header-ში — სურათი 3: - გამოსახულების ბეჭედი PDF-ის სათაურის განყოფილებაში.

ზემოთ მოცემულ მაგალითში გამოყენებული ფაილების ნიმუში შეგიძლიათ ჩამოტვირთოთ შემდეგი ბმულიდან:

დაამატეთ სურათი Header-ში Java-ს გამოყენებით

Aspose.PDF Cloud SDK Java-სთვის გთავაზობთ გასაოცარ ფუნქციას გამოსახულების სათაურის დასამატებლად PDF ფაილში ნაკლები კოდის ხაზებით.

ქვემოთ მოცემულია ნაბიჯები, თუ როგორ უნდა დაამატოთ გამოსახულების სათაური PDF დოკუმენტში

შექმენით PdfApi-ის ობიექტი ClientSecret და ClientId დეტალების მიწოდებისას.
მეორეც, შექმენით ImageHeader კლასის ობიექტი.
გამოსახულების სიგანისა და სიმაღლის დეტალების დასაყენებლად გამოიყენეთ ImageHeader კლასის სიგანე(..) და სიმაღლე(…) მეთოდები.
ახლა გამოიყენეთ fileName(…) მეთოდი სათაურის გამოსახულების ბილიკის დეტალების დასაყენებლად.
გვერდის შინაარსის უკან გამოსახულების ჩვენების მიზნით, გადაიტანეთ ცრუ არგუმენტი ფონზე(…) მეთოდზე.
ახლა გამოსახულების მარცხენა მხარეს გამოსახულების გასაკეთებლად, გადაიტანეთ HorizontalAlignment.LEFT მნიშვნელობა horizontalAlignment(…) მეთოდზე.
გამჭვირვალობის(…) მეთოდი მიუთითებს შტამპის გამჭვირვალობაზე. ნაგულისხმევი მნიშვნელობა არის 1.0.
მას შემდეგ რაც დავაყენეთ მასშტაბის მნიშვნელობა, შექმენით AsposeResponse ობიექტი.
დაბოლოს, გამოიძახეთ PdfApi.postDocumentImageHeader(…) მეთოდი ამ მეთოდის არგუმენტად წყაროს PDF ფაილის სახელის, ImageHeader ობიექტის, საწყისი და დასასრული გვერდების (სადაც შტამპის დამატებაა საჭირო) გადაცემისას.

// მიიღეთ ClientID და ClientSecret https://dashboard.aspose.cloud/-დან
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi მაგალითი
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF დოკუმენტის შეყვანა
String sourcePDF = "PdfWithAnnotations.pdf";

// სათაურის გამოსახულების განთავსებისთვის PDF-ის საწყისი გვერდი
int startPage = 2;

// PDF-ის ბოლო გვერდი სათაურის გამოსახულების განთავსებისთვის
int endPage = 3;
		        
// შექმენით ImageHeader ობიექტის მაგალითი
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// სათაურის გამოსახულების წინა პლანზე/ხილვაზე მოყვანა
	headerObject.background(false)
	
	// დააყენეთ სურათის სათაურის გასწორება მარცხნივ
	.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);

// გამოიძახეთ API მეთოდი სათაურის გამოსახულების PDF-ში დასამატებლად
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

სურათის დასამატებლად ქვედა კოლონტიტულის არეში, შექმენით ImageFooter კლასის ობიექტი და გამოიძახეთ pdfApi კლასის postDocumentImageFooter(…) მეთოდი. დანარჩენი ნაბიჯები იგივე დარჩება, როგორც ზემოთ აღწერილი სურათისთვის ზემოთ სათაურის განყოფილებაში.

დასკვნა

ამ სტატიაში ჩვენ განვიხილეთ ნაბიჯები Aspose.PDF Cloud-ზე წვდომის შესახებ cURL ბრძანებების მეშვეობით ტექსტისა და სურათების დასამატებლად PDF დოკუმენტების Header/Footer ზონებში. ჩვენ ასევე გამოვიკვლიეთ ნაბიჯები, რათა დააინსტალიროთ Aspose.PDF Cloud SDK for Java და გამოვიყენოთ იგი Java ენაზე ტექსტისა და სურათის დასამატებლად PDF ფაილის სათაურში ან ქვედა ნაწილში. დამატებითი ინფორმაციისთვის API-ის სხვა საინტერესო ფუნქციების შესახებ, გთხოვთ, დაათვალიეროთ პროდუქტის დოკუმენტაცია.

ყველა ჩვენი Cloud SDK არის OpenSource, ამიტომ სრული კოდის ჩამოტვირთვა შესაძლებელია GitHub-დან.

დაამატეთ ტექსტი Header-ში cURL-ის გამოყენებით#

ტექსტის სათაურის დამატება PDF-ში Java-ს გამოყენებით#

სურათი PDF Header-ში cURL-ის გამოყენებით#

დაამატეთ სურათი Header-ში Java-ს გამოყენებით#

დასკვნა#

დაამატეთ ტექსტი Header-ში cURL-ის გამოყენებით

ტექსტის სათაურის დამატება PDF-ში Java-ს გამოყენებით

სურათი PDF Header-ში cURL-ის გამოყენებით

დაამატეთ სურათი Header-ში Java-ს გამოყენებით

დასკვნა