Adjon hozzá fejlécet és láblécet a PDF-hez a Java REST API segítségével

A fejléc olyan szöveg, amely az oldal tetején a margóterületen, míg a lábléc az oldal alján vagy alján található. Általában ezek a területek a dokumentuminformációk beszúrására szolgálnak, mint például a dokumentum neve, fejezetcím, oldalszámok, létrehozási dátum stb. Ezek az információk minden oldalon megismétlődnek, így az olvasó könnyen navigálhat a dokumentumban.

Továbbá, kérjük, vegye figyelembe, hogy a fejlécek és láblécek hasznosak abban, hogy kiszámítható formátumban gyors információkat nyújtsanak a dokumentumról, és segítséget nyújtanak a dokumentum különböző részeinek kijelölésében. Ebben a cikkben megtudjuk, hogyan adhatunk szöveget és képeket a PDF fájlok fejléc- és láblécterületéhez az Aspose.PDF Cloud SDK for Java használatával.

Szöveg hozzáadása a fejléchez a cURL használatával
Szövegfejléc hozzáadása a PDF-hez Java használatával
Kép a PDF fejlécében a cURL használatával
Kép hozzáadása a fejléchez Java használatával

Szöveg hozzáadása a fejléchez a cURL használatával

A cURL parancsok izgalmas módja a RESTFul API-k parancssori terminálon keresztüli elérésének. Mivel az Aspose.PDF Cloud SDK a REST elvek szerint lett kifejlesztve, így könnyen elérhető parancssoron keresztül. Felhívjuk azonban figyelmét, hogy a felhasználói adatvédelem és az adatok sértetlenségének biztosítása érdekében minden API-nkat csak az arra jogosult személyek férhetnek hozzá. Ezért először meg kell látogatnia az Aspose.Cloud dashboard webhelyet, és ha rendelkezik GitHub- vagy Google-fiókkal, egyszerűen regisztráljon. Ellenkező esetben kattintson az Új fiók létrehozása gombra, és adja meg a szükséges információkat. Most jelentkezzen be az irányítópultra a hitelesítési adatokkal, és bontsa ki az Alkalmazások részt az irányítópulton, és görgessen lefelé az Ügyfél hitelesítő adatai szakasz felé, hogy megtekinthesse az ügyfél-azonosítót és az ügyféltitkot.

A következő parancs bemutatja, hogyan hozhat létre JWT hozzáférési tokent, amelyet a PDF dokumentum fejléc területén való szöveg hozzáadására használnak.

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"

A következő cURL paranccsal szöveget adhat hozzá a PDF-dokumentum fejlécéhez.

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

Szöveg fejléc PDF-ben — kép: - Szövegfejléc hozzáadva a cURL paranccsal.

A példában használt mintafájlok letölthetők innen:

Szövegfejléc hozzáadása a PDF-hez Java használatával

Az SDK használatához először telepítenie kell a Maven vagy a GitHub oldalról. Az alábbiakban az Aspose.Pdf.jar letöltésének és a Maven build projektben való használatának részleteit olvashatja.

Adja hozzá a következő függőségeket a pom.xml fájlhoz.

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

Az alábbiakban bemutatjuk a követelmény teljesítésének lépéseit.

Először is hozzon létre egy PdfApi példányt, miközben megadja a ClientSecret és a ClientId adatait
Másodszor, hozzon létre egy Color objektumot az előtér és a háttér színének részleteinek meghatározásához.
Másodszor, hozzon létre egy objektumot a TextState osztályból.
A betűméret részleteinek megadásához használja a fontSize(..) metódust. A font(..) metódus a betűtípus meghatározásához. A foregroundColor(…) metódus a szöveg előtér részleteit, a backgroundColor(…) metódus pedig a háttérinformációkat határozza meg.
Most hozza létre a TextHeader objektumot, és adja meg a margó részleteit.
Használjon value(..) metódusokat a Text Header objektum tartalmának megadásához.
Most hívja meg a textState(…) metódust, és adja át a fent létrehozott TextState példányt argumentumként.
Az oldaltartalom mögötti fejléc megjelenítéséhez adja át a valódi értéket argumentumként a TextHeader osztály háttér(…) metódusának.
A bal oldali kép megjelenítéséhez adja át a HorizontalAlignment.CENTER értéket a horizontalAlignment(…) metódusnak.
Az opacitás(…) metódus a bélyeg átlátszatlanságát jelzi. Az alapértelmezett érték 1.0.
Miután beállítottuk a nagyítási értéket, hozzon létre AsposeResponse objektumot.
Végül hívja meg a PdfApi .postDocumentTextHeader(…) metódust, és adja meg a forrás PDF-fájl nevét, a TextHeader objektumot, valamint a kezdő- és záróoldalakat (ahova bélyegzőt kell hozzáadni).

// Szerezze be a ClientID-t és a ClientSecret-et a https://dashboard.aspose.cloud/ webhelyről
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi példány
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF dokumentum bevitele
String sourcePDF = "PdfWithAnnotations.pdf";

// PDF kezdőlapja a fejléckép elhelyezéséhez
int startPage = 2;

// PDF záróoldala a fejléckép elhelyezéséhez
int endPage = 3;
		        
// adja meg az előtér színét SlateBlue-ként a hexadecimális kódban
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// adja meg a Háttérszínt AntiqueWhite-ként a hexadecimális kódban
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// Hozzon létre TextState objektumot a betűméret, az arc és a szín részleteinek meghatározásához
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// hozzon létre egy példányt a TextHeader objektumból
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // a megjelenítendő szöveg fejléc tartalma
  .value("Aspose.PDF Cloud SDK For Java")
	
  // állítsa be az igazítást középre
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // Állítsa be a fejléc szövegét az oldal tartalma mögött
  headerObject.background(true)
	
  // állítsa be a szöveg fejléc igazítását középre
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // állítsa be a szövegfejléc átlátszatlanságát 0.8-ra
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// hívja meg az API metódust a szövegfejléc hozzáadásához a PDF-hez
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

