با استفاده از Java REST API سربرگ و پاورقی را در PDF اضافه کنید

هدر متنی است که در قسمت حاشیه در بالای صفحه قرار می گیرد، در حالی که پاورقی در پایین یا پایین صفحه قرار می گیرد. معمولاً از این مناطق برای درج اطلاعات سند، مانند نام سند، عنوان فصل، شماره صفحه، تاریخ ایجاد و غیره استفاده می شود. این اطلاعات در هر صفحه تکرار می شود و بنابراین خواننده را قادر می سازد تا به راحتی در سند حرکت کند.

علاوه بر این، لطفاً توجه داشته باشید که سرصفحه ها و پاورقی ها در ارائه اطلاعات سریع در مورد سند شما در قالبی قابل پیش بینی مفید هستند و همچنین به تنظیم بخش های مختلف یک سند کمک می کنند. در این مقاله قصد داریم با افزودن متن و تصاویر به قسمت‌های سرصفحه و پاورقی فایل‌های PDF با استفاده از Aspose.PDF Cloud SDK for Java آشنا شویم.

اضافه کردن متن به سربرگ با استفاده از cURL
اضافه کردن سربرگ متن در PDF با استفاده از جاوا
تصویر در هدر PDF با استفاده از cURL
اضافه کردن تصویر در هدر با استفاده از جاوا

با استفاده از cURL متن را به هدر اضافه کنید

دستورات cURL یک راه هیجان انگیز برای دسترسی به API های RESTFul از طریق ترمینال خط فرمان است. از آنجایی که Aspose.PDF Cloud SDK طبق اصول REST توسعه یافته است، بنابراین می توان به راحتی از طریق خط فرمان به آن دسترسی داشت. با این حال، لطفاً توجه داشته باشید که برای اطمینان از حفظ حریم خصوصی کاربر و یکپارچگی داده‌ها، همه APIهای ما فقط برای افراد مجاز قابل دسترسی هستند. بنابراین، ابتدا باید از Aspose.Cloud dashboard دیدن کنید و اگر حساب GitHub یا Google دارید، به سادگی ثبت نام کنید. در غیر این صورت بر روی دکمه Create a new Account کلیک کنید و اطلاعات مورد نیاز را ارائه دهید. اکنون با استفاده از اعتبارنامه وارد داشبورد شوید و بخش Applications را از داشبورد گسترش دهید و به سمت پایین به سمت قسمت Client Credentials حرکت کنید تا Client ID و Client Secret را ببینید.

دستور زیر نحوه ایجاد یک نشانه دسترسی 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";
				
// نمونه 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)
	
  // Opacity Text Header را 0.8 قرار دهید
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// برای افزودن Text Header به PDF متد API را فراخوانی کنید
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

هدر متن در Java اضافه شد — تصویر 2: - پیش نمایش هدر متن با Java اضافه شده است.

برای افزودن متن در قسمت پاورقی، لطفاً یک نمونه از کلاس TextFooter ایجاد کنید و روش postDocumentTextFooter(…) کلاس PdfApi را فراخوانی کنید. مراحل و جزئیات باقیمانده مانند آنچه در بالا ذکر شد برای افزودن سربرگ متن باقی می ماند.

تصویر در هدر PDF با استفاده از cURL

ما می‌توانیم به راحتی فایل‌های تصویری را با استفاده از PostDocumentImageHeader API در بخش سربرگ فایل PDF با استفاده از دستور cURL اضافه کنیم. هنگام اضافه کردن یک مهر تصویر، گزینه ای برای تعیین جزئیات HorizontalAlignment، Opacity، RotateAngle، ضریب بزرگنمایی تصویر، Width، Height، LeftMargin، TopMargin، RightMargin و غیره دریافت می کنیم.

پارامتر نام، سند PDF ورودی/منبع را مشخص می‌کند، imageHeader فایل تصویری را که باید مهر شود، مشخص می‌کند که ویژگی startPageNumber صفحه شروع و endPageNumber صفحه پایانی سند PDF را به‌صورت تمبر تصویر مشخص می‌کند. در دستور 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}"

مهر تصویر در هدر — تصویر 3: - مهر تصویری در بخش هدر PDF.

فایل های نمونه استفاده شده در مثال بالا را می توانید از لینک زیر دانلود کنید:

اضافه کردن تصویر در هدر با استفاده از Java

Aspose.PDF Cloud SDK برای جاوا یک ویژگی قابل توجه برای افزودن سرصفحه تصویر در یک فایل PDF با خطوط کد کمتر ارائه می‌کند.

در زیر مراحلی در مورد نحوه افزودن سرصفحه تصویر در سند PDF ارائه شده است

با ارائه جزئیات ClientSecret و ClientId یک شی از PdfApi ایجاد کنید.
در مرحله دوم، یک شی از کلاس 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);

// برای افزودن تصویر سرصفحه در PDF، متد API را فراخوانی کنید
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

برای افزودن یک تصویر در قسمت فوتر، یک شی از کلاس ImageFooter ایجاد کنید و متد postDocumentImageFooter(…) از کلاس pdfApi را فراخوانی کنید. بقیه مراحل همانطور که در بالا برای تصویر در قسمت سرصفحه بالا توضیح داده شد، باقی می مانند.

نتیجه گیری

در این مقاله، مراحل نحوه دسترسی به Aspose.PDF Cloud از طریق دستورات cURL برای افزودن متن و تصاویر در قسمت‌های Header/Foter اسناد PDF را مورد بحث قرار داده‌ایم. همچنین مراحل نصب Aspose.PDF Cloud SDK for Java و استفاده از آن در زبان Java برای افزودن متن و تصویر در قسمت سرصفحه یا پاورقی فایل PDF را بررسی کرده ایم. برای جزئیات بیشتر در مورد سایر ویژگی‌های هیجان‌انگیز API، لطفاً [مستندات محصول33 را بررسی کنید.

همه SDK های ابری ما OpenSource هستند، بنابراین یک کد منبع کامل را می توان از GitHub دانلود کرد.

با استفاده از cURL متن را به هدر اضافه کنید#

اضافه کردن سربرگ متن در PDF با استفاده از Java#

تصویر در هدر PDF با استفاده از cURL#

اضافه کردن تصویر در هدر با استفاده از Java#

نتیجه گیری#

با استفاده از cURL متن را به هدر اضافه کنید

اضافه کردن سربرگ متن در PDF با استفاده از Java

تصویر در هدر PDF با استفاده از cURL

اضافه کردن تصویر در هدر با استفاده از Java

نتیجه گیری