ما خوشحالیم که انتشار GroupDocs.Metadata for Java 26.11 را اعلام می‌کنیم که از نوامبر 2026 در دسترس است. این نسخه متادیتا را از هشت فرمت بیشتر می‌خواند — پنج فرمت آرشیو، صوت OGG Vorbis و کتاب‌های الکترونیکی FB2 و MOBI — و می‌تواند یک سند را مستقیماً از یک URI بارگذاری کند. پشتیبانی از ایمیل به‌طور قابل‌توجهی گسترش یافته است: فایل‌های MSG حدود 30 ویژگی MAPI بیشتر را نشان می‌دهند، چندین ویژگی موجود قابل ویرایش می‌شوند و پیوست‌های EML قابل ویرایش هستند. Metadata.sanitize() اکنون موارد بیشتری را از اسناد PDF حذف می‌کند و مجموعه‌ای از رفع‌خطاها پیش‌نمایش‌های CAD و تشخیص نوع فایل را بهبود می‌بخشد.

موارد جدید در این نسخه

کلید خلاصه دسته‌بندی
METADATANET-4251 پشتیبانی از فرمت‌های آرشیو GZIP، BZ2، XZ و Zstandard قابلیت
— پشتیبانی از فرمت Apple Archive (AAR) قابلیت
METADATANET-4083 پشتیبانی از فرمت صوتی OGG (Vorbis) قابلیت
METADATANET-4077 پشتیبانی از فرمت کتاب الکترونیکی FictionBook 2 (FB2) (فقط‑خواندنی) قابلیت
— پشتیبانی از فرمت کتاب الکترونیکی MOBI قابلیت
METADATANET-4094 بارگذاری اسناد از منابع وب با سازنده‌های جدید Metadata(URI) قابلیت
METADATANET-4121 MSG: شناسه پیام اینترنتی، صورتحساب، بدنه HTML و RTF؛ EML: پیوست‌های قابل ویرایش قابلیت
METADATANET-4123, METADATANET-4124 MSG: موضوع گفتگو، نام‌های نمایشی، پرچم‌های رمزنگاری و امضا، آدرس‌های فرستنده و «نمایندگی ارسال»، پاسخ‑به، دریافت‌گواهی خواندن و سایر ویژگی‌های MAPI قابلیت
METADATANET-4110, METADATANET-4111 ایمیل: getSenderEmailAddress()، نام فرستنده MSG قابل ویرایش، بدنه و دسته‌ها بهبود
METADATANET-4099 MSG: زمان تحویل، زمان ارسال توسط مشتری و سرآیندها قابل ویرایش بهبود
— EmailHeaderPackage.set(String, PropertyValue) سرآیند ایمیل را اضافه یا به‌روزرسانی می‌کند بهبود
— WordProcessing: ویژگی‌های HyperlinksChanged، ScaleCrop و SharedDoc بهبود
METADATANET-4139 Metadata.sanitize() پیوست‌ها، نشانک‌ها، فیلدهای فرم و امضاهای دیجیتال PDF را حذف می‌کند بهبود
METADATANET-4140 برچسب‌های جدید Tags.getTime().getDelivery() و Tags.getTool().getCompression()؛ ویژگی‌های بیشتری برچسب‌گذاری شدند بهبود
METADATAJAVA-718 کتابخانه‌های Aspose به‌روزرسانی شدند بهبود
— پیش‌نمایش‌های نقشه‌های CAD خالی بودند رفع‌خطا
— آرشیوهای RAR، 7z و TAR می‌توانستند به‌عنوان فایل‌های MP3 شناسایی شوند رفع‌خطا
— تصاویر AVIF می‌توانستند به‌عنوان فایل‌های MP3، MOV یا HEIF شناسایی شوند رفع‌خطا
— رفع‌خطاهای جزئی: سازگاری equals/hashCode برچسب‌های خام، واردات JSON ایمن در برابر null، سرریز در محاسبه اندازه، و بستن جریان‌ها پس از فشرده‌سازی ZIP رفع‌خطا

