Thêm Header và Footer vào PDF bằng Java REST API

Tiêu đề là một văn bản được đặt ở vùng lề trên cùng của trang, trong khi chân trang được đặt ở dưới cùng hoặc chân trang. Thông thường, các vùng này được sử dụng để chèn thông tin tài liệu, chẳng hạn như tên tài liệu, tiêu đề chương, số trang, ngày tạo, v.v. Thông tin này được lặp lại trên mỗi trang và do đó cho phép người đọc dễ dàng điều hướng tài liệu.

Ngoài ra, hãy lưu ý rằng Header và Footer hữu ích trong việc cung cấp thông tin nhanh về tài liệu của bạn theo định dạng có thể dự đoán được và cũng giúp thiết lập các phần khác nhau của tài liệu. Trong bài viết này, chúng ta sẽ tìm hiểu về cách thêm văn bản và hình ảnh vào các vùng Header và Footer của tệp PDF bằng cách sử dụng Aspose.PDF Cloud SDK for Java.

Thêm văn bản vào tiêu đề bằng cURL
Thêm Tiêu đề Văn bản vào PDF bằng Java
Hình ảnh trong Tiêu đề PDF sử dụng cURL
Thêm hình ảnh vào Header bằng Java

Thêm văn bản vào tiêu đề bằng cURL

Lệnh cURL là một cách thú vị để truy cập API RESTFul thông qua thiết bị đầu cuối dòng lệnh. Vì Aspose.PDF Cloud SDK được phát triển theo nguyên tắc REST, nên có thể dễ dàng truy cập thông qua dấu nhắc lệnh. Tuy nhiên, xin lưu ý rằng để đảm bảo quyền riêng tư của người dùng và tính toàn vẹn của dữ liệu, tất cả các API của chúng tôi chỉ có thể truy cập được đối với những người được ủy quyền. Do đó, trước tiên bạn cần truy cập bảng điều khiển Aspose.Cloud và nếu bạn có tài khoản GitHub hoặc Google, chỉ cần Đăng ký. Nếu không, hãy nhấp vào nút Tạo tài khoản mới và cung cấp thông tin bắt buộc. Bây giờ hãy đăng nhập vào bảng điều khiển bằng thông tin xác thực và mở rộng phần Ứng dụng từ bảng điều khiển và cuộn xuống phần Thông tin xác thực của khách hàng để xem thông tin chi tiết về ID khách hàng và Bí mật khách hàng.

Lệnh sau đây cho biết cách tạo mã thông báo truy cập JWT sẽ được sử dụng để thêm văn bản vào vùng Tiêu đề của tài liệu 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"

Sử dụng lệnh cURL sau để thêm Văn bản vào phần tiêu đề của tài liệu 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}"

Tiêu đề văn bản trong PDF — Hình ảnh 1: - Tiêu đề văn bản được thêm vào thông qua lệnh cURL.

Các tệp mẫu được sử dụng trong ví dụ này có thể được tải xuống từ:

Thêm Tiêu đề Văn bản vào PDF bằng Java

Để sử dụng SDK, trước tiên bạn cần cài đặt nó từ Maven hoặc GitHub. Dưới đây là thông tin chi tiết về cách tải xuống và sử dụng Aspose.Pdf.jar trong dự án xây dựng Maven.

Thêm các phụ thuộc sau vào tệp pom.xml của bạn.

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

Dưới đây là các bước thực hiện yêu cầu này.

