GroupDocs.Metadata Cloud SDK for Java به توسعهدهندگان جاوا امکان میدهد تا بهصورت برنامهنویسی ویژگیهای سند PDF را بخوانند و تغییر دهند. در این راهنما، نحوه ویرایش متادیتای PDF در جاوا، بهروزرسانی فیلدهای استاندارد مانند Title و Author، و افزودن جفتهای کلید‑مقدار سفارشی را یاد خواهید گرفت. SDK یک API ساده برای بارگذاری یک PDF، تغییر متادیتای آن و ذخیرهسازی فایل دوباره در ذخیرهگاه فراهم میکند. دستورالعملهای گامبهگام را دنبال کنید تا ویرایش متادیتا را در برنامههای جاوای خود یکپارچه کنید.
پیشنیازها و تنظیمات
برای کار با متادیتای 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، و بسیاری از فرمتهای دیگر بخوانید.
- ویژگیهای استاندارد مانند Title، Author، Creator و Producer را بهروزرسانی کنید.
- ویژگیهای سفارشی را با استفاده از یک رابط نقشه ساده اضافه، ویرایش یا حذف کنید.
- تغییرات را به فایل اصلی یا به مکان خروجی جدید ذخیره کنید.
تغییر ویژگیهای استاندارد سند PDF
SDK کلاس MetadataInfo را ارائه میدهد که getterها و setterهای تمام فیلدهای استاندارد را فراهم میکند. همچنین میتوانید به مجموعه 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
اگر ترجیح میدهید از کتابخانه جاوا استفاده نکنید، میتوانید همان عملیات را از طریق 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 دارید. این راهنما شامل خواندن متادیتای موجود، تغییر فیلدهای استاندارد مانند Title و Author، افزودن جفتهای کلید‑مقدار سفارشی و ذخیرهسازی تغییرات بود. SDK بر روی ماشین یا سرور محلی شما اجرا میشود و به یک لایسنس معتبر نیاز دارد؛ میتوانید با یک لایسنس موقت از صفحه لایسنس شروع کنید و برای استفاده در تولید، به یک لایسنس تجاری کامل ارتقا دهید. این تکنیکها را به کار بگیرید تا اسناد PDF خود را بهخوبی سازماندهی و قابل جستجو نگه دارید.
سوالات متداول
چگونه میتوانم متادیتای PDF را در Java با استفاده از GroupDocs.Metadata Cloud SDK ویرایش کنم؟
از SDK برای بارگذاری یک PDF، تغییر ویژگیهای MetadataInfo آن و ذخیرهسازی فایل استفاده کنید. برای جزئیات به مستندات GroupDocs.Metadata Cloud SDK for Java مراجعه کنید.
آیا میتوانم جفتهای کلید‑مقدار سفارشی را به متادیتای PDF اضافه کنم؟
بله، SDK امکان افزودن ورودیهای سفارشی را از طریق متد setCustomProperties فراهم میکند. برای مثالها به مرجع API مراجعه کنید.
آیا یک مجوز موقت برای توسعه کافی است؟
یک مجوز موقت از صفحه مجوز به شما امکان میدهد SDK را آزمایش کنید. برای تولید، یک مجوز کامل خریداری کنید.
کجا میتوانم نمونههای بیشتری برای دستکاری متادیتای PDF پیدا کنم؟
مستندات رسمی مستندات و انجمنها شامل نمونههای اضافی و پشتیبانی جامعه هستند.