Мы рады объявить о выпуске 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: тема разговора, отображаемые имена, флаги шифрования и подписи, адреса отправителя и «отправлено от имени», поле 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 у необработанных тегов, безопасный от null импорт 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‑документов, а не только аннотации. Это делает процесс очистки 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 у необработанных тегов, безопасный от null импорт 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.