เพิ่มส่วนหัวและส่วนท้ายใน PDF โดยใช้ Java REST API

ส่วนหัวคือข้อความที่วางไว้ในบริเวณขอบด้านบนของหน้า ส่วนส่วนท้ายจะวางไว้ที่ด้านล่างหรือท้ายหน้า โดยปกติแล้ว พื้นที่เหล่านี้ใช้สำหรับแทรกข้อมูลเอกสาร เช่น ชื่อเอกสาร หัวข้อบท หมายเลขหน้า วันที่สร้าง เป็นต้น ข้อมูลนี้จะถูกทำซ้ำในแต่ละหน้า ทำให้ผู้อ่านสามารถนำทางเอกสารได้อย่างง่ายดาย

นอกจากนี้ โปรดทราบว่าส่วนหัวและส่วนท้ายมีประโยชน์ในการให้ข้อมูลอย่างรวดเร็วเกี่ยวกับเอกสารของคุณในรูปแบบที่คาดเดาได้ และยังช่วยในการกำหนดส่วนต่างๆ ของเอกสารอีกด้วย ในบทความนี้ เราจะเรียนรู้เกี่ยวกับการเพิ่มข้อความและรูปภาพในพื้นที่ส่วนหัวและส่วนท้ายของไฟล์ PDF โดยใช้ Aspose.PDF Cloud SDK for Java

เพิ่มข้อความลงในส่วนหัวโดยใช้ cURL
การเพิ่มส่วนหัวข้อความใน PDF โดยใช้ Java
รูปภาพในส่วนหัว PDF โดยใช้ cURL
เพิ่มรูปภาพในส่วนหัวโดยใช้ Java

เพิ่มข้อความลงในส่วนหัวโดยใช้ cURL

คำสั่ง cURL เป็นวิธีที่น่าตื่นเต้นในการเข้าถึง RESTFul API ผ่านเทอร์มินัลบรรทัดคำสั่ง เนื่องจาก Aspose.PDF Cloud SDK ได้รับการพัฒนาตามหลักการ REST จึงสามารถเข้าถึงได้ง่ายผ่านพรอมต์คำสั่ง อย่างไรก็ตาม โปรดทราบว่าเพื่อให้แน่ใจว่าผู้ใช้มีความเป็นส่วนตัวและความสมบูรณ์ของข้อมูล API ทั้งหมดของเราสามารถเข้าถึงได้โดยบุคคลที่ได้รับอนุญาตเท่านั้น ดังนั้น คุณต้องไปที่ Aspose.Cloud Dashboard ก่อน และหากคุณมีบัญชี GitHub หรือ Google ให้ลงทะเบียน มิฉะนั้น ให้คลิกที่ปุ่ม สร้างบัญชีใหม่ และระบุข้อมูลที่จำเป็น จากนั้นเข้าสู่ระบบแดชบอร์ดโดยใช้ข้อมูลประจำตัวและขยายส่วนแอปพลิเคชันจากแดชบอร์ดและเลื่อนลงไปที่ส่วนข้อมูลประจำตัวไคลเอนต์เพื่อดูรายละเอียดรหัสไคลเอนต์และความลับไคลเอนต์

คำสั่งต่อไปนี้จะแสดงวิธีสร้างโทเค็นการเข้าถึง JWT ซึ่งจะใช้ในการเพิ่มข้อความในพื้นที่ส่วนหัวของเอกสาร PDF

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 โดยใช้ Java

หากต้องการใช้ SDK คุณต้องติดตั้งก่อนจาก Maven หรือ GitHub ด้านล่างนี้คือรายละเอียดเกี่ยวกับวิธีดาวน์โหลดและใช้ Aspose.Pdf.jar ในโครงการสร้าง Maven

