تحرير بيانات تعريف PDF في Java: دليل خطوة بخطوة للمطورين

GroupDocs.Metadata Cloud SDK for Java يتيح لمطوري Java قراءة وتعديل خصائص مستندات PDF برمجيًا. في هذا الدليل ستتعلم كيفية تحرير بيانات التعريف لملفات PDF في Java، وتحديث الحقول القياسية مثل العنوان (Title) والمؤلف (Author)، وإضافة أزواج مفتاح‑قيمة مخصصة. توفر SDK واجهة برمجة تطبيقات بسيطة لتحميل ملف PDF، وتغيير بيانات التعريف الخاصة به، وحفظ الملف مرة أخرى في التخزين. اتبع التعليمات خطوة بخطوة لدمج تحرير البيانات الوصفية في تطبيقات Java الخاصة بك.

المتطلبات المسبقة والإعداد

للعمل مع بيانات تعريف PDF تحتاج إلى Java 8 أو أعلى و Maven مثبتين على جهاز التطوير الخاص بك. قم بتنزيل أحدث إصدار من هذه الصفحة.

أضف SDK إلى مشروع Maven الخاص بك:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.9</version>
</dependency>

أو قم بتثبيته عبر سطر الأوامر:

mvn install com.groupdocs:groupdocs-metadata-cloud

أنشئ ملف تكوين (أو اضبط متغيرات البيئة) باستخدام معرف العميل والسر الخاص بالعميل الذين تم الحصول عليهما من لوحة تحكم GroupDocs Cloud. لا يلزم رمز ترخيص لهذا المثال؛ يمكن طلب ترخيص مؤقت من صفحة الترخيص.

فهم بيانات تعريف PDF

تحتوي ملفات PDF على مجموعة من الخصائص القياسية (Title, Author, Subject, Keywords) وتسمح بأزواج مفتاح‑قيمة مخصصة. يتم تخزين هذه الخصائص في قاموس بيانات التعريف للمستند ويمكن قراءتها أو تعديلها دون تغيير المحتوى المرئي للملف.

الميزات الرئيسية لـ GroupDocs.Metadata Cloud SDK for Java

قراءة البيانات الوصفية الموجودة من PDF، DOCX، XLSX، والعديد من الصيغ الأخرى.
تحديث الخصائص القياسية مثل العنوان، المؤلف، المُنشئ، والمنتج.
إضافة أو تعديل أو إزالة الخصائص المخصصة باستخدام واجهة خريطة بسيطة.
حفظ التغييرات في الملف الأصلي أو في موقع إخراج جديد.

تعديل خصائص مستند PDF القياسية

يُظهر SDK فئة MetadataInfo التي توفر getters و setters لجميع الحقول القياسية. يمكنك أيضًا الوصول إلى مجموعة CustomProperties للعمل مع الإدخالات المعرفة من قبل المستخدم.

إضافة حقول بيانات تعريف مخصصة

يتم تخزين البيانات الوصفية المخصصة كقاموس من مفاتيح وسلاسل قيم. يقوم SDK تلقائيًا بتسلسل هذه الإدخالات عند حفظ المستند، مما يجعلها متاحة لأي قارئ PDF يدعم البيانات الوصفية المخصصة.

خطوات تحرير بيانات تعريف PDF في Java

تهيئة عميل API: أنشئ كائن Configuration باستخدام بيانات الاعتماد الخاصة بك وقم بإنشاء مثيل لـ MetadataApi.
تحميل ملف PDF المصدر: استخدم StorageApi لوضع الملف في تخزين GroupDocs Cloud الخاص بك.
تحميل بيانات تعريف PDF: استدعِ metadataApi.getMetadataInfo لاسترجاع كائن MetadataInfo.
تحديث الحقول: حدد الخصائص القياسية (مثل setTitle، setAuthor) وأضف إدخالات مخصصة عبر getCustomProperties().put("MyKey", "MyValue").
حفظ التغييرات: استدعِ metadataApi.updateMetadataInfo لكتابة بيانات التعريف المعدلة مرة أخرى إلى الملف.

