Ми раді оголосити про випуск 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: Internet message ID, billing, HTML і RTF‑тіло; EML: редаговані вкладення | Функція |
| METADATANET-4123, METADATANET-4124 | MSG: тема розмови, імена відображення, прапорці шифрування та підпису, адреси відправника та «sent representing», reply‑to, запит підтвердження прочитання та інші властивості MAPI | Функція |
| METADATANET-4110, METADATANET-4111 | Email: 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, переповнення у арифметиці розмірів, закриті потоки після упаковки 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, переповнення у арифметиці розмірів та закриті потоки після упаковки 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.