Мы рады объявить о выпуске 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 Исправление

Изменения поведения, которые следует проверить перед обновлением

  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‑документов, а не только аннотации. Это делает процесс очистки 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.

Ресурсы