واجهة برمجة تطبيقات Java REST لإضافة رأس الصفحة في PDF

يُعد الرأس نصًا يوضع في منطقة الهامش أعلى الصفحة، بينما يوضع التذييل أسفل الصفحة أو أسفلها. وعادةً ما تُستخدم هذه المناطق لإدراج معلومات المستند، مثل اسم المستند، وعنوان الفصل، وأرقام الصفحات، وتاريخ الإنشاء، وما إلى ذلك. وتتكرر هذه المعلومات في كل صفحة، وبالتالي تمكن القارئ من التنقل بسهولة في المستند.

علاوة على ذلك، يرجى الانتباه إلى أن الرؤوس والتذييلات مفيدة في توفير معلومات سريعة حول مستندك بتنسيق يمكن التنبؤ به وتساعد أيضًا في تحديد أجزاء مختلفة من المستند. في هذه المقالة، سنتعلم كيفية إضافة نص وصور إلى مناطق الرأس والتذييل في ملفات PDF باستخدام Aspose.PDF Cloud SDK for Java.

إضافة نص إلى الرأس باستخدام cURL
إضافة رأس النص في PDF باستخدام Java
الصورة في رأس ملف PDF باستخدام cURL
إضافة صورة في الرأس باستخدام Java

إضافة نص إلى الرأس باستخدام cURL

أوامر cURL هي طريقة مثيرة للوصول إلى واجهات برمجة تطبيقات RESTFul من خلال محطة سطر الأوامر. نظرًا لأن Aspose.PDF Cloud SDK تم تطويره وفقًا لمبادئ REST، فيمكن الوصول إليه بسهولة عبر موجه الأوامر. ومع ذلك، يرجى ملاحظة أنه لضمان خصوصية المستخدم وسلامة البيانات، فإن جميع واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا من قبل الأشخاص المصرح لهم. لذلك، تحتاج أولاً إلى زيارة لوحة تحكم 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 باستخدام 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
ثانيًا، قم بإنشاء كائن اللون لتحديد تفاصيل لون المقدمة والخلفية.
ثانيًا، قم بإنشاء كائن من فئة TextState.
استخدم طريقة fontSize(..) لتعيين تفاصيل حجم الخط. طريقة font(..) لتحديد وجه الخط. طريقة foregroundColor(…) تحدد تفاصيل مقدمة النص، وطريقة backgroundColor(…) لتحديد معلومات الخلفية.
الآن قم بإنشاء كائن TextHeader وقم بتحديد تفاصيل الهامش.
استخدم طرق value(..) لتحديد محتوى كائن رأس النص.
الآن قم باستدعاء طريقة textState(…) ومرر مثيل TextState الذي تم إنشاؤه أعلاه كحجة.
لعرض الرأس خلف محتوى الصفحة، قم بتمرير القيمة true كحجة إلى طريقة الخلفية (…) من فئة 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 في الكود السداسي عشري
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// حدد لون الخلفية باللون الأبيض العتيق في الكود السداسي عشر
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

يمكننا بسهولة إضافة ملفات الصور باستخدام واجهة برمجة التطبيقات PostDocumentImageHeader في قسم الرأس لملف PDF باستخدام أمر cURL. أثناء إضافة طابع صورة، نحصل على خيار تحديد تفاصيل HorizontalAlignment وOpacity وRotateAngle وZoom factor للصورة وWidth وHeight وLeftMargin وTopMargin وRightMargin وما إلى ذلك.

يحدد معامل الاسم مستند 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 for 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";
				
// إنشاء مثيل لـ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. لمزيد من التفاصيل حول الميزات الأخرى المثيرة لواجهة برمجة التطبيقات، يرجى استكشاف وثائق المنتج.

جميع حزم SDK السحابية لدينا مفتوحة المصدر، لذا يمكن تنزيل الكود المصدر الكامل من GitHub.

إضافة نص إلى الرأس باستخدام cURL#

إضافة رأس النص في PDF باستخدام Java#

الصورة في رأس ملف PDF باستخدام cURL#

إضافة صورة في الرأس باستخدام Java#

خاتمة#

إضافة نص إلى الرأس باستخدام cURL

إضافة رأس النص في PDF باستخدام Java

الصورة في رأس ملف PDF باستخدام cURL

إضافة صورة في الرأس باستخدام Java

خاتمة