تغییرات رفتار که قبل از ارتقا باید بررسی شوند

  1. پاک‌سازی PDF موارد بیشتری را حذف می‌کند. Metadata.sanitize() اکنون حاشیه‌نویسی‌ها، پیوست‌ها، نشانک‌ها، فیلدهای فرم و امضاهای دیجیتال را از اسناد PDF حذف می‌کند؛ پیش از نسخه 26.11 فقط حاشیه‌نویسی‌ها حذف می‌شدند. اگر یک PDF پاک‌سازی‌شده نیاز به حفظ این موارد داشته باشد، sanitize() را فراخوانی نکنید — فقط ویژگی‌های مورد نیاز خود را حذف کنید.
  2. آرشیوها بر اساس پسوندشان شناسایی می‌شوند. آرشیوهای RAR، 7z، TAR و فرمت‌های جدید آرشیو بر اساس پسوند فایل شناسایی می‌شوند، بنابراین یک آرشیو بارگذاری‌شده از InputStream یا یک URI باید فرمت آن به‌صورت صریح تنظیم شود (به پایین مراجعه کنید).
  3. ویژگی فرستنده ایمیل نام‌گذاری شد. در فهرست ویژگی‌ها، ویژگی فرستنده اکنون به‌نام SenderEmailAddress است نه Sender. کدی که این ویژگی را بر اساس نام جستجو می‌کند باید از نام جدید استفاده کند. EmailPackage.getSender() منسوخ شده و به نفع getSenderEmailAddress() است.
  4. سرآیندهای صوتی MPEG فقط‑خواندنی هستند. MpegAudioPackage توصیف‌کننده جریان صوتی است، بنابراین ویژگی‌های آن — مانند نسخه MPEG، حالت کانال، بیت‌ریت و فرکانس — دیگر از طریق API ویژگی قابل تغییر نیستند.

فرمت‌های جدید

آرشیوها: AAR، GZIP، BZ2، XZ و Zstandard

ثابت‌های جدید FileType عبارتند از AAR، GZIP (.gz)، BZ2، XZ و ZSTD (.zst). هر فرمت یک بسته ریشه فقط‑خواندنی دارد:

فرمت بسته ریشه مواردی که نمایش می‌دهد
AAR AarRootPackage AarPackage: تعداد کل ورودی‌ها، پرچم solid، و ورودی‌های AarFile با نام، طول و پرچم دایرکتوری
GZIP GzipRootPackage GzipPackage: نام، تعداد کل ورودی‌ها، اندازه فشرده و اندازه غیر فشرده
BZ2 Bz2RootPackage Bz2Package: نام، تعداد کل ورودی‌ها، اندازه
XZ XzRootPackage XzPackage: نام، تعداد کل ورودی‌ها، اندازه
Zstandard ZstdRootPackage ZstdPackage: نام، تعداد کل ورودی‌ها، اندازه
try (Metadata metadata = new Metadata("backup.gz")) {
    GzipRootPackage root = metadata.getRootPackageGeneric();
    GzipPackage gzip = root.getGzipPackage();

    System.out.println(gzip.getName());
    System.out.println(gzip.getSize());
    System.out.println(gzip.getUncompressedSize());
}

صوت OGG Vorbis

FileType.OGG و OggRootPackage.getOggPackage() اضافه شدند. OggPackage فیلدهای نظرات Vorbis را می‌خواند:

  • عنوان، آلبوم، شماره ترک، هنرمند، اجراکننده، ژانر و تاریخ؛
  • حق‌نشر، مجوز، سازمان، توضیح، مکان، تماس و ISRC؛
  • رشته فروشنده و نسخه؛
  • هر نظر باقی‌مانده، از طریق getOggUserComments().
try (Metadata metadata = new Metadata("track.ogg")) {
    OggRootPackage root = metadata.getRootPackageGeneric();
    OggPackage ogg = root.getOggPackage();

    System.out.println(ogg.getArtist() + " - " + ogg.getTitle());
    for (OggUserComment comment : ogg.getOggUserComments()) {
        System.out.println(comment.getHeader() + " = " + comment.getValue());
    }
}

کتاب‌های الکترونیکی: FB2 و MOBI

  • FictionBook 2 (FB2) — FileType.FB2 و Fb2RootPackage.getFb2Package() اضافه شدند؛ این فرمت فقط‑خواندنی است. Fb2Package دارای چهار بخش است: اطلاعات عنوان و اطلاعات عنوان منبع (Fb2TitleInfo: عنوان کتاب، نویسندگان، ژانرها، کلیدواژه‌ها، زبان و دنباله)، اطلاعات سند (Fb2DocumentInfo) و اطلاعات انتشار (Fb2PublishInfo).
  • MOBI — FileType.MOBI و MobiRootPackage.getMobiPackage() اضافه شدند. MobiPackage سرآیند PDB (PDBHeader) و سرآیند MOBI (MobiHeader) را نشان می‌دهد. نام کامل کتاب می‌تواند با MobiHeader.setFullName(String) ویرایش شود.

بارگذاری از یک URI

دو سازنده جدید یک سند را مستقیماً از java.net.URI بارگذاری می‌کنند، بنابراین دیگر نیازی به دانلود فایل به‌صورت دستی ندارید:

public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)