Szövegfejléc hozzáadva Java-ban — kép: – Java-val hozzáadott szövegfejléc előnézete.

Ha szöveget szeretne hozzáadni a láblécterülethez, hozzon létre egy példányt a TextFooter osztályból, és hívja meg a PdfApi osztály postDocumentTextFooter(…) metódusát. A fennmaradó lépések és részletek ugyanazok maradnak, mint a szövegfejléc hozzáadásához fentebb.

Kép a PDF fejlécében a cURL használatával

Könnyen hozzáadhatunk képfájlokat a PostDocumentImageHeader API-val a PDF fájl fejléc részében a cURL paranccsal. A képbélyegző hozzáadása során lehetőséget kapunk a Horizontal Alignment, Opacity, RotateAngle, Zoom factor of image, Width, Height, LeftMargin, TopMargin, RightMargin stb.

A name paraméter határozza meg a bemeneti/forrás PDF-dokumentumot, az imageHeader a bélyegzendő képfájlt, a startPageNumber tulajdonság pedig a PDF-dokumentum kezdőoldalát és endPageNumber záróoldalát határozza meg, hogy a képbélyegeket tartalmazza. A következő cURL parancsban a Háttér tulajdonság hamisra van állítva, így a kép látható. A HorizontalAlignment értéke balra, az átlátszatlanság értéke 0,8, a nagyítási tényező 1, a szélesség 250, a magasság 80 pont, a jobb margó pedig 500 pont.

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

Képbélyegző a fejlécben — kép: - Képbélyegző a PDF fejléc részében.

A fenti példában használt mintafájlok az alábbi linkről tölthetők le:

Kép hozzáadása a fejléchez Java használatával

Az Aspose.PDF Cloud SDK for Java figyelemre méltó funkciót biztosít egy képfejléc hozzáadásához egy PDF fájlhoz kevesebb kódsorral.

Az alábbiakban bemutatjuk a képfejléc hozzáadásának lépéseit a PDF-dokumentumban

Hozzon létre egy PdfApi objektumot, miközben megadja a ClientSecret és a ClientId adatait.
Másodszor, hozzon létre egy objektumot az ImageHeader osztályból.
Használja az ImageHeader osztály szélesség(..) és magasság(…) metódusait a kép szélességének és magasságának beállításához.
Most használja a fileName(…) metódust a fejléckép elérési útjának részleteinek megadásához.
Az oldal tartalma mögötti kép megjelenítéséhez adja át a false argumentumot a background(…) metódusnak.
Most, hogy a képet a bal oldalon jelenítse meg, adja át a HorizontalAlignment.LEFT értéket a horizontalAlignment(…) metódusnak.
Az opacitás(…) metódus a bélyeg átlátszatlanságát jelzi. Az alapértelmezett érték 1.0.
Miután beállítottuk a nagyítási értéket, hozzon létre AsposeResponse objektumot.
Végül hívja meg a PdfApi.postDocumentImageHeader(…) metódust, miközben argumentumként adja át a forrás PDF-fájl nevét, az ImageHeader objektumot, a kezdő- és záróoldalakat (ahova bélyegzőt kell hozzáadni).

// Szerezze be a ClientID-t és a ClientSecret-et a https://dashboard.aspose.cloud/ webhelyről
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// createPdfApi példány
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// PDF dokumentum bevitele
String sourcePDF = "PdfWithAnnotations.pdf";

// PDF kezdőlapja a fejléckép elhelyezéséhez
int startPage = 2;

// PDF záróoldala a fejléckép elhelyezéséhez
int endPage = 3;
		        
// hozzon létre egy példányt az ImageHeader objektumból
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// előtérbe/láthatóvá tenni a fejlécképet
	headerObject.background(false)
	
	// állítsa be a képfejléc igazítását balra
	.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);

// hívja meg az API metódust a fejléckép hozzáadásához PDF-ben
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

Ha képet szeretne hozzáadni a lábléc területéhez, hozzon létre egy objektumot az ImageFooter osztályból, és hívja meg a pdfApi osztály postDocumentImageFooter(…) metódusát. A többi lépés ugyanaz marad, mint a fenti fejléc részben a képnél leírtak szerint.

Következtetés

Ebben a cikkben megvitattuk az Aspose.PDF Cloud elérésének lépéseit cURL-parancsokkal, hogy szöveget és képeket adhasson hozzá a PDF-dokumentumok fejléc/lábléc területéhez. Megvizsgáltuk az Aspose.PDF Cloud SDK for Java telepítésének lépéseit is, és Java nyelven használhatjuk szöveg és kép hozzáadásához a PDF-fájl fejlécéhez vagy láblécéhez. Az API egyéb izgalmas funkcióiról további részletekért tekintse meg a termékdokumentációt.

Minden Cloud SDK-nk nyílt forráskódú, így a teljes forráskód letölthető a GitHub oldalról.

Szöveg hozzáadása a fejléchez a cURL használatával#

Szövegfejléc hozzáadása a PDF-hez Java használatával#

Kép a PDF fejlécében a cURL használatával#

Kép hozzáadása a fejléchez Java használatával#

Következtetés#

Szöveg hozzáadása a fejléchez a cURL használatával

Szövegfejléc hozzáadása a PDF-hez Java használatával

Kép a PDF fejlécében a cURL használatával

Kép hozzáadása a fejléchez Java használatával

Következtetés