เพิ่มการอ้างอิงต่อไปนี้ในไฟล์ 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(..) เพื่อกำหนดรายละเอียดขนาดฟอนต์ เมธอด font(..) เพื่อกำหนดหน้าฟอนต์ เมธอด foregroundColor(…) กำหนดรายละเอียดข้อความเบื้องหน้า และเมธอด backgroundColor(…) เพื่อกำหนดข้อมูลพื้นหลัง
ตอนนี้สร้างวัตถุ TextHeader และกำหนดรายละเอียดระยะขอบ
ใช้เมธอด value(..) เพื่อระบุเนื้อหาของวัตถุ Text Header
ตอนนี้เรียกใช้เมธอด textState(…) และส่งอินสแตนซ์ TextState ที่สร้างขึ้นข้างต้นเป็นอาร์กิวเมนต์
เพื่อแสดงส่วนหัวด้านหลังเนื้อหาหน้า ให้ส่งค่าจริงเป็นอาร์กิวเมนต์ไปยังวิธี background(…) ของคลาส TextHeader
เพื่อที่จะเรนเดอร์รูปภาพทางด้านซ้าย ให้ส่งค่า HorizontalAlignment.CENTER ไปที่เมธอด horizontalAlignment(…)
วิธี opacity(…) ระบุความทึบของแสตมป์ ค่าเริ่มต้นคือ 1.0
เมื่อเราตั้งค่าการซูมแล้ว ให้สร้างอ็อบเจ็กต์ AsposeResponse
ในที่สุด เรียกวิธี PdfApi .postDocumentTextHeader(…) และส่งชื่อไฟล์ PDF ต้นฉบับ, ออบเจ็กต์ TextHeader, หน้าเริ่มต้นและหน้าสิ้นสุด (ที่ต้องเพิ่มสแตมป์) เป็นอาร์กิวเมนต์

// รับ ClientID และ ClientSecret จาก https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// สร้างอินสแตนซ์ PdfApi
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 เพื่อเพิ่ม Text Header ลงใน PDF
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

เพิ่มส่วนหัวข้อความใน Java — ภาพที่ 2:- ตัวอย่างข้อความส่วนหัวที่เพิ่มด้วย Java

หากต้องการเพิ่มข้อความในพื้นที่ส่วนท้าย โปรดสร้างอินสแตนซ์ของคลาส TextFooter และเรียกใช้เมธอด postDocumentTextFooter(…) ของคลาส PdfApi ขั้นตอนและรายละเอียดที่เหลือจะเหมือนกับที่กล่าวไว้ข้างต้นสำหรับการเพิ่ม Text Header

รูปภาพในส่วนหัว PDF โดยใช้ cURL

เราสามารถเพิ่มไฟล์รูปภาพได้อย่างง่ายดายโดยใช้ API PostDocumentImageHeader ในส่วนหัวของไฟล์ PDF โดยใช้คำสั่ง cURL ในขณะที่เพิ่มตราประทับรูปภาพ เราจะได้รับตัวเลือกในการระบุการจัดแนวแนวนอน ความทึบ มุมหมุน ปัจจัยการซูมของรูปภาพ ความกว้าง ความสูง ขอบซ้าย ขอบบน ขอบขวา และรายละเอียดอื่นๆ

พารามิเตอร์ name กำหนดเอกสาร PDF อินพุต/แหล่งที่มา imageHeader ระบุไฟล์ภาพที่จะประทับ คุณสมบัติ startPageNumber กำหนดหน้าเริ่มต้นและหน้าสิ้นสุด endPageNumber ของเอกสาร PDF เพื่อบรรจุแสตมป์ภาพ ในคำสั่ง cURL ต่อไปนี้ คุณสมบัติ Background จะถูกตั้งค่าเป็น false เพื่อให้มองเห็นภาพได้ ระบุการจัดแนวแนวนอนเป็นซ้าย ค่าความทึบเป็น 0.8 ปัจจัยการซูมเป็น 1 ระบุความกว้างเป็น 250 ระบุความสูงเป็น 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}"

แสตมป์ภาพในส่วนหัว — ภาพที่ 3:- ประทับภาพในส่วนหัวของ PDF

ไฟล์ตัวอย่างที่ใช้ในตัวอย่างข้างต้นสามารถดาวน์โหลดได้จากลิงค์ต่อไปนี้:

