ویرایش ابرداده EPUB با استفاده از جاوا

در آخرین مقاله، 20 مدیریت ابرداده EPUB و هسته دوبلین با استفاده از C# را مورد بحث قرار دادیم. امروز، ما یاد خواهیم گرفت که چگونه می‌توانید با استفاده از جاوا، ویژگی‌های فراداده EPUB، از جمله Dublin Core را به‌صورت برنامه‌نویسی بخوانید، ویرایش و به‌روزرسانی کنید.

فایل EPUB یک قالب کتاب دیجیتالی است که شامل متن، تصاویر و عناصر تعاملی است. این با استفاده از فناوری های رایج وب مانند HTML و CSS ساخته شده است.

فراداده EPUB به معنای اطلاعات مهم ذخیره شده در فایل های EPUB است، مانند عنوان، نویسنده، ناشر و زبان. این داده ها به سازماندهی صحیح کتاب های دیجیتال کمک می کند.

در اینجا موضوعاتی هستند که به آنها خواهیم پرداخت:

Java API برای ویرایش متادیتا

GroupDocs.Metadata یک Java API را ارائه می دهد که برای خودکارسازی مدیریت ابرداده برای فرمت های مختلف فایل در برنامه های Java طراحی شده است. این API خواندن، به‌روزرسانی، افزودن، تمیز کردن و حذف متادیتا را از انواع فایل‌های مختلف امکان‌پذیر می‌سازد. در بحث امروز خود، از این API برای مدیریت فراداده کتاب‌های الکترونیکی در قالب 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

به عنوان یک توسعه دهنده جاوا، اگر می خواهید ویژگی های ابرداده EPUB را تغییر دهید، این مراحل را دنبال کنید:

  1. کتاب الکترونیکی EPUB را با استفاده از کلاس Metadata بارگیری کنید.
  2. از متد getRootPackageGeneric برای استخراج بسته ریشه ابرداده استفاده کنید.
  3. اکنون می توانید به راحتی تمام ویژگی های ابرداده بسته EPUB را با استفاده از روش دریافت کننده مربوطه مشاهده کنید.
  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 Metadata

کد منبع 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 با Java

ابرداده دوبلین کور از چند مورد تشکیل شده است که هم منابع فیزیکی و هم منابع دیجیتال را توصیف می کند. می‌توانید ویژگی‌های فراداده Dublin Core را با استفاده از کد Java به روشی مشابه ابرداده EPUB تغییر دهید.

Dublin Core را بخوانید

خطوط کد زیر نحوه استخراج موارد فراداده 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 را در صورت نیاز تغییر دهید:

// ابرداده های 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، خوانندگان تشویق می شوند به موارد زیر مراجعه کنند:

هرگونه سوال یا بحث بیشتر را می توان به فروم ارائه شده هدایت کرد.

همچنین ببینید