ما خوشحالیم که انتشار 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 | رفعخطا |
تغییرات رفتار که قبل از ارتقا باید بررسی شوند
- پاکسازی PDF موارد بیشتری را حذف میکند.
Metadata.sanitize()اکنون حاشیهنویسیها، پیوستها، نشانکها، فیلدهای فرم و امضاهای دیجیتال را از اسناد PDF حذف میکند؛ پیش از نسخه 26.11 فقط حاشیهنویسیها حذف میشدند. اگر یک PDF پاکسازیشده نیاز به حفظ این موارد داشته باشد،sanitize()را فراخوانی نکنید — فقط ویژگیهای مورد نیاز خود را حذف کنید. - آرشیوها بر اساس پسوندشان شناسایی میشوند. آرشیوهای RAR، 7z، TAR و فرمتهای جدید آرشیو بر اساس پسوند فایل شناسایی میشوند، بنابراین یک آرشیو بارگذاریشده از
InputStreamیا یک URI باید فرمت آن بهصورت صریح تنظیم شود (به پایین مراجعه کنید). - ویژگی فرستنده ایمیل نامگذاری شد. در فهرست ویژگیها، ویژگی فرستنده اکنون بهنام
SenderEmailAddressاست نهSender. کدی که این ویژگی را بر اساس نام جستجو میکند باید از نام جدید استفاده کند.EmailPackage.getSender()منسوخ شده و به نفعgetSenderEmailAddress()است. - سرآیندهای صوتی 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 دریافت کنید.