เพิ่มรูปภาพในส่วนหัวโดยใช้ Java

Aspose.PDF Cloud SDK สำหรับ Java มีคุณลักษณะที่โดดเด่นในการเพิ่ม Image Header ในไฟล์ PDF ด้วยบรรทัดโค้ดที่น้อยลง

ด้านล่างนี้เป็นขั้นตอนเกี่ยวกับวิธีเพิ่มส่วนหัวของรูปภาพในเอกสาร PDF

สร้างอ็อบเจ็กต์ของ PdfApi โดยให้รายละเอียด ClientSecret และ ClientId
ประการที่สอง สร้างอ็อบเจ็กต์ของคลาส ImageHeader
ใช้เมธอด width(..) และ height(…) ของคลาส ImageHeader เพื่อกำหนดรายละเอียดความกว้างและความสูงของรูปภาพ
ตอนนี้ใช้เมธอด fileName(…) เพื่อกำหนดรายละเอียดเส้นทางสำหรับรูปภาพส่วนหัว
เพื่อแสดงรูปภาพด้านหลังเนื้อหาหน้า ให้ส่งอาร์กิวเมนต์ false ไปที่เมธอด background(…)
เพื่อที่จะเรนเดอร์ภาพทางด้านซ้าย ให้ส่งค่า HorizontalAlignment.LEFT ไปที่เมธอด horizontalAlignment(…)
วิธี opacity(…) ระบุความทึบของแสตมป์ ค่าเริ่มต้นคือ 1.0
เมื่อเราตั้งค่าการซูมแล้ว ให้สร้างอ็อบเจ็กต์ AsposeResponse
ในที่สุด เรียกใช้เมธอด PdfApi.postDocumentImageHeader(…) ในขณะส่งชื่อไฟล์ PDF ต้นฉบับ อ็อบเจ็กต์ ImageHeader หน้าเริ่มต้นและหน้าสิ้นสุด (ที่ต้องเพิ่มสแตมป์) เป็นอาร์กิวเมนต์ให้กับเมธอดนี้

// รับ ClientID และ ClientSecret จาก https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// สร้างอินสแตนซ์ PdfApi
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 และเรียกใช้เมธอด postDocumentImageFooter(…) ของคลาส pdfApi ขั้นตอนที่เหลือจะเหมือนกับที่อธิบายไว้ข้างต้นสำหรับรูปภาพในส่วนส่วนหัว

บทสรุป

ในบทความนี้ เราได้กล่าวถึงขั้นตอนในการเข้าถึง Aspose.PDF Cloud ผ่านคำสั่ง cURL เพื่อเพิ่มข้อความและรูปภาพในส่วนส่วนหัว/ส่วนท้ายของเอกสาร PDF นอกจากนี้ เรายังได้กล่าวถึงขั้นตอนในการติดตั้ง Aspose.PDF Cloud SDK for Java และใช้งานในภาษา Java เพื่อเพิ่มข้อความและรูปภาพในส่วนส่วนหัวหรือส่วนท้ายของไฟล์ PDF หากต้องการทราบรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์ที่น่าสนใจอื่นๆ ของ API โปรดอ่าน เอกสารผลิตภัณฑ์

Cloud SDK ของเราทั้งหมดเป็นโอเพ่นซอร์ส ดังนั้นสามารถดาวน์โหลดโค้ดต้นฉบับที่สมบูรณ์ได้จาก GitHub

เพิ่มข้อความลงในส่วนหัวโดยใช้ cURL#

การเพิ่มส่วนหัวข้อความใน PDF โดยใช้ Java#

รูปภาพในส่วนหัว PDF โดยใช้ cURL#

เพิ่มรูปภาพในส่วนหัวโดยใช้ Java#

บทสรุป#

เพิ่มข้อความลงในส่วนหัวโดยใช้ cURL

การเพิ่มส่วนหัวข้อความใน PDF โดยใช้ Java

รูปภาพในส่วนหัว PDF โดยใช้ cURL

เพิ่มรูปภาพในส่วนหัวโดยใช้ Java

บทสรุป