Trước hết, hãy tạo một phiên bản của PdfApi trong khi cung cấp thông tin chi tiết về ClientSecret và ClientId
Thứ hai, tạo đối tượng Color để xác định chi tiết màu ForeGround và BackGround.
Thứ hai, tạo một đối tượng của lớp TextState.
Sử dụng phương thức fontSize(..) để thiết lập chi tiết kích thước phông chữ. Phương thức font(..) để xác định mặt phông chữ. Phương thức foregroundColor(…) xác định chi tiết nền trước của văn bản và phương thức backgroundColor(…) để xác định thông tin nền.
Bây giờ hãy tạo đối tượng TextHeader và xác định chi tiết lề.
Sử dụng phương thức value(..) để chỉ định nội dung của đối tượng Tiêu đề văn bản.
Bây giờ hãy gọi phương thức textState(…) và truyền thể hiện TextState đã tạo ở trên làm đối số.
Để hiển thị Header phía sau nội dung trang, hãy truyền giá trị true làm đối số cho phương thức background(…) của lớp TextHeader.
Bây giờ để hiển thị hình ảnh ở phía bên trái, hãy truyền giá trị HorizontalAlignment.CENTER vào phương thức horizontalAlignment(…).
Phương thức opacity(…) chỉ ra độ mờ đục của tem. Giá trị mặc định là 1.0.
Sau khi đã thiết lập giá trị thu phóng, hãy tạo đối tượng AsposeResponse.
Cuối cùng, gọi phương thức PdfApi .postDocumentTextHeader(…) và truyền tên tệp PDF nguồn, đối tượng TextHeader, trang bắt đầu và kết thúc (nơi cần thêm dấu) làm đối số.

// Nhận ClientID và ClientSecret từ https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// thể hiện createPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// nhập tài liệu PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// trang bắt đầu của PDF để đặt Hình ảnh tiêu đề
int startPage = 2;

// trang cuối của PDF để đặt Hình ảnh tiêu đề
int endPage = 3;
		        
// chỉ định màu nền trước là SlateBlue trong mã Hex
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// chỉ định màu nền là AntiqueWhite trong mã Hex
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// Tạo đối tượng TextState để xác định kích thước phông chữ, khuôn mặt và chi tiết màu sắc
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// tạo một thể hiện của đối tượng TextHeader
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // nội dung của tiêu đề Văn bản sẽ được hiển thị
  .value("Aspose.PDF Cloud SDK For Java")
	
  // đặt căn chỉnh ở giữa
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // đặt Văn bản Tiêu đề phía sau nội dung trang
  headerObject.background(true)
	
  // đặt căn chỉnh Tiêu đề văn bản thành Trung tâm
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // đặt độ mờ đục của Tiêu đề văn bản là 0,8
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// gọi phương thức API để thêm Tiêu đề văn bản vào PDF
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

Tiêu đề văn bản được thêm vào Java — Hình ảnh 2:- Xem trước Tiêu đề văn bản được thêm bằng Java.

Để thêm văn bản vào vùng chân trang, vui lòng tạo một thể hiện của lớp TextFooter và gọi phương thức postDocumentTextFooter(…) của lớp PdfApi. Các bước và chi tiết còn lại sẽ giống như đã đề cập ở trên để thêm Tiêu đề văn bản.

Hình ảnh trong Tiêu đề PDF sử dụng cURL

Chúng ta có thể dễ dàng thêm các tệp hình ảnh bằng API PostDocumentImageHeader trong phần tiêu đề của tệp PDF bằng lệnh cURL. Trong khi thêm tem hình ảnh, chúng ta có tùy chọn để chỉ định Căn chỉnh ngang, Độ mờ, Góc xoay, Hệ số thu phóng của hình ảnh, Chiều rộng, Chiều cao, Lề trái, Lề trên, Lề phải, v.v.

Tham số name định nghĩa tài liệu PDF đầu vào/nguồn, imageHeader chỉ định tệp hình ảnh sẽ được đóng dấu, thuộc tính startPageNumber định nghĩa trang bắt đầu và endPageNumber trang kết thúc của tài liệu PDF để chứa các dấu hình ảnh. Trong lệnh cURL sau, thuộc tính Background được đặt thành false để hình ảnh có thể nhìn thấy. HorizontalAlignment được chỉ định là Left, giá trị Opacity được định nghĩa là 0.8, hệ số Zoom được đặt thành 1, Width được định nghĩa là 250, Height được định nghĩa là 80 điểm và RightMargin được chỉ định là 500 điểm.

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

Con dấu hình ảnh trong Header — Hình ảnh 3:- Đóng dấu hình ảnh ở phần Tiêu đề của PDF.