لمزيد من التفاصيل حول الفئات المستخدمة، يرجى الرجوع إلى مرجع API.

تحرير بيانات التعريف لملف PDF في Java - مثال كامل للشفرة

المثال التالي يوضح سير عمل كامل: المصادقة، تحميل الملف، تعديل البيانات الوصفية، وحفظ ملف PDF المحدث.

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (sample.pdf, C:/files/sample.pdf) لتطابق مواقع الملفات الفعلية لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

تحرير بيانات تعريف PDF عبر REST API باستخدام cURL

إذا كنت تفضل عدم استخدام مكتبة Java، يمكن تنفيذ العملية نفسها عبر GroupDocs Metadata Cloud REST API.

الحصول على رمز الوصول

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

تحميل ملف PDF

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/files/sample.pdf"

تحديث البيانات الوصفية

curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "title":"New Document Title",
           "author":"John Doe",
           "subject":"Updated Subject",
           "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
         }'

تحميل ملف PDF المحدث

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o "C:/files/updated_sample.pdf"

تسمح لك هذه الأوامر بدمج تحرير بيانات تعريف PDF في السكريبتات، خطوط أنابيب CI/CD، أو أي بيئة لا يكون تثبيت مكتبة Java عملية فيها. للحصول على قائمة كاملة بنقاط النهاية، راجع وثائق API.

الخلاصة

أنت الآن تمتلك فهماً كاملاً لكيفية تعديل بيانات تعريف PDF في Java باستخدام GroupDocs.Metadata Cloud SDK for Java. يغطي الدليل قراءة البيانات التعريفية الموجودة، تعديل الحقول القياسية مثل العنوان والمؤلف، إضافة أزواج مفتاح‑قيمة مخصصة، وحفظ التغييرات. يعمل SDK على جهازك المحلي أو الخادم ويتطلب ترخيصًا صالحًا؛ يمكنك البدء بترخيص مؤقت من صفحة الترخيص والترقية إلى ترخيص تجاري كامل للاستخدام الإنتاجي. دمج هذه التقنيات للحفاظ على تنظيم وثائق PDF الخاصة بك وجعلها قابلة للبحث.

الأسئلة الشائعة

كيف يمكنني تعديل بيانات تعريف PDF في Java باستخدام GroupDocs.Metadata Cloud SDK؟
استخدم الـ SDK لتحميل ملف PDF، تعديل خصائص MetadataInfo، وحفظ الملف. راجع وثائق GroupDocs.Metadata Cloud SDK for Java للحصول على التفاصيل.

هل يمكنني إضافة أزواج مفتاح‑قيمة مخصصة إلى بيانات تعريف PDF؟
نعم، يتيح SDK إضافة إدخالات مخصصة عبر طريقة setCustomProperties. راجع مرجع API للحصول على أمثلة.

هل الترخيص المؤقت كافٍ للتطوير؟
ترخيص مؤقت من صفحة الترخيص يتيح لك اختبار SDK. للإنتاج، اشترِ ترخيصًا كاملاً.

أين يمكنني العثور على مزيد من الأمثلة لتعديل بيانات تعريف PDF؟
توفر الوثائق الرسمية والمنتديات عينات إضافية ودعمًا من المجتمع.

المتطلبات المسبقة والإعداد#

فهم بيانات تعريف PDF#

الميزات الرئيسية لـ GroupDocs.Metadata Cloud SDK for Java#

تعديل خصائص مستند PDF القياسية#

إضافة حقول بيانات تعريف مخصصة#

خطوات تحرير بيانات تعريف PDF في Java#

تحرير بيانات التعريف لملف PDF في Java - مثال كامل للشفرة#

تحرير بيانات تعريف PDF عبر REST API باستخدام cURL#

الخلاصة#

الأسئلة الشائعة#

اقرأ المزيد#