Додайте верхній і нижній колонтитули в PDF за допомогою Java REST API

Верхній колонтитул — це текст, який розміщується на полях у верхній частині сторінки, а нижній колонтитул — у нижній частині сторінки. Зазвичай ці області використовуються для вставлення інформації про документ, такої як назва документа, заголовок розділу, номери сторінок, дата створення тощо. Ця інформація повторюється на кожній сторінці, що дозволяє читачеві легко орієнтуватися в документі.

Крім того, майте на увазі, що колонтитули корисні для надання швидкої інформації про ваш документ у передбачуваному форматі, а також допомагають викладати різні частини документа. У цій статті ми дізнаємося про додавання тексту та зображень до областей верхнього та нижнього колонтитулів файлів PDF за допомогою Aspose.PDF Cloud SDK для Java.

Додайте текст до заголовка за допомогою cURL
Додавання текстового заголовка в PDF за допомогою Java
Зображення в заголовку PDF за допомогою cURL
Додайте зображення в заголовок за допомогою Java

Додайте текст до заголовка за допомогою cURL

Команди cURL — це захоплюючий спосіб отримати доступ до API RESTFul через термінал командного рядка. Оскільки Aspose.PDF Cloud SDK розроблено відповідно до принципів REST, тому до нього можна легко отримати доступ через командний рядок. Однак зауважте, що для забезпечення конфіденційності та цілісності даних користувачів усі наші API доступні лише авторизованим особам. Тому вам потрібно спочатку відвідати інформаційну панель Aspose.Cloud і, якщо у вас є обліковий запис 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 — Зображення 1: - Текстовий заголовок додано за допомогою команди cURL.

Зразки файлів, використаних у цьому прикладі, можна завантажити з:

Додавання текстового заголовка в 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, щоб визначити деталі кольорів переднього та заднього планів.
По-друге, створіть об’єкт класу 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";
				
// екземпляр createPdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// вхідний документ PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// початкова сторінка PDF-файлу, щоб розмістити зображення заголовка
int startPage = 2;

// кінцева сторінка PDF-файлу для розміщення зображення заголовка
int endPage = 3;
		        
// вкажіть колір переднього плану як SlateBlue у шістнадцятковому коді
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// вкажіть колір фону як AntiqueWhite у шістнадцятковому коді
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 і викличте метод postDocumentTextFooter(…) класу PdfApi. Решта кроків і деталей залишаться тими самими, що й згадані вище для додавання текстового заголовка.

Зображення в заголовку PDF за допомогою cURL

Ми можемо легко додавати файли зображень за допомогою API PostDocumentImageHeader у розділ заголовка файлу PDF за допомогою команди cURL. Додаючи штамп зображення, ми отримуємо можливість вказати HorizontalAlignment, Opacity, RotateAngle, коефіцієнт масштабування зображення, Width, Height, LeftMargin, TopMargin, RightMargin тощо.

Параметр name визначає вхідний/вихідний PDF-документ, imageHeader визначає файл зображення, до якого потрібно поставити штамп, властивість startPageNumber визначає початкову сторінку та endPageNumber кінцеву сторінку PDF-документа, які містять позначки зображення. У наступній команді cURL для властивості Background встановлено значення false, щоб зображення було видимим. HorizontalAlignment вказано як Left, значення Opacity визначено як 0,8, коефіцієнт масштабування встановлено як 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}"

Штамп зображення в заголовку — Зображення 3: - Штамп зображення в розділі заголовка PDF-файлу.

Зразки файлів, використаних у прикладі вище, можна завантажити за таким посиланням:

Додайте зображення в заголовок за допомогою Java

Aspose.PDF Cloud SDK для Java надає чудову функцію для додавання заголовка зображення у файл 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";
				
// екземпляр 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 і викличте метод postDocumentImageFooter(…) класу pdfApi. Решта кроків залишаться такими ж, як описано вище для розділу «Зображення в заголовку».

Висновок

У цій статті ми обговорили кроки, як отримати доступ до Aspose.PDF Cloud за допомогою команд cURL, щоб додати текст і зображення в області верхнього/нижнього колонтитула документів PDF. Ми також дослідили кроки для встановлення Aspose.PDF Cloud SDK для Java та використання його мовою Java для додавання тексту та зображення в розділ верхнього або нижнього колонтитула PDF-файлу. Щоб дізнатися більше про інші захоплюючі функції API, перегляньте документацію продукту.

Усі наші Cloud SDK є OpenSource, тому повний вихідний код можна завантажити з GitHub.

Додайте текст до заголовка за допомогою cURL#

Додавання текстового заголовка в PDF за допомогою Java#

Зображення в заголовку PDF за допомогою cURL#

Додайте зображення в заголовок за допомогою Java#

Висновок#

Додайте текст до заголовка за допомогою cURL

Додавання текстового заголовка в PDF за допомогою Java

Зображення в заголовку PDF за допомогою cURL

Додайте зображення в заголовок за допомогою Java

Висновок