Ми раді оголосити про випуск 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 Виправлення

Зміни в поведінці, які слід перевірити перед оновленням

  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, переповнення у арифметиці розмірів та закриті потоки після упаковки 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.

Ресурси