سند به‌صورت حافظه موقت دانلود می‌شود و سپس همانند بارگذاری از یک جریان خوانده می‌شود. چون آرشیوها اکنون بر اساس پسوندشان شناسایی می‌شوند، هنگام بارگذاری یک آرشیو از یک جریان یا URI، فرمت را به‌صورت صریح تنظیم کنید:

try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
    // ...
}

پیام‌های ایمیل

  • EmailPackage.getSenderEmailAddress() اضافه شد؛ EmailPackage.getSender() منسوخ شده و همان مقدار را برمی‌گرداند.
  • EmailPackage.setHeaders(EmailHeaderPackage) و EmailHeaderPackage.set(String, PropertyValue) سرآیندهای ایمیل را اضافه یا به‌روزرسانی می‌کنند.
  • EmlPackage.getAttachments() و EmlPackage.setAttachments(EmailAttachmentPackage[]) پیوست‌های EML را قابل ویرایش می‌سازند.

MsgPackage ویژگی‌های جدید زیادی به‌دست می‌آورد:

  • قابل ویرایش: Body، Categories، SenderName، DeliveryTime، ClientSubmitTime، Billing، BodyHtml، BodyRtf، ReplyTo، ReadReceiptRequested، SenderSmtpAddress، SentRepresentingEmailAddress، SentRepresentingName، Mileage، Attachments؛
  • فقط‑خواندنی: InternetMessageId، ConversationTopic، DisplayBcc، DisplayCc، DisplayName، DisplayNamePrefix، DisplayTo، NormalizedSubject، SubjectPrefix، SenderAddressType، SentRepresentingAddressType، SentRepresentingSmtpAddress، TransportMessageHeaders، و پرچم‌های isEncrypted()، isSigned() و isTemplate().
try (Metadata metadata = new Metadata("message.msg")) {
    MsgRootPackage root = metadata.getRootPackageGeneric();
    MsgPackage msg = root.getMsgPackage();

    System.out.println(msg.getInternetMessageId());
    msg.setSenderName("Support Team");
    msg.setCategories(new String[] { "Reviewed" });

    metadata.save("message-updated.msg");
}

بهبودهای دیگر

پاک‌سازی اسناد PDF

Metadata.sanitize() اکنون پیوست‌ها، نشانک‌ها، فیلدهای فرم و امضاهای دیجیتال را از اسناد PDF حذف می‌کند، نه فقط حاشیه‌نویسی‌ها. این روش جامع‌تری برای تمیز کردن PDF قبل از به‌اشتراک‌گذاری آن خارج از سازمان شما فراهم می‌کند.

اسناد WordProcessing

WordProcessingPackage سه ویژگی جدید به‌دست می‌آورد که می‌توانند خوانده و ویرایش شوند: HyperlinksChanged، ScaleCrop و SharedDoc.

برچسب‌ها

  • Tags.getTime().getDelivery() زمان تحویل پیام‌ها را نشان می‌دهد.
  • Tags.getTool().getCompression() تنظیمات فشرده‌سازی فایل‌های ZIP، PNG و PSD را نشان می‌دهد.

هر دو برچسب می‌توانند همراه با ContainsTagSpecification در Metadata.findProperties استفاده شوند و ویژگی‌های موجود بیشتری اکنون برچسب‌گذاری شده‌اند.

رفع‌خطاها

  • پیش‌نمایش‌های نقشه‌های CAD خالی بودند.
  • آرشیوهای RAR، 7z و TAR می‌توانستند به‌عنوان فایل‌های MP3 شناسایی شوند.
  • تصاویر AVIF می‌توانستند به‌عنوان فایل‌های MP3، MOV یا HEIF شناسایی شوند.
  • رفع‌خطاهای جزئی: سازگاری equals/hashCode برچسب‌های خام، واردات JSON ایمن در برابر null، سرریز در محاسبه اندازه، و بستن جریان‌ها پس از فشرده‌سازی ZIP.

به‌روزرسانی کتابخانه‌های Aspose

کتابخانه‌های بسته‌بندی‌شده Aspose به نسخه‌های زیر به‌روزرسانی شدند: Aspose.Words 26.8، Aspose.Cells 26.9، Aspose.Slides 26.9، Aspose.PDF 26.8.1، Aspose.Email 26.8، Aspose.CAD 26.8، Aspose.PSD 26.8، Aspose.Diagram 26.9، Aspose.BarCode 26.6، Aspose.Imaging 25.12 و Aspose.ZIP 26.7.

نحوه دریافت به‌روزرسانی

Maven

مخزن GroupDocs و وابستگی را به pom.xml خود اضافه کنید:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <name>GroupDocs Artifacts Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

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

دانلود مستقیم

JAR را از صفحه دانلود GroupDocs.Metadata for Java 26.11 دریافت کنید.

منابع