Các tệp mẫu được sử dụng trong ví dụ trên có thể được tải xuống từ liên kết sau:

Thêm hình ảnh vào Header bằng Java

Aspose.PDF Cloud SDK cho Java cung cấp một tính năng đáng chú ý để thêm Tiêu đề hình ảnh vào tệp PDF với ít dòng mã hơn.

Dưới đây là các bước về cách thêm Tiêu đề hình ảnh vào tài liệu PDF

Tạo đối tượng PdfApi trong khi cung cấp thông tin chi tiết về ClientSecret và ClientId.
Thứ hai, tạo một đối tượng của lớp ImageHeader.
Sử dụng phương thức width(..) và height(…) của lớp ImageHeader để thiết lập chi tiết chiều rộng và chiều cao của hình ảnh.
Bây giờ hãy sử dụng phương thức fileName(…) để thiết lập chi tiết đường dẫn cho hình ảnh tiêu đề.
Để hiển thị hình ảnh phía sau nội dung trang, hãy truyền đối số false vào phương thức background(…).
Bây giờ để hiển thị hình ảnh ở phía bên trái, hãy truyền giá trị HorizontalAlignment.LEFT vào phương thức horizontalAlignment(…).
Phương thức opacity(…) chỉ ra độ mờ đục của tem. Giá trị mặc định là 1.0.
Sau khi thiết lập giá trị thu phóng, hãy tạo đối tượng AsposeResponse.
Cuối cùng, gọi phương thức PdfApi.postDocumentImageHeader(…) trong khi truyền tên tệp PDF nguồn, đối tượng ImageHeader, trang bắt đầu và kết thúc (nơi cần thêm dấu) làm đối số cho phương thức này.

// Nhận ClientID và ClientSecret từ https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// thể hiện createPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// nhập tài liệu PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// trang bắt đầu của PDF để đặt Hình ảnh tiêu đề
int startPage = 2;

// trang cuối của PDF để đặt Hình ảnh tiêu đề
int endPage = 3;
		        
// tạo một thể hiện của đối tượng ImageHeader
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// đưa Hình ảnh Tiêu đề lên phía trước/có thể nhìn thấy
	headerObject.background(false)
	
	// đặt căn chỉnh tiêu đề hình ảnh là Trái
	.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);

// gọi phương thức API để thêm Hình ảnh Tiêu đề vào PDF
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

Để thêm hình ảnh vào vùng chân trang, hãy tạo một đối tượng của lớp ImageFooter và gọi phương thức postDocumentImageFooter(…) của lớp pdfApi. Các bước còn lại sẽ vẫn giống như đã giải thích ở trên đối với Hình ảnh trong phần Tiêu đề ở trên.

Phần kết luận

Trong bài viết này, chúng tôi đã thảo luận các bước về cách truy cập Aspose.PDF Cloud thông qua lệnh cURL để thêm Văn bản và Hình ảnh vào vùng Đầu trang/Chân trang của tài liệu PDF. Chúng tôi cũng đã khám phá các bước để cài đặt Aspose.PDF Cloud SDK cho Java và sử dụng nó bằng ngôn ngữ Java để thêm Văn bản và Hình ảnh vào phần đầu trang hoặc chân trang của tệp PDF. Để biết thêm chi tiết về các tính năng thú vị khác của API, vui lòng khám phá tài liệu sản phẩm.

Tất cả Cloud SDK của chúng tôi đều là mã nguồn mở, do đó bạn có thể tải xuống mã nguồn đầy đủ từ GitHub.

Thêm văn bản vào tiêu đề bằng cURL#

Thêm Tiêu đề Văn bản vào PDF bằng Java#

Hình ảnh trong Tiêu đề PDF sử dụng cURL#

Thêm hình ảnh vào Header bằng Java#

Phần kết luận#

Thêm văn bản vào tiêu đề bằng cURL

Thêm Tiêu đề Văn bản vào PDF bằng Java

Hình ảnh trong Tiêu đề PDF sử dụng cURL

Thêm hình ảnh vào Header bằng Java

Phần kết luận