تحرير البيانات التعريفية لـ EPUB باستخدام Java

في المقالة الأخيرة، ناقشنا إدارة البيانات التعريفية لـ EPUB وDublin Core باستخدام C#. سنتعلم اليوم كيف يمكنك قراءة خصائص البيانات التعريفية لـ EPUB وتحريرها وتحديثها برمجيًا، بما في ذلك مجموعة الخصائص Dublin Core، باستخدام Java.

ملف EPUB هو تنسيق كتاب رقمي يتضمن نصوصًا وصورًا وعناصر تفاعلية. تم إنشاؤه باستخدام تقنيات الويب الشائعة مثل HTML وCSS.

تعني بيانات EPUB التعريفية المعلومات المهمة المخزنة داخل ملفات EPUB، مثل العنوان والمؤلف والناشر واللغة. تساعد هذه البيانات في تنظيم الكتب الرقمية بشكل صحيح.

فيما يلي المواضيع التي سنغطيها:

Java API لتحرير البيانات الوصفية

يقدم GroupDocs.Metadata واجهة برمجة تطبيقات Java API المصممة لأتمتة إدارة البيانات التعريفية لتنسيقات الملفات المختلفة في تطبيقات Java. تتيح واجهة برمجة التطبيقات هذه قراءة البيانات الوصفية وتحديثها وإضافتها وتنظيفها وإزالتها من أنواع الملفات المختلفة. في مناقشتنا اليوم، سنستخدم واجهة برمجة التطبيقات هذه للتعامل مع البيانات الوصفية للكتب الإلكترونية بتنسيق EPUB.

يمكنك الحصول على ملف JAR من قسم التنزيلات أو دمج أحدث تكوينات المستودع والتبعية Maven في تطبيقات Java الخاصة بك.

<repository>
    <id>GroupDocsJavaAPI</id>
    <name>GroupDocs Java API</name>
    <url>https://releases.groupdocs.com/java/repo/</url>
</repository>

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

تعديل البيانات التعريفية لـ EPUB باستخدام Java

باعتبارك مطور Java، إذا كنت تريد تعديل خصائص البيانات التعريفية لـ EPUB، فاتبع الخطوات التالية:

  1. قم بتحميل الكتاب الإلكتروني EPUB باستخدام فئة Metadata.
  2. استخدم طريقة getRootPackageGeneric لاستخراج حزمة جذر بيانات التعريف.
  3. الآن، يمكنك بسهولة عرض جميع خصائص البيانات التعريفية لحزمة EPUB باستخدام طريقة getter المعنية.
  4. قم بتحديث قيم الخاصية حسب الحاجة باستخدام طريقة الضبط المعنية.
  5. احفظ ملف الكتاب الإلكتروني بقيم البيانات التعريفية المحدثة باستخدام طريقة الحفظ.

فيما يلي مقتطفات من تعليمات Java البرمجية التي توضح خطوات قراءة وتحديث خصائص بيانات EPUB التعريفية:

قراءة البيانات التعريفية لـ EPUB

في البداية، إليك كيفية قراءة البيانات التعريفية لـ EPUB باستخدام Java:

// قراءة البيانات التعريفية لـ EPUB باستخدام Java
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getEpubPackage().getVersion());
    System.out.println(root.getEpubPackage().getUniqueIdentifier());
    System.out.println(root.getEpubPackage().getImageCover() != null ? root.getEpubPackage().getImageCover().length : 0);
}

تحديث البيانات التعريفية لـ EPUB

يوضح كود مصدر Java التالي كيفية جلب وتحديث خصائص بيانات تعريف EPUB لملف EPUB:

// قم بتحديث البيانات التعريفية لـ EPUB باستخدام Java
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    root.getEpubPackage().setCreator("GroupDocs");
    root.getEpubPackage().setDescription("test e-book");
    root.getEpubPackage().setFormat("EPUB");
    root.getEpubPackage().setDate(new Date().toString());

    metadata.save("path/ebook.epub");
}

تعديل البيانات الوصفية الأساسية لـ EPUB Dublin باستخدام Java

تتكون البيانات الوصفية Dublin Core من عدد قليل من العناصر التي تصف الموارد المادية والرقمية. يمكنك تعديل خصائص بيانات تعريف Dublin Core باستخدام كود Java بطريقة مشابهة لبيانات تعريف EPUB.

قراءة دبلن كور

توضح أسطر التعليمات البرمجية التالية كيفية استخراج عناصر بيانات تعريف Dublin Core لتحليلها:

// قراءة بيانات تعريف Dublin Core باستخدام Java
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    System.out.println(root.getDublinCorePackage().getRights());
    System.out.println(root.getDublinCorePackage().getPublisher());
    System.out.println(root.getDublinCorePackage().getTitle());
    System.out.println(root.getDublinCorePackage().getCreator());
    System.out.println(root.getDublinCorePackage().getLanguage());
    System.out.println(root.getDublinCorePackage().getDate());
}

تحديث دبلن كور

يمكنك تغيير خصائص معينة في Dublin Core حسب الحاجة، كما هو موضح في الكود أدناه:

// قم بتحديث بيانات تعريف Dublin Core باستخدام Java
try (Metadata metadata = new Metadata("path/ebook.epub")) {
    EpubRootPackage root = metadata.getRootPackageGeneric();

    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:creator"), new PropertyValue("GroupDocs"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:description"), new PropertyValue("test e-book"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:title"), new PropertyValue("test EPUB"));
    root.getDublinCorePackage().setProperties(new WithNameSpecification("dc:date"), new PropertyValue(new Date().toString()));

    metadata.save("path/ebook.epub");
}

الحصول على ترخيص مجاني

إذا كنت ترغب في تجربة إمكانيات واجهة برمجة التطبيقات (API) هذه بشكل كامل، فيمكنك الحصول على ترخيص مؤقت مجانًا.

خاتمة

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

للحصول على معلومات مفصلة عن واجهة برمجة التطبيقات (API)، ننصح القراء بالرجوع إلى:

يمكن توجيه أي أسئلة أو مزيد من المناقشات إلى المنتدى المقدم.

أنظر أيضا